什么是 HomeLists ？

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

安装

在群晖上以 Docker 方式安装。

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

本文写作时， latest 版本对应为 1.0.2；

卷

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

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

端口

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

# 查看端口占用
netstat -tunlp | grep 端口号

本地端口	容器端口
8842	8842

默认没有暴露端口

需要点 + 号添加

环境

可变	值
TZ	设为 Asia/Shanghai

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

命令行安装

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

# 新建文件夹 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 文件

version: '3'

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

然后执行下面的命令

# 新建文件夹 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