资源档案

支持平台: Web / Docker
收费方式: 开源软件免费，自托管设备与托管服务费用另计
开源协议: AGPL-3.0
收录时间: 2026-11-02

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

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

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

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

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

Homebox 官方文档中的位置树界面

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

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

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

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

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

Homebox 官方仓库中的物品详情界面

官方示例展示物品详情页，可看到数量、型号、制造商和维护入口[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]。