我把家搬進了NAS？家庭資產數字化革命，現在連襪子都有編號了！

家裏東西一多，總有一種“我記得我有這個，但我不知道放哪了”的錯覺。

靠腦子記、紙條貼、拍照翻？那是上個世紀的操作了！

與其在角落翻箱倒櫃，不如直接上系統管理！今天就來教大家如何在 NAS 上，用 Docker Compose 一鍵部署一款顏值在線、功能靠譜、開源免費的家庭資產管理神器——Homebox。

簡單來說，Homebox 就像是你家的“物品圖書館”。每件東西都能建檔、貼標籤、分門別類、定位擺放，甚至還能記錄保修、購買日期、價格、序列號……未來某天你再也不用對着一堆電池、充電線或遙控器發呆了。

如果你有 NAS、有 Docker、有一點點收納焦慮，那你一定得試試這個工具。

動手吧，整理從“數碼”開始！

——————————————————————————————————————————————————

🧰 項目特點

📦 物品管理系統： 預設 8 大類 200+ 子品類，爲每件物品創建詳細檔案，記錄名稱、分類、圖片、自定義標籤、序列號、保修信息、保質期等。

📍 多層級位置追蹤： 可自定義“地點 → 區域 → 位置”三級結構，精準定位每一件物品放在哪裏。

🔎 條碼識別： 支持 ISBN、UPC、QR 等 20+ 條碼類型。掃描商品條碼自動填充信息，甚至能記錄製造商、型號等規格參數。

⏰ 動態管理： 內置智能生命週期管理系統，可針對不同物品類型提供定製化提醒：如電子設備保修預警、食品藥品臨期提醒、工具耗材補貨建議，做到主動管理、心中有數。

🏷️ 標籤分類靈活： 支持標籤系統，方便快速檢索和篩選。

📸 圖片上傳支持： 每個物品可上傳圖片，圖文並茂更直觀。

🔍 快速搜索功能： 全局搜索讓你再也不會找不到東西。

👤 多用戶支持： 支持多賬戶使用，適合家庭或小型團隊協作。

🌐 Web 界面簡潔美觀： 基於現代前端框架，響應式 UI，移動設備也能流暢使用。

📦 支持 Docker 部署： 官方提供 Docker 鏡像和 Compose 模板，部署簡潔高效。

🆓 完全開源免費： 代碼託管於 GitHub，可自定義修改和二次開發。

Snipe-it是IT管理的黃金標準。如果您的用例是管理消耗品和IT物理基礎設施，建議你考慮使用 Snipe-It 而不是 Homebox，因爲它更適合。相比之下，Homebox是專爲家庭用戶打造的，這意味着Homebox更爲簡單和易於使用。降低創建和管理項目的阻力是Homebox的一個關鍵目標，這意味着您將失去一些更高級的功能。然而在大多數情況下，對家庭用戶來說這是一個很好的權衡。

——————————————————————————————————————————————————

部署流程

以威聯通NAS爲例，打開Container Station進行部署。

部署代碼如下，大家注意格式對齊：

version: "3.4" # 最新版該行可刪除

services:

   homebox:

   image: ghcr.io/hay-kot/homebox:latest

# 不用哪個就刪掉哪個

# image: ghcr.io/hay-kot/homebox:latest-rootless

   container_name: homebox

   restart: always

   environment:

      - HBOX_LOG_LEVEL=info # 日誌級別

      - HBOX_LOG_FORMAT=text # 日誌格式

      - HBOX_WEB_MAX_UPLOAD_SIZE=10 # 最大上傳文件大小10MB

   volumes:

      - /share/Container/homebox-data:/data/ # 冒號左側可自定義

   ports:

      - 3100:7745 # 冒號左側可改

注：如果你使用rootless鏡像，並選擇掛載本地目錄（而非命名卷），務必提前將該目錄授權給容器內部的非 root 用戶（ID 爲 65532），否則會因權限問題導致無法寫入：

volumes: - /path/to/data/folder:/data

SSH執行：

chown 65532:65532 -R /path/to/data/folder

環境變量配置總覽如下，爲了方便使用，大家可以選擇配置個郵件服務器，由於相關配置教程已經很多，這裏便不再贅述。

這裏的 HBOX_MAILER_PASSWORD 應填寫的是 郵件服務提供商的“授權碼”或“應用專用密碼”，而不是你郵箱的登錄密碼。

——————————————————————————————————————————————————

使用及功能演示

安裝完畢後，WEB 輸入 NAS_IP:3100 即可訪問服務。不過這次倒是沒有默認的管理員賬戶，需要咱們自行創建。點擊Register。

填寫郵箱、名稱、密碼，並註冊。

進行登錄。

左側欄點擊Profile，幣種設置成RMB，下面也可以選擇顏色主題（配色很多，可以挨個換）。

點擊Locations，可編輯位置區域。基礎是英文，修改成自己的習慣語言。大家可以在現有基礎上編輯、增加或刪除。

接着點擊Create，嘗試新增物品（Item/Asset）。第三項Label爲標籤。每一項皆可按住 Shift + Enter 快捷連續添加多個標籤。

填寫具體信息並點擊Create。

接着可以看到完整的詳情頁面，可以填寫補充：

基本信息（Details）：描述、數量、序列號、型號、廠商、是否投保、備註等。

附件信息（Attachments）：發票、照片、說明書等。

購買信息（Purchase Details）：購買渠道、購買時間、購買價格。

維護記錄（Maintenance）：維護歷史，如清潔、更換零件、維修記錄等。

保修信息（Warranty Details）：追蹤保修狀態，是否終身保修、保修到期時間、保修條件、服務電話等。

出售信息（Sold Details）：買家姓名或平臺、成交金額、出售日期。

如果我們要補充這些信息，需要點擊Edit，然後開啓高級選項。這個界面剛開始打開就要卡一次，大家原地刷新一下就行。

我簡單填寫了一個，內置的二維碼生成器，可掃描快速查看。

在位置以及搜索都可以看到添加的項目，但是要快速瀏覽還是在搜索欄比較直接。

支持全文搜索。可以根據位置、標籤提前過濾，也可開啓高級搜索。

這裏還有內置的標籤生成器導航，點擊跳轉可快速生成打印標籤，可以打印出來貼在物品儲藏盒子上。

手機端的體驗也很不錯，手機自帶的掃碼工具以及微信掃碼都能直接跳轉到對應的物品信息欄。

——————————————————————————————————————————————————

最後

Homebox是可以把家裏每樣東西都“實名登記、標籤歸類、位置座標、保修登記、銷售信息”一網打盡的數碼倉庫管理員。

而你，只需要動動手指，就能實現：

“家人問：備用電池放哪了？”——秒答 ✅

“這耳機還在保修嗎？”——一查便知 ✅

“這個玩意是在哪裏買的來着？”——有圖有真相 ✅

關鍵是部署簡單、操作輕鬆、顏值還在線。

所以，趁着你還記得家裏哪些東西放在哪，趕緊動手摺騰起來吧！

感謝觀看，本文完。