sysadminsmedia/homebox

这是什么？

核心功能

• 01按分类、位置和标签组织物品
• 02通过自定义字段保存额外的物品信息
• 03为物品添加图片、文档和保修信息
• 04记录购买日期、价格和维护计划
• 05在整个物品清单中搜索
• 06响应式网页界面，使用 SQLite 存储，支持 Docker 部署

适用场景

• 为保险或搬家整理家中物品清单
• 管理家电的保修信息和说明书
• 记录家用设备的维护计划
• 在家庭服务器上运行私有物品清单

快速上手

1. 1

   将 pepper 保存到本地文件

   openssl rand -base64 48 > hbox.pepper
2. 2

   限制 pepper 文件的权限

   chmod 400 hbox.pepper
3. 3

   创建数据目录并使用 Docker 运行容器

   docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest

使用前须知

• !需要 Docker 或手动配置环境，并且在首次运行前必须先创建 pepper 密钥文件。

收录于专题

标签

常见问题

homebox 是什么？

可自托管的家庭物品清单系统，用于管理物品、位置、文档、保修与维护记录。 HomeBox 是一款面向家庭用户的自托管物品清单与整理工具，可以记录自己拥有的物品，并按分类、位置和标签进行组织，还能添加自定义字段保存更多信息。

homebox 可以免费使用吗？用的什么许可证？

homebox 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

homebox 还在维护吗？

活跃维护中。homebox 最近一次提交是在 2026年10月23日。

homebox 适合用来做什么？

为保险或搬家整理家中物品清单 管理家电的保修信息和说明书 记录家用设备的维护计划 在家庭服务器上运行私有物品清单

homebox 怎么安装和运行？

将 pepper 保存到本地文件: openssl rand -base64 48 > hbox.pepper 限制 pepper 文件的权限: chmod 400 hbox.pepper 创建数据目录并使用 Docker 运行容器: docker run -d --name homebox --restart unless-stopped --publish 3100:7745 --env TZ=Europe/Bucharest --env HBOX_AUTH_API_KEY_PEPPER=$(cat hbox.pepper) --volume /path/to/data/folder/:/data ghcr.io/sysadminsmedia/homebox:latest

在哪里获取 homebox？

源代码和安装说明在 GitHub 上：https://github.com/sysadminsmedia/homebox