專案

一般

配置概況

動作

Feature #279

進行中
SC SC

部署維運優化 — 一鍵停止腳本、setup 建立 admin、後端 loopback 綁定

Feature #279: 部署維運優化 — 一鍵停止腳本、setup 建立 admin、後端 loopback 綁定

是由 Sashiba Chou約 2 個月 前加入.

狀態:
New
優先權:
Normal
被分派者:
開始日期:
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 環境使用。

沒有任何資料可供顯示

動作

匯出至 PDF Atom