1. 项目概述
HomeBox是一款专为个人和家庭设计的物品资产管理工具,它能够帮助用户对各类物品进行分类标签、信息记录和照片上传,实现物品资产的系统化整理。通过NAS部署的方式,可以实现本地化管理,多设备访问,让物品管理变得更加便捷高效。
作为一名长期使用NAS进行家庭数据管理的用户,我发现物品管理一直是个痛点。家里各种电子设备、工具、收藏品越来越多,经常会出现"东西明明买了却找不到"或者"重复购买相同物品"的情况。HomeBox正好解决了这个需求痛点。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 NAS选择与准备
本次演示使用的是飞牛NAS,但HomeBox的部署方式具有普适性,同样适用于群晖、威联通、绿联等主流NAS品牌。在开始部署前,请确保:
- 你的NAS已经正确安装并联网
- 已经启用了Docker功能(大多数NAS系统都内置了Docker支持)
- 有足够的存储空间用于存放物品数据(建议至少预留1GB空间)
提示:不同NAS品牌的Docker功能入口可能略有不同,通常在"应用中心"或"套件中心"中可以找到。
2.2 文件目录准备
在飞牛NAS上部署HomeBox,首先需要创建适当的文件目录结构:
- 打开飞牛NAS的「文件管理」应用
- 导航到docker文件夹(通常在根目录下)
- 在docker文件夹内创建一级文件夹:
homebox - 在
homebox文件夹内创建二级文件夹:data
这个目录结构非常重要,因为后续的Docker容器会将所有数据存储在这个data文件夹中。这样设计的好处是:
- 数据与容器分离,即使容器重建也不会丢失数据
- 方便进行数据备份
- 可以通过NAS的文件管理直接访问数据文件
3. Docker部署HomeBox
3.1 创建Docker Compose项目
飞牛NAS提供了友好的Docker管理界面,我们可以通过Compose方式来部署HomeBox:
- 打开飞牛NAS的「Docker」功能
- 切换到「Compose」面板
- 点击"创建新项目"按钮
- 填写项目信息:
- 项目名称:homebox(建议保持默认)
- 路径:选择刚刚创建的
/docker/homebox目录 - 来源:选择"创建d
