一台主機、一個能執行 docker 的帳號，全程不碰網路

1. 先確認新的埠是空的 建議 8080，不行就 8081、8090。

   # Ubuntu
   sudo ss -ltnp | grep ':8080 '
   
   # Windows（命令提示字元或 PowerShell）
   netstat -ano | findstr LISTENING | findstr /C:":8080 "

   沒有任何輸出才可以用。 /C: 不能省——findstr 預設把搜尋字串裡的空白當成「或」， 少了 /C: 會把 :8090、:8080 這些不相干的埠一起印出來，看起來像被佔用了。
2. 把設定檔的 LISTEN_PORT 改掉 用記事本或任何文字編輯器打開 .env， 找到 LISTEN_PORT=80 改成 LISTEN_PORT=8080。 沒有那一行就自己加一行。改完一定要存檔。
3. 重啟服務

   docker compose -f docker-compose.offline.yml up -d

4. 確認 最簡單的方法是直接用瀏覽器開 http://localhost:8080/health， 看到 {"status":"ok", …} 就成了。

1. 服務有起來

   curl -s http://localhost/health

   要看到 {"status":"ok", …}。 status 不是 ok 就停下來——那不是網路問題，是系統在啟動時掃描執行環境， 發現了不該存在的元件（見第 3 項）。
2. 同事連得到 在主機上查 IP（Ubuntu hostname -I，Windows ipconfig）， 在另一台電腦的瀏覽器打開 http://那個IP/，看得到操作畫面就成了。 要的是 192.168. 或 10. 開頭的位址——172.17. 開頭的是 Docker 內部用的， 填那個同事一定連不到。
3. 自己驗證授權合規（不必相信我們的說法）

   curl -s http://localhost/health | grep licensing
   curl -s http://localhost/licenses

   系統每次啟動都會掃描實際的執行環境， 找有沒有 GPL／AGPL 授權的元件。掃到任何一個就拒絕啟動。 第三方元件的完整清單與授權全文在交付包的 LICENSES/，那個目錄不要刪。
4. 功能驗收 解開 demo-pack.zip，照驗收單逐項跑一次，當著承辦人的面簽收。 範本檔涵蓋手機翻拍的採購單、含個資的員工資料、發票集錦、合約、月報表、 簡報、零件圖與夾了空白頁的掃描件——就是最容易出事的那幾類。

foldra-offline-v1.x.x/
├── images/                  四個 .tar，這是全部的程式，約 3～4 GB
├── compose/                 啟動設定
├── web/                     網頁前端
├── LICENSES/                第三方授權文件（法律要求，不要刪）
├── docs/                    安裝說明、使用手冊、驗收單
├── install.sh               Linux / macOS 用
├── install.ps1              Windows 用
├── rollback.sh              退回上一版
├── collect-diagnostics.sh   出事時產生診斷包
└── demo-pack.zip            驗收用的範本檔