家庭资产智能管理系统HomeBox，NAS一键部署，内网穿透随时随地查看家中物品清单库存

项目介绍

HomeBox 是一款功能强大的家庭资产管理系统，专为家庭物品清单、资产追踪和库存管理而设计。通过直观的Web界面，你可以轻松记录和管理家中的所有物品，包括电子产品、家具、收藏品等。支持多用户协作、详细的资产分类、搜索功能和数据导出，让你对家庭资产一目了然。

无论是保险理赔、搬家盘点还是日常物品管理，HomeBox 都能帮你高效地组织和追踪所有信息。界面简洁易用，开箱即用，无需复杂配置就能快速上手。

项目地址：点我跳转

部署安装

如需在外网也能访问你的HomeBox系统，建议配置内网穿透服务。可以前往 帕斯内网穿透 注册账号，让你随时随地都能管理家庭资产。具体操作步骤可以 点我查看 内网穿透全平台快速入门指南。

最快速部署方式（Docker单命令）

打开你的飞牛NAS或其他NAS设备，在Docker应用中选择本地镜像，点击'添加镜像'，选择'从URL添加'。

镜像地址填写：ghcr.io/hay-kot/homebox:latest

等待镜像下载完成后，点击启动按钮创建容器。

在容器配置界面中：

基础设置：

勾选'开机自动启动'确保系统重启后自动运行

端口映射：

设置如下端口映射关系：

主机端口：3100（如果3100已被占用，可改为其他端口如3101、3102等）

容器端口：7745（这是HomeBox内部服务端口，保持不变）

存储位置：

需要创建一个数据持久化目录用于保存HomeBox的数据库和配置文件：

容器路径：/data

主机路径：建议在NAS上创建一个文件夹，如 /mnt/homebox-data

环境变量设置：

必须设置：

TZ：时区设置，默认值 Europe/Bucharest（根据你所在地区修改，如中国用 Asia/Shanghai）

可选设置（按需配置）：

HBOX_LOG_LEVEL：日志级别，默认 info（可选值：trace, debug, info, warn, error, critical）

HBOX_LOG_FORMAT：日志格式，默认 text（可选值：text, json）

HBOX_WEB_MAX_UPLOAD_SIZE：最大上传文件大小（MB），默认 10

HBOX_OPTIONS_ALLOW_REGISTRATION：是否允许用户自主注册，默认 true

HBOX_OPTIONS_AUTO_INCREMENT_ASSET_ID：是否自动递增资产ID，默认 true

其他变量保持默认即可，无需修改。

完成上述配置后点击'下一步'启动容器。

访问应用

容器启动成功后，在浏览器中访问：http://你的NAS地址:3100

如果你修改了主机端口，请相应地改为你设置的端口号。首次访问会进入注册页面，创建管理员账号后即可开始使用HomeBox管理你的家庭资产。

本篇教程结束