家里东西的说明书保修单全存 NAS:飞牛部署 Homebox 物品档案,出门也能查
作者
小编
发布时间

家里每样东西建档存 NAS:说明书、保修、型号,出门手机搜索直达。包含单容器编排、公网首启注册管理员及飞牛 PassNAT 插件隧道步骤。
项目介绍
Homebox 是一个开源的家庭物品档案管理工具,把家里每样东西建一张卡片:说明书、保修到期日、型号、放在哪个房间,全部集中存在自己的 NAS 上。物品可以生成带二维码的标签,贴在机器上扫码直达;首页的统计卡会自动汇总物品总数和价值。
它由社区持续维护(sysadminsmedia 组织),官方提供 Docker 镜像,单容器就能跑,数据用 SQLite 存在本地文件夹,不需要配置任何外部服务账号。
官方文档:Homebox Docs
部署安装
下面用飞牛 Docker Compose 部署,再通过 帕斯内网穿透 在外面的手机上查家里的物品档案。
一、在飞牛 Docker 新建 Compose 项目
打开 Docker,切到 Compose,点新增项目。项目名称填 homebox;路径在「我的文件」里选一个空文件夹,没有就新建一个。来源选择创建 docker-compose.yml,把下面整段编排贴进去。
1services:2 homebox:3 image: ghcr.io/sysadminsmedia/homebox:latest4 container_name: homebox5 restart: unless-stopped6 network_mode: bridge7 environment:8 - HBOX_OPTIONS_ALLOW_ANALYTICS=false9 - HBOX_AUTH_API_KEY_PEPPER=change-me-to-a-long-random-string-min-32-chars10 ports:11 - "3480:7745"12 volumes:13 - ./data:/data
3480 是 NAS 对外的端口,7745 是容器内的默认端口,后面创建隧道填 3480。./data 是数据目录,物品的照片附件和数据库都存在里面,用相对路径会在你刚选的项目文件夹里生成。
环境变量里 HBOX_AUTH_API_KEY_PEPPER 是官方要求的必填项,用来给接口密钥做哈希,要求至少 32 个字符,把示例里这串换成你自己随手编的一串长字符就行。HBOX_OPTIONS_ALLOW_ANALYTICS 设为 false 表示不上报匿名统计。
勾选创建项目后立即启动,确认,等待容器运行。
二、创建隧道,再马上建管理员
在飞牛应用中心搜索 PassNAT,安装并打开插件,账号登录一次。点击创建隧道,本地 IP 保持默认,本地端口填 3480,其余按页面默认设置创建。按隧道这一行的电源,等待状态显示运行中。
打开详情,使用分配的公网地址访问。第一次打开会先要求注册管理员账号,用户名和密码自己设。隧道一开,理论上别人也可能先碰到这个页面,所以建好隧道之后先把管理员建好,不要拖。
三、给家里东西建档
登录后点新建物品,把名称、位置、描述填上,比如打印机的硒鼓型号写进描述,下次买耗材对着型号买就不会错。每样东西都能生成一张二维码标签,打印出来贴在机器上,手机扫码直达这一页。
物品可以上传照片和附件,说明书电子版直接挂在对应的卡片下面。首页的统计卡会按物品数量和价值自动汇总。
四、出门查档案
在外面用手机打开同一个公网地址,登录你自己刚创建的管理员账号,搜索型号或者名字,就能查到家里有没有这个东西、保修到哪天。全家人都可以建各自的账号一起维护这份档案。
数据与备份
所有数据都在 data 文件夹里(SQLite 数据库加照片附件),定期把整个文件夹复制到另一块盘或另一台设备,就是一份完整的备份。只给自己家里人用的话,可以在编排的 environment 里加一行 HBOX_OPTIONS_ALLOW_REGISTRATION=false,建完管理员账号后重启容器,关闭公开注册。
相关教程

开源自托管旅行日志:互动地图点亮去过的地方、行程按天排、链接发给家人。Compose 部署、首次启动要点、PassNAT 穿透、常见问题。

在飞牛 NAS 上用 Docker 自建书签库 Linkding:一份编排贴进 Compose 就能跑,管理员账号在编排里直接建好;再用帕斯内网穿透把它开放到公网,换台电脑、人在外面也找得着自己收的网址。含编排逐行说明和建隧道每一栏怎么填。

Umbrel是开源家庭服务器操作系统,让你拥有完全私有的云服务。支持树莓派、x86和虚拟机多平台部署,内置应用商店一键安装各类应用。完全本地存储数据,无需上传云端,掌控个人隐私和信息安全。提供详细安装指南和内网穿透配置方案。

在 NAS 上用 Docker Compose 部署开源表格数据库 Grist:用启动密钥初始化管理员,建家庭成员和支出明细两张表,经手人用 Reference 关联到人,Access Rules 控制谁能看谁能改;用帕斯内网穿透拿公网地址,家人手机上也能查。含完整编排和步骤。