WebMail Gateway 快速開發指南

開發環境設定 (最簡單方式)

第一步：停止正式環境

ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down'

第二步：在開發機啟動服務

cd D:\_Develop\porscheworld_develop\webmail-gateway
START_DEVELOPMENT.bat

服務會在 http://10.1.0.245:8100 啟動

第三步：測試訪問

方式 A: 直接訪問開發機 (推薦)

方式 B: 透過 SSH 隧道

# 在本機執行
ssh -L 8100:10.1.0.245:8100 porsche@10.1.0.254

# 然後訪問
# http://localhost:8100/vmis-admin

方式 C: 修改 hosts 檔案 (如果需要 HTTPS)

# Windows: C:\Windows\System32\drivers\etc\hosts
10.1.0.245  webmail.lab.taipei

然後訪問: http://webmail.lab.taipei:8100/vmis-admin

開發完成後：部署到正式環境

快速部署

# 1. 上傳修改的檔案
scp app.py porsche@10.1.0.254:/home/porsche/services/webmail-gateway/

# 2. 重啟正式環境
ssh porsche@10.1.0.254 'cd /home/porsche/services/webmail-gateway && docker compose down && docker compose build && docker compose up -d'

透過 Git 部署 (建立 Gitea 倉庫後)

# 1. 提交變更
git add .
git commit -m "Feature: 完整 UI 功能"
git push gitea main

# 2. 伺服器拉取
ssh porsche@10.1.0.254
cd /home/porsche/services/webmail-gateway
git pull
docker compose down && docker compose build && docker compose up -d

重要注意事項

⚠️ Keycloak Redirect URI

開發時如果使用不同的 URL，需要更新 Keycloak client 的 Redirect URI：

正式環境: https://webmail.lab.taipei/{tenant_code}/callback
開發環境: http://10.1.0.245:8100/{tenant_code}/callback

可以同時設定兩個 URI，這樣開發和正式環境都能用。

⚠️ Redis 和 Database

開發環境會直接連接正式環境的 Redis (10.1.0.20) 和 PostgreSQL (10.1.0.20)，請小心操作。

⚠️ Session 衝突

如果同時有人在使用正式環境，Session 可能會衝突。建議開發時使用測試帳號。

2.1 KiB Raw Permalink Blame History Unescape Escape