Homebox介绍

项目介绍

  • Homebox 是为家庭用户构建的库存和组织系统（数字化库存管理系统）

  • Homebox 旨在帮助用户轻松纪录和跟踪家中的所有设备。使用Go开发实现，并使用SQLite作为数据库，非常轻量易用。

  • Homebox 是一款 自托管的家庭资产管理系统，开发者 hay-kot 用 Golang 和 Svelte 技术栈打造了这个轻量级工具。它通过条码扫描、分类归档、智能提醒等功能，将你的物品信息全部数字化，堪称「实体物品的云端大脑」。

  • Snipe-It 是 IT 管理的黄金标准。如果您的用例是管理耗材和 IT 物理基础设施，我强烈建议您查看 Snipe-It 而不是 Homebox，它只是为该用例而专门构建。相比之下，Homebox 是专为家庭用户构建的，这意味着我们试图专注于保持简单易用。减少创建和管理项目的摩擦是 Homebox 的一个关键目标，这意味着您将失去一些更高级的功能。在大多数情况下，这是一个很好的权衡。

核心功能

  • 🗂️ 建立家庭物品电子档案库

  • 🔍 5秒定位任何物品的位置和状态

  • ⏰ 主动推送保修到期、电池更换等提醒。

  • 📊 可视化统计消费习惯，减少浪费。

项目优点

  • 极简部署，小白友好。
    支持 Docker 一键部署，10分钟即可搭建专属系统。提供手机/电脑多端适配的网页界面，无需安装APP也能随时查看。

  • 条码识别黑科技
    支持 ISBN、UPC、QR 等 20+ 条码类型。
    扫描商品条码自动填充信息，连螺丝刀套装都能记录规格参数。

  • 智能生命周期管理，独创的维护跟踪系统。
    电子设备：保修到期前3个月提醒
    食品药品：临期预警+自动计算最佳使用周期
    工具耗材：根据使用频率建议补货时间

  • 隐私保护
    数据完全自主掌控，支持本地存储，杜绝隐私泄露风险。

  • 场景化分类体系
    预设 8 大类 200+ 子类目（电子设备/家居用品/收藏品等），支持自定义标签。你的乐高收藏和外婆的缝纫线轴都能科学归类。

适用场景

  • 科技极客家庭
    管理智能家居设备的固件版本和保修信息
    记录NAS、硬盘序列号与购买渠道

  • 有娃的三口之家
    跟踪奶粉、尿布的库存余量
    记录儿童玩具的电池更换时间

  • 租房改造达人
    拍摄家具拆解步骤存档
    统计装修材料采购清单

  • 中古收藏爱好者
    建立黑胶唱片、手办的价值评估档案
    记录限量版商品的购买凭证

  • 适老化家庭改造
    标注药品的服用方法和禁忌
    设置助听器等设备的维护提醒

部署教程

Docker Compose方式部署

  1. 演示以在群晖NAS系统上安装为例
    （其他系统请自行安装好最新版本Docker、docker compose）

  2. 打开群晖的SSH功能，使用终端软件进行连接，并切换到root状态下。
    image-pmrl.png

  3. 进入群晖的docker文件夹（你想将容器数据存储到哪就进哪个文件夹）
    （其他NAS系统的可直接看下一步，手动创建一个文件夹再右键文件夹查看属性，复制文件夹路径进入。）

    # 将/volume1/docker换成你自己的文件夹路径

cd /volume1/docker

  4. 创建项目文件夹及子文件夹

    mkdir -p Homebox/homebox-data

  5. 进入项目文件夹

    cd Homebox

  6. 编辑docker-compose.yml模板文件

    vi docker-compose.yml

  7. 按字母 i 键进入编辑模式，复制并修改下面的配置文件，粘贴到终端，按Esc键退出编辑模式，输入 :wq 保存并退出。

    （排版太挤的就先粘贴到文本文件内，修改后再使用，灵活应变。）

    version: "3"
services:
    homebox:
        container_name: homebox
        restart: always
        ports:
            - 3100:7745    # 左侧的3100是容器的外部访问端口，可自行修改。
        environment:
            - TZ=Asia/Shanghai    # 设置时区为中国上海
            - HBOX_LOG_LEVEL=info    # 要使用的日志级别，可以是以下之一：trace、debug、info、warn、error、critical
            - HBOX_LOG_FORMAT=text    # log 格式，可以是以下之一：text、json
            - HBOX_WEB_MAX_UPLOAD_SIZE=10    # 限制WEB页面支持的最大文件上传大小（以 MB 为单位）
            - HBOX_OPTIONS_ALLOW_REGISTRATION=true    # 允许用户自行注册
        volumes:
            - ./homebox-data:/data/    # 可将左侧的./homebox-data换成完整的文件夹路径
        image: ghcr.io/hay-kot/homebox:latest

  8. 查看当前项目文件夹的路径

    pwd

  9. 授权该项目文件夹内的读写权限（部分NAS系统需要【如群晖】，否则容器无读写权限访问运行，按需执行。）

    # 将/volume1/docker/Homebox换成你自己的实际项目文件夹路径

chmod -R 777 /volume1/docker/Homebox/*

  10. 执行命令，启动docker-compose模板文件，拉取镜像并创建容器。

    docker-compose up -d

或

docker compose up -d

  11. 查看正在运行的项目容器实时日志，按Ctrl+C中断查看。

    docker-compose logs -f

或

docker compose logs -f

访问Homebox

  1. 打开浏览器，以NAS的IP+设置的端口进行访问。
    以本机为例：http://172.16.19.200:3100
    点击Register注册一个账户

  2. 设置你的邮箱、用户名、密码，然后点击Register注册。

  3. 注册成功后点击登录

  4. 登录后点击Profile--Group Settings，把货币格式改成人民币，然后点击Update Group。
    下面的Theme Settings是可选主题，随意选择一个你喜欢的主题即可自动切换。

  5. 点击主页的Create，可以创建你自己的资产信息。
    （暂时无中文显示，可打开浏览器翻译页面，动脑思考灵活应变，不存在使用难度。）

  6. 其他的就不再一一进行展示，很简单的系统。

项目地址

功德+1（狗子）.gif

👇👇👇