動作
Feature #279
進行中
SC
SC
部署維運優化 — 一鍵停止腳本、setup 建立 admin、後端 loopback 綁定
Feature #279:
部署維運優化 — 一鍵停止腳本、setup 建立 admin、後端 loopback 綁定
開始日期:
2026-06-13
完成日期:
2026-06-13 (逾期 49 天)
完成比例:
100%
預估工時:
1:00 小時
概述
背景¶
延續 #174 部署環境優化。實際部署到急診部內網後,補上首次安裝與日常啟停的缺口,並收斂後端對外暴露面。
變更內容¶
1. 新增 stop_system.bat(一鍵停止)¶
- 關閉 ER_Note Backend / Frontend 視窗(依視窗標題)
- 釋放 port 8000 / 3000 上殘留的 process
- 與既有 start_system.bat 對應,維運人員不需手動找 PID
2. setup_env.bat 新增建立 admin 帳號步驟(5 步 → 6 步)¶
- 安裝流程最後互動式輸入 admin 帳密(預設 admin / admin)
- 呼叫既有 backend/create_admin.py 建立管理員帳號
- 首次部署不再需要手動進 DB 或另跑腳本建帳號
3. restart_backend.sh 後端綁定 0.0.0.0 → 127.0.0.1¶
- 後端只在 loopback 監聽,不直接暴露於區網
- 對外入口統一為 Next.js :3000,/api/* 經 next.config rewrite 轉發至
127.0.0.1:8000 - 註:此為 .sh 腳本,僅在 Git Bash / WSL 環境生效;Windows 正式部署
對外服務由 Next.js 承擔,後端本就只供本機 proxy 使用
變更檔案¶
- stop_system.bat # 新增
- setup_env.bat # 新增 admin 建立步驟
- restart_backend.sh # host 改為 127.0.0.1
不納入(刻意排除)¶
- start_system.bat # 僅 CRLF 換行差異,無實質變更
- update_and_restore.bat # 僅註解全形→半形破折號,純美化
驗收條件¶
- 全新環境執行 setup_env.bat 可成功建立指定 admin 帳號並登入
- start_system.bat 啟動後,stop_system.bat 能關閉前後端並釋放 8000/3000
- 後端啟動後,區網其他機器無法直連 :8000,但經 :3000 /api 可正常使用
備註¶
正式 Windows 部署的服務啟動仍以 .bat 為主,restart_backend.sh 主要供
開發 / Git Bash 環境使用。
沒有任何資料可供顯示
動作