Snipe-IT 資產(chǎn)管理系統(tǒng) Docker 保姆級部署實戰(zhàn)從一臺空機器到資產(chǎn)臺賬上線一條命令跑通【免費下載鏈接】snipe-itA free open source IT asset/license management system項目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it如果你的公司還靠一張共享 Excel 表格記著幾百臺筆記本、顯示器、軟件授權是誰在用那你大概率經(jīng)歷過這種場面月底盤點時財務要設備折舊數(shù)據(jù)、行政要領用記錄、運維要保修狀態(tài)而那張表里三分之一的行已經(jīng)過期了。Snipe-IT 就是來解決這個問題的——一套免費開源的 IT 資產(chǎn)與許可證管理系統(tǒng)asset/license management system用 Web 界面管設備、軟件授權、耗材、配件和維修記錄還帶二維碼標簽、CSV 批量導入和完備的權限體系。本文用 Docker 把它跑起來全程可以照抄命令目標是一臺只有 Docker 的空機器最終得到一個能正常登錄、能錄資產(chǎn)、能備份恢復的生產(chǎn)可用系統(tǒng)。本文命令均在 Linux 服務器上驗證過使用的項目版本為當前倉庫主分支。文章基于倉庫內(nèi)的docker/docker.env、docker-compose.yml與docker/startup.sh實際配置展開所有涉及密鑰、密碼、域名的地方都用占位符標出請務必替換成你自己的值。動手之前先給自己做一次體檢大多數(shù)部署翻車不是命令敲錯了而是環(huán)境沒對齊。照著下面這份清單核對一遍能省掉后面一半的排障時間。硬件與系統(tǒng)檢查項最低要求我的建議操作系統(tǒng)任意支持 Docker 的 Linux 發(fā)行版Ubuntu 22.04 / Debian 12 均可內(nèi)存2 GB4 GB 以上跑 MySQL 更從容磁盤10 GB 可用單獨給數(shù)據(jù)卷留足空間端口8000可改生產(chǎn)環(huán)境建議換高位端口軟件工具先確認版本避免舊版 compose 語法不兼容docker --version docker compose version看到 docker 20 和 compose v2 就沒問題。接著克隆項目代碼倉庫地址僅此一處需要后續(xù)操作全部在本地完成git clone https://gitcode.com/GitHub_Trending/sn/snipe-it cd snipe-it版本選型說明docker-compose.yml里應用鏡像寫的是snipe/snipe-it:${APP_VERSION:-latest}數(shù)據(jù)庫是mariadb:11.4.7。APP_VERSION沒設置時默認拉取latest。想固定版本就在.env里寫死APP_VERSIONv7.x.x——生產(chǎn)環(huán)境強烈建議這么做避免某天latest更新后行為變化。鏡像來源應用和數(shù)據(jù)庫鏡像都從 Docker Hub 拉取無需額外配置倉庫。倉庫里docker/目錄自帶三份 Dockerfile 和一套完整啟動腳本startup.sh我們不走源碼構建直接用官方鏡像最省事。里程碑一把配置模板請回家并逐項人肉校對項目不提供開箱即用的.env但給了模板復制一份再改cp docker/docker.env .env打開.env你會看到大量被注釋的鍵和幾個還沒被展開的${...}占位符。這里是最容易踩坑的地方docker/docker.env是給舊版docker-compose.yml鏈接方式傳數(shù)據(jù)庫地址用的模板里面DB_HOST${MYSQL_PORT_3306_TCP_ADDR}這種寫法在新版 compose 里不會被自動展開原樣傳給應用容器會導致數(shù)據(jù)庫連不上。我們要做的是把關鍵項全部改成明確的值。必須改的配置一個都不能少配置項填什么說明與注意APP_KEYbase64:...下一步生成應用加密密鑰留空容器直接啟動失敗APP_URLhttp://你的服務器IP:8000生成郵件鏈接、二維碼依賴它APP_TIMEZONEAsia/Shanghai時區(qū)決定所有時間顯示APP_LOCALEzh或en界面語言DB_HOSTdb改成 compose 服務名不要留模板的${...}DB_PORT3306DB_DATABASEsnipeit數(shù)據(jù)庫名DB_USERNAMEsnipeit_user普通賬號DB_PASSWORD一串強隨機密碼別和 root 密碼相同MYSQL_ROOT_PASSWORD另一串強隨機密碼compose 文件里 db 服務會讀取這個值MAIL_MAILERsmtp郵件可后配不影響部署生成隨機密碼用系統(tǒng)自帶工具即可openssl rand -base64 24至于MAIL_HOST等郵件項模板里的${MAIL_...}同樣不會被展開可以先全部換成你自己的 SMTP 配置或者臨時注釋掉——系統(tǒng)能正常跑只是收不到通知郵件后續(xù)在后臺設置里再補。里程碑二生成應用密鑰這是第一條命脈APP_KEY是 Laravel 應用的加密基石Snipe-IT 的啟動腳本startup.sh里寫死了校驗邏輯檢測不到APP_KEY就打印提示并退出。生成方式不用自己編官方鏡像里帶了 artisan 命令docker compose run --rm app php artisan key:generate --show這條命令會先拉取鏡像第一次較慢然后輸出一串base64:xxxxx。把它填回.env的APP_KEY后面格式是APP_KEYbase64:xxxxx注意base64:前綴別丟。密鑰生成后要長期保存。它用于加密數(shù)據(jù)庫里的敏感字段換密鑰會導致已加密數(shù)據(jù)無法解密這不是能隨便 rotate 的值。里程碑三拉起容器等一句Supervisord started successfully一切就緒啟動docker compose up -ddocker-compose.yml定義了三個東西值得先看懂a(chǎn)pp服務把宿主機${APP_PORT:-8000}端口映射到容器內(nèi) 80storage卷掛在/var/lib/snipeit上傳文件、備份都在這里db服務用mariadb:11.4.7數(shù)據(jù)落在db_data卷還配了 healthcheckapp會等數(shù)據(jù)庫健康后再啟動?？礌顟B(tài)docker compose ps兩個容器都顯示Up之后盯啟動日志docker compose logs -f app日志滾動到最后看到Supervisord started successfully這行就說明 Web 服務進程正式接管了。此時按CtrlC退出日志跟隨容器不受影響。順帶做個快速健康檢查——項目在routes/web.php里注冊了無需登錄的/health路由curl -s -o /dev/null -w %{http_code}\n http://127.0.0.1:8000/health返回200即通過。這一步只驗證 Web 層數(shù)據(jù)庫連接是否正常等下一步瀏覽器見真章。里程碑四走完 /setup 向導創(chuàng)建你的第一個管理員打開瀏覽器訪問http://你的服務器IP:8000。第一次訪問沒有配置任何用戶系統(tǒng)會自動跳到/setup安裝向導。這個向導是 Snipe-IT 獨有的初始化流程分兩步先做環(huán)境自檢數(shù)據(jù)庫連通、存儲目錄可寫、.env 是否暴露再創(chuàng)建管理員賬號。向導里注意三件事環(huán)境自檢頁如果報錯會明確告訴你是哪一項不合格按提示修完刷新即可不用重來。管理員賬號用你的真實郵箱和強密碼別用adminexample.com / password這種演示值——雖然參考文檔常這么寫但這是生產(chǎn)系統(tǒng)第一步就該正經(jīng)。完成后回到登錄頁用剛創(chuàng)建的賬號登錄。登錄后第一件事右上角頭像 → 個人資料 → 修改密碼向導里設的只是初始密碼。登錄后進「管理」菜單把這幾項基礎數(shù)據(jù)填上資產(chǎn)臺賬才有骨架廠商管理錄入聯(lián)想、戴爾等供應商后續(xù)設備型號要引用它資產(chǎn)分類建筆記本顯示器軟件等分類狀態(tài)標簽配置可用/在庫/維修中/報廢等狀態(tài)位置辦公室、機房等物理位置上線之后的三層驗證確認真的部署成功了光能打開登錄頁不算完按下面三層走一遍冒煙測試才算真正交付第一層頁面功能冒煙新建一個分類 → 新建一個廠商 → 新建一條資產(chǎn)不填序列號也能建但建議填給資產(chǎn)打二維碼標簽列表頁的二維碼圖標確認圖片能正常生成記一條維護記錄確認日期、費用字段能保存第二層數(shù)據(jù)與日志驗證# 應用日志無異常堆棧 docker compose logs app --tail 50 # 數(shù)據(jù)確實落進了 MySQL在 db 容器里查一下 docker compose exec db mariadb -u snipeit_user -p snipeit -e show tables;密碼會以明文出現(xiàn)在命令行參數(shù)里注意別截圖外發(fā)。能看到幾十張業(yè)務表說明連接和遷移都正?！猻tartup.sh每次啟動都會自動執(zhí)行php artisan migrate --force所以表結構你不需要手動建。第三層重啟韌性驗證docker compose restart app重啟后能正常登錄、數(shù)據(jù)還在說明卷掛載和持久化沒問題。這個測試建議在正式交付前必做它能暴露一大類數(shù)據(jù)只存在容器里的隱患。把備份、升級、監(jiān)控排進值班表部署完成只是起點運維節(jié)奏要固定下來。我給三個建議的固定動作備份每周一次雷打不動Snipe-IT 內(nèi)置了備份功能數(shù)據(jù)會落到storage卷的dumps/目錄docker compose exec app php artisan backup:run docker compose exec app php artisan backup:list想備份到宿主機把卷里的 dumps 目錄再拷貝一份出來docker cp $(docker compose ps -q app):/var/lib/snipeit/dumps ./backups/升級選業(yè)務低峰期半小時內(nèi)完成# 1. 先備份 docker compose exec app php artisan backup:run # 2. 拉新代碼如果用的是 git 部署方式 git pull origin master # 3. 拉新鏡像并重啟 docker compose pull docker compose up -d # 4. 遷移會自動執(zhí)行但可以手動確認 docker compose exec app php artisan migrate --force docker compose exec app php artisan config:clear docker compose exec app php artisan cache:clear監(jiān)控看一眼就夠docker stats docker compose logs -f --tail 50 app盯三個指標CPU 長期 80% 說明該加資源/var/lib/snipeit所在磁盤快滿就該清備份日志里出現(xiàn)大量 500 就去看異常堆棧。踩坑實錄五個高頻事故的現(xiàn)象、原因與解藥以下問題都來自真實部署場景按現(xiàn)象 → 原因 → 解決記錄。事故一容器啟動即退出現(xiàn)象docker compose up -d后docker compose ps顯示 app 狀態(tài)為Exited。原因APP_KEY缺失。startup.sh檢測不到就直接退出日志里會有Please re-run this container with an environment variable $APP_KEY的提示。解決按里程碑二生成密鑰寫入.envdocker compose up -d重新拉起。事故二頁面 500 或數(shù)據(jù)庫連接失敗現(xiàn)象能進/setup但環(huán)境自檢報數(shù)據(jù)庫錯誤。原因.env里DB_HOST還是模板原樣DB_HOST${MYSQL_PORT_3306_TCP_ADDR}這個變量在 compose 環(huán)境下永遠不會展開應用拿它當主機名去連必然失敗。解決把DB_HOST改成dbDB_PORT改成3306確保.env里的DB_USERNAME/DB_PASSWORD與 compose 里 db 服務的MYSQL_USER/MYSQL_PASSWORD一致。改完docker compose up -d重建。事故三能登錄但上傳圖片/CSV 報文件過大現(xiàn)象導入 CSV 或上傳頭像時提示超出upload_max_filesize。原因PHP 上傳上限默認較小。解決.env里加一行PHP_UPLOAD_LIMIT100單位是 MBstartup.sh會在啟動時自動寫入 php.ini然后docker compose restart app。事故四8000 端口被占現(xiàn)象docker compose up報端口綁定沖突。原因服務器上已有別的服務用了 8000。解決.env里設置APP_PORT8080或你喜歡的任意端口重新docker compose up -d訪問地址隨之變化。事故五數(shù)據(jù)丟了現(xiàn)象執(zhí)行過docker compose down -v后重來一遍發(fā)現(xiàn)所有資產(chǎn)記錄都沒了。原因-v會連帶刪除卷db_data和storage里的數(shù)據(jù)一并清空。down不加-v是安全的加上就是格式化。解決備份先行日常重啟用restart或down永遠不要對生產(chǎn)數(shù)據(jù)卷執(zhí)行down -v。進階玩法緩存、HTTPS、多實例與認證集成系統(tǒng)穩(wěn)定跑起來之后下面幾個方向按需取用點到即止。Redis 緩存docker-compose.yml里加一個redis:alpine服務然后.env配置CACHE_DRIVERredis SESSION_DRIVERredis QUEUE_CONNECTIONredis REDIS_HOSTredis REDIS_PASSWORD你的密碼startup.sh已經(jīng)內(nèi)置了對REDIS_*環(huán)境變量的讀取支持改了就能用。多實例橫向擴容的前提就是先上 Redis否則文件會話在多實例間不共享。HTTPSstartup.sh會自動檢測/var/lib/snipeit/ssl/snipeit-ssl.crt和snipeit-ssl.key兩個文件存在就啟用 Apache 的 SSL 模塊。把證書放進 storage 卷的ssl/目錄后重啟容器即可無需改任何配置。多實例有負載均衡器的話可以部署多個 app 副本把APP_PORT錯開映射前置 Nginx 做反向代理。每個副本共享同一個數(shù)據(jù)庫和 Redis會話由 Redis 統(tǒng)一管理。認證集成倉庫里已經(jīng)帶了 SCIM 路由routes/scim.php、SAML 服務提供者SamlServiceProvider和完整的 LDAP 設置項在后臺「設置 → LDAP」里可以配 AD/LDAP 同步實現(xiàn)公司賬號體系單點登錄。這個功能建議交給熟悉目錄服務的人來配屬于配置半小時、排障一整天的典型項目。CSV 批量導入倉庫sample_csvs/目錄下有資產(chǎn)、用戶、授權、廠商等各類樣例 CSV后臺導入向導會先讓你上傳文件、再逐字段映射比手工錄幾百行高效得多。導入前務必先用assets-sample.csv這種模板格式驗證一遍字段名。收尾把今天的動作濃縮成一張自檢清單最后照著這份清單過一遍過了就算正式交付docker compose ps兩個容器均為 Upcurl http://IP:8000/health返回 200/setup向導已走完管理員賬號密碼已修改已新建至少一條資產(chǎn)并生成了二維碼.env中APP_KEY、APP_URL、DB_HOSTdb均已確認php artisan backup:run執(zhí)行成功備份文件出現(xiàn)在 dumps 目錄重啟 app 容器后數(shù)據(jù)仍在已設置PHP_UPLOAD_LIMIT如需大文件導入已用openssl rand生成強密碼并妥善保管未使用示例默認值到這里一套能錄入資產(chǎn)、能管授權、能追維護、能備份恢復的 Snipe-IT 就已經(jīng)在你手上跑起來了。接下來值得做的第一件事把你們公司手頭那張共享 Excel 導成 CSV按sample_csvs/assets-sample.csv的格式整理好導入系統(tǒng)讓臺賬真正活起來。部署只是開始數(shù)據(jù)進去的那一刻它才開始替你干活?！久赓M下載鏈接】snipe-itA free open source IT asset/license management system項目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考