家庭消耗品跟踪管理软件HomeLists

什么是 HomeLists ?

HomeLists 是一款自托管耗材统计软件,能通过提醒等帮助您跟踪家庭消耗品。

安装

在群晖上以 Docker 方式安装。

在注册表中搜索 homelists ,选择第一个 aceberg/homelists,版本选择 latest

本文写作时, latest 版本对应为 1.0.2

docker 文件夹中,创建一个新文件夹 homelists,并在其中建一个子文件夹 data

文件夹 装载路径 说明
docker/homelists/data /data/homelists 存放设置、数据库等

端口

本地端口不冲突就行,不确定的话可以用命令查一下

1
2
# 查看端口占用
netstat -tunlp | grep 端口号
本地端口 容器端口
8842 8842

默认没有暴露端口

需要点 + 号添加

环境

可变
TZ 设为 Asia/Shanghai

更多的参数可以去看官方文档:https://github.com/aceberg/HomeLists#config

命令行安装

如果你熟悉命令行,可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 新建文件夹 homelists 和 子目录
mkdir -p /volume2/docker/homelists/data

# 进入 homelists 目录
cd /volume2/docker/homelists

# 运行容器
docker run -d \
--restart unless-stopped \
--name homelists \
-p 8842:8842 \
-v $(pwd)/data:/data/homelists \
-e TZ=Asia/Shanghai \
aceberg/homelists

也可以用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
version: '3'

services:
homelists:
image: aceberg/homelists
container_name: homelists
restart: unless-stopped
ports:
- 8842:8842
volumes:
- ./data:/data/homelists
environment:
- TZ=Asia/Shanghai

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 homelists 和 子目录
mkdir -p /volume2/docker/homelists/data

# 进入 homelists 目录
cd /volume2/docker/homelists

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:8842 就能看到主界面

新建场所

首先要建 table,用于设置存放物品的场所,比如 冰箱厨房

随便先建了几个,注意后面的 Lines 还是 0,因为我们还没添加物品

添加物品

现在我们要给 冰箱 里添加物品,在菜单栏找到 Table –> 冰箱

默认分为左右

老苏把冷冻的物品建在左侧,冷藏的物品放在右侧

每个物品添加完成之后,记得点后面的 OK 才会保存,要编辑则需要点前面的铅笔图标

  • 物品消耗后,可以通过 -1 来改变数量;
  • 至于数量的单位是斤、盒还是其他的并不重要;

进入编辑状态

设置报警

对应需要加入监控的物资,我们可以直接点 Add to Watchlist 按钮

进入菜单 Watchlist 可以看到刚刚加入的物品

count 设为 3,意思就是少于 3 就提醒

回到 Dashboard就会看到报警了,因为牛肉卷的数量只有 2

参考文档

aceberg/HomeLists: Count consumable supplies
地址:https://github.com/aceberg/HomeLists