3.7 KiB

Raw Blame History

Harbor Desk 部署（apps/ 主線）

本目錄給 新後端 apps/backend + 前端 apps/web 的本機／dev 一鍵部署。
（old/deploy 為舊系統封存，不要混用。）

架構

瀏覽器 → nginx:80（可選）
           ├─ /              → Vite :5173
           ├─ /api/          → gateway :8888
           └─ /haixun-assets/→ MinIO :9000

宿主：gateway + vite
Docker：mongo / redis / minio / mailpit（只綁 127.0.0.1）

快速開始（全部清乾淨重裝）

cd /path/to/thread-master

# 1) env（首次）
cp deploy/.env.example deploy/.env.dev
# 編輯密鑰：MONGO_ROOT_PASSWORD、REDIS_PASSWORD、MINIO_ROOT_PASSWORD、JWT…
# 並同步 MONGO_URI / MONGO_URL / HAIXUN_STORAGE_S3_SECRET_KEY 內的密碼

# 2) 一鍵：清資料 + infra + migrate + build + start
./deploy/scripts/redeploy.sh --yes --kill-orphan

# 3)（建議）nginx 轉發 — 需要 sudo
./deploy/scripts/install-nginx.sh

只重裝 app、保留資料庫：

./deploy/scripts/redeploy.sh --yes --keep-data

指令一覽

腳本	說明
`scripts/redeploy.sh --yes`	完整重部署（預設刪 volume）
`scripts/wipe.sh --yes`	停 app + 刪 infra volumes
`scripts/up-infra.sh`	起 Mongo/Redis/MinIO/Mailpit
`scripts/migrate.sh`	`golang-migrate` up + seed
`scripts/build.sh`	編譯 gateway、確保 web 依賴
`scripts/start.sh`	背景啟動 gateway + vite
`scripts/stop.sh`	停 gateway + vite
`scripts/status.sh`	埠／健康檢查
`scripts/install-nginx.sh`	安裝 `deploy/nginx/haixun-dev.conf`

或用 Makefile：

make -C deploy env          # 從 example 複製 .env.dev（若不存在）
make -C deploy redeploy     # = redeploy.sh --yes --kill-orphan
make -C deploy status
make -C deploy stop

環境變數

範本：deploy/.env.example
實檔：deploy/.env.dev（勿 commit，已在 .gitignore）
亦可 ENV_FILE=/path/to/env ./deploy/scripts/start.sh

重要鍵：

鍵	用途
`MONGO_URI` / `MONGO_URL`	gateway / migrate（URL 需含 DB 名）
`REDIS_PASSWORD`	monc 快取
`HAIXUN_STORAGE_S3_*`	MinIO 上傳與 `PublicBaseURL`
`AUTH_` / `HAIXUN_JWT_`	JWT
`PUBLIC_WEB_BASE`	重設信連結、郵件 logo

Seed 管理員

migration 000003_seed_admin：

欄位	值
Email	`admin@30cm.net`（以 seed JSON 為準）
密碼	`admin123`（seed 註解；若登入失敗見下方）
uid	`1000000`

密碼政策若為 ≥12 碼，seed 舊密可能無法當「新密碼」使用，但 登入仍可比對 hash。
若無法登入：用 register 開新帳或改 seed 後 wipe 再 migrate。

前端：設定 → 資料來源 → Live。

埠與 URL

服務	位址
Web	http://127.0.0.1:5173
API	http://127.0.0.1:8888/api/v1/ping
Mailpit	http://127.0.0.1:8025
MinIO Console	http://127.0.0.1:9001（ROOT user/pass）
公開（CF/nginx）	https://threads-tool-dev.30cm.net

頭像公開路徑：{HAIXUN_STORAGE_S3_PUBLIC_BASE_URL}/avatar/{uid}/{uuid}.jpg
未裝 nginx 時，Vite 已 proxy /haixun-assets → MinIO。

日誌與 PID

deploy/run/gateway.log
deploy/run/web.log
deploy/run/gateway.pid
deploy/run/web.pid

注意

wipe / redeploy 預設刪 Mongo・Redis・MinIO 全部資料，務必 --yes。
docker 權限：使用者需在 docker 群組，或用 root。
migrate 首次會 go install -tags mongodb …。
舊系統 worker（old/）不會自動起；--kill-orphan 可清殘留 process。
正式 prod 映像部署仍可參考 old/deploy/；本目錄以 原生 binary + compose infra 為主。

3.7 KiB Raw Blame History Unescape Escape