# Homebox 帮你记清家里的东西放在哪以及何时买的

> Homebox 可以按房间、柜子和标签整理家庭物品，把照片、说明书、购买信息与保修资料放进同一条记录。适合愿意维护家庭清单的人，软件开源免费，部署、备份和服务器费用由使用者承担。

## 关键信息

- 分类：开源项目
- 支持平台：Web / Docker
- 收费方式：开源软件免费，自托管设备与托管服务费用另计
- 开源协议：AGPL-3.0
- 官网：https://homebox.software/en/
- 源码仓库：https://github.com/sysadminsmedia/homebox
- 标签：家庭物品管理、自托管、开源、Docker
- 收录日期：2026-11-02

电钻明明买过，找的时候却不知道在哪个箱子里；洗衣机需要维修，发票和保修资料又散在邮件、相册和抽屉里。
这些麻烦都有一个共同点：物品还在，关于它的信息却很难一起找到。

Homebox 是面向家庭用户的开源物品管理工具，可以通过浏览器记录家里有什么、放在哪里，以及购买和维护情况。
这里介绍的是 `sysadminsmedia/homebox` 仓库维护的项目，官方提供网页演示和自托管安装文档[1]。

## 给物品一个能找得到的位置

Homebox 支持分类、位置、标签和自定义字段，也提供搜索功能。
位置可以逐层嵌套，例如“书房—工具柜—第二层”，标签则适合标记“维修工具”“露营装备”等跨房间的用途[1][2]。

这种分法适合东西分散在多个柜子、储物间或箱子里的家庭。
收纳位置负责回答“去哪里拿”，标签负责回答“同类东西有哪些”；搬动东西时，只需要把对应记录的位置改成新的去处。

![Homebox 官方文档中的位置树界面](/assets/post-images/homebox-household-inventory-locations.png)

官方文档示例展示了车库、柜子和层板之间的层级关系[2]。

每件物品可以记录名称、说明、数量和位置，并附上照片及其他文件。
进入编辑页的高级模式，还能补充购买、保修、出售情况和自定义字段；官方 README 也列出了维护计划跟踪能力[1][3]。
照片适合辨认外观相近的配件，说明书和购买凭证则可以直接附在对应物品上，减少临时翻找不同文件夹的次数。

## 用一台吸尘器建立完整记录

假设家里有一台吸尘器，可以把它放在“储物间—清洁用品柜”，拍下机身和型号标签，填写购买日期、价格及保修信息。
电子说明书和发票文件放进附件，滤芯规格放进自定义字段，更换或维护情况记在同一件物品的资料里。
这是一个整理示例，字段内容由你根据手头资料填写。

需要买耗材时，可以从记录里查规格；准备报修时，购买资料和设备信息也有了明确去处。
如果家人把机器搬到阳台柜子，记录中的位置也要跟着更新，清单才能继续有用。

![Homebox 官方仓库中的物品详情界面](/assets/post-images/homebox-household-inventory-item.png)

官方示例展示物品详情页，可看到数量、型号、制造商和维护入口[1]。

不必一开始就登记所有杂物。
贵重电器、维修工具、容易重复购买的配件，以及需要保留凭证的物品，更适合作为第一批记录。
物品名称尽量带上型号或用途，位置写到实际能找到的柜子或箱子，通常比堆积大量模糊条目更有帮助。

## 自托管需要安排好数据和备份

官方推荐使用 Docker 部署，也提供不同平台的可执行文件。
采用 Docker Compose 时，需要一台支持 Docker 的电脑、NAS 或服务器，以及可持久保存数据的磁盘空间；官方示例把主机端口 `3100` 映射到容器端口 `7745`，通过浏览器访问服务[4]。

默认数据库是 SQLite，家庭使用可以从默认配置开始；文档也提供 PostgreSQL 配置，供规模更大的安装选择[5]。
默认 Docker 部署需要把持久数据卷挂载到 `/data`，本地附件存储也使用容器内的这个目录。
备份应覆盖数据库、上传文件和部署配置，升级前保留可恢复的副本，避免把唯一资料留在容器的临时存储里[4][5][6]。

按 2026 年 11 月 2 日官方仓库的配置文档，部署时还要设置 `HBOX_AUTH_API_KEY_PEPPER`。
文档要求它至少有 32 字节，并提供 `openssl rand -base64 48` 作为生成方法；这个值需要安全保存并在重启后保持一致，轮换会使已签发的 API 密钥失效。
不要直接沿用安装示例中的占位字符串[7]。

如果只在家里使用，可以把访问范围限制在家庭网络。
需要远程访问时，应配置 HTTPS、访问控制及备份，并检查注册选项；官方支持通过 `HBOX_OPTIONS_ALLOW_REGISTRATION` 控制是否允许自行注册[7][8]。

## 免费软件仍然需要有人维护

Homebox 仓库采用 AGPL-3.0 许可，开源软件可免费获取和自行部署[1][9]。
自托管的设备、电力、磁盘、备份空间和维护时间由使用者承担，租服务器或使用第三方托管服务还会产生相应费用。

它也需要持续录入和更新：购买新物品、改变摆放位置或处理旧物时，清单应同步修改。
家里只有少量物品、平时也不愿维护记录的人，用简单表格可能更省事；已有 NAS、物品较多，又经常需要找说明书和购买凭证的家庭，更容易用上这些功能。

另一个需要留意的操作是删除位置。
官方文档提醒，删除位置会一并删除其中存放的物品，想保留的条目需要提前移到其他位置[2]。

官方演示适合用来了解界面，帮助你判断是否值得为自己部署。
正式使用时，从家里最常找不到的那一柜东西开始，把名称、照片和位置记准确，后续按需要补充购买及保修资料。

## 官方来源

[1] [Homebox README 与官方界面截图](https://github.com/sysadminsmedia/homebox)

[2] [位置与嵌套收纳说明](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/user-guide/locations.mdx)

[3] [物品和高级字段说明](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/user-guide/items.mdx)

[4] [Docker 与安装文档](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/quick-start/install.mdx)

[5] [数据库配置](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/quick-start/configure/database.mdx)

[6] [文件存储配置](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/quick-start/configure/storage.mdx)

[7] [环境变量与密钥要求](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/quick-start/configure/index.mdx)

[8] [反向代理配置](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/docs/src/content/docs/en/quick-start/configure/proxy.mdx)

[9] [项目许可证](https://github.com/sysadminsmedia/homebox/blob/116a5f3aa7528fe57383a3b3a1e1f9e7b5018649/LICENSE)

---

网页版：https://aronshare.com/posts/homebox-household-inventory/
发现线索：Homebox 官方仓库与文档 https://github.com/sysadminsmedia/homebox
来源站点：AronShare 资源库（https://aronshare.com）