电池、线材放哪了？用HomeBox记家庭物品清单

备用电池、充电器、灯泡这类东西，单价不高，收起来以后却容易忘记放在哪。只记一句“在柜子里”也不太够，柜子里还有好几个盒子。

这次找到的 HomeBox，就是用来记这些东西的。它是一款免费的开源家庭物品管理工具，截至写稿时，GitHub 上约有 7800 个星。你可以给物品记录存放位置、数量和说明，需要时按名字搜索，不必凭印象把抽屉全翻一遍。

我用三件虚构物品试了一遍：录入、查找、修改数量，再导出清单。下面从安装到操作完整说一下。先提醒一句，它需要自己在电脑或 NAS 上运行，安装门槛比普通记事软件高一些。

HomeBox 能做什么

它的基本结构是“位置”和“物品”。先建好玄关柜、书房抽屉之类的位置，再把东西放进去。位置也能分层，比如书房下面再建一个抽屉。

每件物品可以记名称、数量、型号、序列号和说明，还能添加照片、附件、购买及保修信息。小到一根线，大到家电，都可以用同一套方法登记。常用的分类还可以做成标签，方便筛选。

另外，它提供 CSV 导入导出、集合备份等功能，不只是在网页里看一份清单。这次主要测试日常最常用的几个操作；保修、维护记录和多人协作没有展开测试。

Windows 安装方法

项目地址：HomeBox 开源项目。注意这里用的是 sysadminsmedia 维护的版本。

打开项目的官方版本下载页，在 Assets 里找名称为 homebox_Windows_x86_64.zip 的附件。本次实测是 0.27.1，适用于 64 位 x86 Windows 电脑，其他架构要选对应版本。

下载后解压到一个固定文件夹，例如 C 盘的 HomeBox 文件夹，确认里面能看到程序 homebox.exe。后面生成的数据也放在这里，不建议用完就删。

在这个文件夹里打开 PowerShell。Windows 11 可以右键文件夹空白处选择“在终端中打开”，然后确认终端使用的是 PowerShell。把下面这段整体粘贴进去执行：

if (!(Test-Path ./hbox.pepper)) { $bytes = New-Object byte[] 48 $rng = [Security.Cryptography.RandomNumberGenerator]::Create() $rng.GetBytes($bytes) $rng.Dispose() [IO.File]::WriteAllText("$PWD/hbox.pepper", [Convert]::ToBase64String($bytes)) } $env:HBOX_AUTH_API_KEY_PEPPER = (Get-Content ./hbox.pepper -Raw).Trim() $env:HBOX_WEB_HOST = '127.0.0.1' $env:HBOX_WEB_PORT = '8898' $env:HBOX_MODE = 'production' ./homebox.exe

这段命令会先生成一份服务器密钥，保存在当前文件夹，后续启动继续使用它。0.27.1 要求配置这个值，直接双击程序并不是本文的安装方法。密钥文件不要公开，也不要每次启动都重新生成。

启动后保留终端窗口，在同一台电脑的浏览器打开 http://127.0.0.1:8898/。首次进入点击注册，填写自己的邮箱、名称和密码，再用刚注册的账号登录。这是你本地 HomeBox 的账号，不是注册一个 GitHub 账号。

如果地址打不开，先看终端有没有报错；8898 已被占用时，可以把命令里的端口换成一个空闲端口，浏览器地址也一起改。本文只开放本机访问，不需要修改防火墙或做公网映射。

关掉终端，服务也会停止。下次仍在同一个程序文件夹里执行上面这段命令，再打开同一个地址即可。原来的密钥和 .data 数据目录都要保留。我重启服务后重新搜索，之前的记录和修改后的数量都还在。

家里已经有 NAS、习惯用 Docker 的，也可以参考官方安装说明；官方更推荐用 Docker 做长期部署。这里实测的是 Windows 程序，没有把 NAS 部署写成已验证的步骤。