手把手教你部署Homebox：打造专属家庭资产管理系统

Homebox是一款专为家庭用户设计的开源、自托管库存与组织系统。它通过直观的分组、位置定位与标签体系，帮助用户高效地追踪和管理家中的各类物品。无论是家庭日常用品的归档，还是小型仓库的资产盘点，它都能提供一个结构清晰、易于维护的数字化解决方案。

安装步骤：使用Docker Compose快速搭建

部署Homebox最便捷的方式是使用Docker Compose。你只需在服务器或NAS上创建一个docker-compose.yml文件，并写入以下配置内容。

services:
  homebox:
    image: ghcr.io/hay-kot/homebox:latest
    container_name: homebox
    ports:
      - 7745:7745
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./data:/data
    restart: unless-stopped

保存文件后，在相同目录下执行 docker-compose up -d 命令，即可启动Homebox服务。容器将自动创建并运行在后台。

使用指南与功能详解

初始化设置与登录

服务启动后，在浏览器地址栏输入 http://你的服务器IP:7745 即可访问Homebox的Web界面。

首次使用需要创建管理员账户。在登录界面下方找到并点击“Register”（注册）按钮。

按照提示填写用户名、邮箱和密码等信息，完成账户注册。

注册成功后，使用刚才设置的邮箱和密码进行登录，即可进入系统主面板。

界面与基础配置

Homebox的主界面设计十分清爽，布局直观，各项功能一目了然。

需要注意的是，当前版本应用本身并未内置中文支持。不过，你可以借助浏览器的网页翻译功能（如Chrome的右键“翻译成中文”选项）来获得更好的浏览体验。

为了让资产价值显示更符合本地习惯，建议先进行货币设置。点击右上角头像，进入“Profile”（个人资料）页面，在“Currency”（货币）下拉菜单中选择“CNY - Chinese Yuan”，将货币格式切换为人民币。

设置完成后返回首页，可以看到金额的单位已经成功更新为“¥”。

核心功能：位置与标签管理

一个高效的管理系统始于清晰的组织结构。Homebox的核心逻辑围绕“位置”和“标签”展开。

点击侧边栏的“Locations”（位置），系统已预设了几个示例地点。你可以根据实际情况保留、修改或删除它们。

点击任意位置可进入详情页，若不需要可点击删除。

点击“Create”（创建）按钮，开始新建你自己的物品存放位置。

填写位置的名称与描述，例如“客厅储物柜”或“书房书架第三层”。

更强大的是，你可以为位置指定一个“Parent”（父位置），从而实现多层级的结构管理，例如“家 -> 书房 -> 书桌抽屉”。如果下拉框未显示选项，尝试刷新页面或直接输入已存在位置的名称即可。

除了位置，标签是另一种灵活的归类方式。在“Tags”（标签）页面，你可以创建诸如“电子产品”、“重要文件”、“季节性物品”等标签，方便从不同维度筛选物品。

添加与管理物品资产

当位置和标签都准备就绪后，就可以开始添加具体的物品了。点击导航栏的“Items”（物品），然后选择“New Item”（新建物品）。

在创建页面，为物品命名，并从下拉菜单中选择其存放的位置。你还可以为它添加一个或多个标签，并填写购买价格、数量、型号、序列号以及上传图片等详细信息。

保存后，进入该物品的详情页，可以补充更多信息，如购买日期、保修信息、使用手册链接或备注。

一个非常实用的功能是，系统会为每个物品自动生成唯一的二维码。你可以将其打印出来并粘贴在实物上，日后只需用手机扫描即可快速查看该物品的电子档案。

在位置页面，点击展开某个地点，可以直观地看到存放在此的所有物品列表。

当然，你也可以利用顶部的全局搜索框，通过名称、标签或位置快速定位到任何物品。

高级功能与个性化设置

Homebox还提供了一些增强功能以完善使用体验：

• 数据备份与迁移：在“Settings”（设置）中，你可以找到导入和导出功能，方便对整个系统的数据进行备份或迁移到其他实例。
• 多用户协作：系统支持添加多个用户账号，并分配不同的角色和权限，适合家庭成员共同管理家庭资产。
• 个性化主题：提供多种颜色主题可供选择，你可以根据个人喜好切换界面风格。

总结

总体而言，Homebox是目前为数不多专注于家庭及小型场景、且体验良好的轻量级库存管理系统。它通过“位置—标签—物品”的清晰结构，有效解决了日常资产杂乱、难以查找的问题。其界面简洁，核心功能全面，涵盖了从录入、归类、检索到备份的完整流程。

当然，它也存在一些可以改进的地方：一是原生不支持中文界面，需依赖浏览器翻译；二是在添加新数据后，界面偶尔不会自动刷新，需要手动刷新页面才能看到最新内容。不过，对于一款轻量级的自托管工具来说，这些并不影响其核心价值。

综合推荐：⭐⭐⭐⭐（轻量、专注、满足家庭及小型仓库核心管理需求） 使用体验：⭐⭐⭐✨（功能直观，偶有小瑕疵但不影响使用） 部署难易：⭐⭐⭐⭐（基于Docker，部署极为简单）