#!/usr/bin/env bash # ssw-platform 一键脚本(后端二进制 = `sspf-admin` 默认装配) # # 后端 = Rust 单二进制(cargo workspace 根 = 仓库根 ⇒ target/ 在仓库根)。 # 数据库为嵌入式 pglite-rs(进程内原生 PostgreSQL),零服务 / 零 Docker / 零 WASM。 # # 用法: # ./run.sh install 安装依赖(cargo fetch + npm install) # ./run.sh build 构建(cargo build --release + vite build) # ./run.sh dev 后台起后端(30010) + 前端(5173),日志进 .logs/,PID 写入 .run/ # (**后端与前端都就绪**才算成功;任一没就绪 ⇒ 退出码 1) # ./run.sh backend 前台起后端 # ./run.sh frontend 前台起前端 # ./run.sh stop 用 PID 文件停后台进程 + 兜底 kill_ports # ./run.sh logs tail .logs/{backend,frontend}.log # ./run.sh --help 本用法 # # 退出码:0 成功 / 1 运行期失败 / 2 用法错 set -euo pipefail ROOT="$(cd "$(dirname "$0")" && pwd)" LOGS="$ROOT/.logs" RUN="$ROOT/.run" # 后端端口:兄弟项目 tdc-rs 已占用它自己的后端端口,本仓一律用 30010。 # 前端 vite 端口固定 5173(vite.config.ts 里 strictPort: true)。 BACKEND_PORT=30010 FRONTEND_PORT=5173 # 🔴 kill_ports 用的是 kill -9 ⇒ 端口列表**只能是本仓自己的这两个端口**。 # 不许把兄弟项目 tdc-rs 的端口写进来(打死它就是破坏兄弟项目)。 BACKEND_BIN="$ROOT/target/release/sspf-admin" # 加载项目根 .env(后端不 import dotenv,靠这里把 PORT / PGLITE_DIR 导出给子进程) if [ -f "$ROOT/.env" ]; then set -a; . "$ROOT/.env"; set +a fi export PORT="${PORT:-30010}" # 🔴 **端口守卫**:只在**真会启动后端**的子命令(`dev` / `backend`)里生效。 # 理由:守卫存在的唯一理由是「后端子进程会继承 `PORT` 并真的绑那个端口」。 # `frontend` / `stop` / `install` / `build` / `logs` / `--help` / 无参**根本不碰端口** # ⇒ 不该因为环境里恰好有个 `PORT` 就失败(那是误伤)。 # 🔴 本仓端口是硬约定:后端固定 30010、前端固定 5173。 # (不是「改成用 $PORT 清端口」——那会让 kill_ports 去杀**任意端口**上的进程。) guard_port() { if [ "${PORT}" != "${BACKEND_PORT}" ]; then echo "[用法错] PORT=${PORT} 与本仓硬约定的后端端口 ${BACKEND_PORT} 不一致。" echo " 本仓端口是硬约定(兄弟项目已占用它自己的端口,两套服务必须彻底分开)。" echo " 要用别的端口请直接跑二进制:PORT=${PORT} ${BACKEND_BIN}" exit 2 fi } usage() { cat <<'EOF' 用法: ./run.sh <子命令> install 安装依赖(cargo fetch + npm install) build 构建(cargo build --release + vite build) dev 后台起后端(30010) + 前端(5173);**后端与前端都就绪**才算成功 backend 前台起后端 frontend 前台起前端 stop 停止后台进程 logs 打印后端/前端日志尾部 --help 本用法 退出码: 0 成功 / 1 运行期失败 / 2 用法错 端口: 后端固定 30010、前端固定 5173(硬约定;PORT 改成别的值 ⇒ dev/backend 退出码 2) EOF } # 端口守护:dev/start 前清掉残留进程,避免 EADDRINUSE 被静默吞掉(旧进程仍占端口, # 新进程崩溃但请求全部打到旧实例 → 看起来「改了 seed 但菜单不变」之类的灵异 bug)。 kill_ports() { local killed=0 for p in "$@"; do local pids pids="$(lsof -ti:"$p" 2>/dev/null || true)" if [ -n "$pids" ]; then echo " ↳ 端口 $p 被旧进程占用 (PID: $pids),清理中…" # shellcheck disable=SC2086 kill -9 $pids 2>/dev/null || true killed=1 fi done # 注意 set -e:端口空闲时 [ ] 返回 1 会炸掉调用方(dev 走不到 start_logged) [ "$killed" -eq 1 ] && sleep 1 return 0 } # 🔴 **就绪轮询**:起完进程不等于服务可用。 # 旧版 dev 起完就打印「服务已在后台启动」并 exit 0 ⇒ 后端起不来(数据库路径写错等) # 时**脚本报成功、实际没有服务** ⇒ 极难定位。 # ⇒ 轮询 /api/health(routes.rs 里真有的探活端点),最长 30 秒。 # 本机 curl 走系统代理 ⇒ 必须带 --noproxy '*'。 wait_backend_ready() { local i for i in $(seq 1 30); do if curl --noproxy '*' -fsS -m 2 "http://127.0.0.1:${BACKEND_PORT}/api/health" >/dev/null 2>&1; then return 0 fi sleep 1 done return 1 } # 🔴 **就绪轮询(前端)**:与 wait_backend_ready 同形,轮 vite 的根路径。 # 超时 60 秒(比后端长):vite 首次启动要做依赖预打包,冷启动可能十几秒。 # 没有它 ⇒ 前端 vite 起不来(依赖没装 / 端口被占 / npm run dev 立刻报错退出)时, # 脚本照样打印「服务已在后台启动」⇒ **脚本报成功、实际没有前端**。 # 本机 curl 走系统代理 ⇒ 必须带 --noproxy '*'。 wait_frontend_ready() { local i for i in $(seq 1 60); do if curl --noproxy '*' -fsS -m 2 "http://127.0.0.1:${FRONTEND_PORT}/" >/dev/null 2>&1; then return 0 fi sleep 1 done return 1 } # 用 PID 文件优雅停(先 SIGTERM,宽限期内还在才 SIGKILL),清理 root 进程树 # 🔴 宽限期**可按进程给**:后端的优雅停机要「关嵌入式 PostgreSQL」(crates/sspf-admin/src/main.rs 给 PG 的预算是 3 秒), # 若这里只等 1 秒就 SIGKILL ⇒ 正好把 M-9 要修的「PG 被 SIGKILL 打断 ⇒ crash recovery」又打回来。 # ⇒ 后端给 3 秒(与 crates/sspf-admin/src/main.rs 的预算对齐);前端(npm/vite)1 秒足够。 stop_pid() { local f="$1" grace="${2:-1}" [ -f "$f" ] || return 0 local pid pid="$(cat "$f" 2>/dev/null || true)" if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then echo " ↳ stop $(basename "$f") PID=$pid SIGTERM(宽限 ${grace}s)" kill -TERM "$pid" 2>/dev/null || true # 进程**提前退出就立刻收工**(不空等满宽限期)⇒ 0.2s 一跳地轮询存活。 # (后端实测 ~200ms 就退 ⇒ 不该为此白等 3 秒。) local waited=0 total=$((grace * 5)) while [ "$waited" -lt "$total" ] && kill -0 "$pid" 2>/dev/null; do sleep 0.2 waited=$((waited + 1)) done kill -0 "$pid" 2>/dev/null && kill -KILL "$pid" 2>/dev/null || true fi rm -f "$f" } # 用 nohup 后台起,stdout/stderr 都进日志;写 PID 便于 ./run.sh stop 精准收 start_logged() { local dir="$1" cmd="$2" name="$3" mkdir -p "$LOGS" : > "$LOGS/${name}.log" ( cd "$ROOT/$dir" || exit 1 # nohup + & 把子进程从父进程会话脱离,CI/harness 退出不会拖垮服务; # setsid 让子进程成为新进程组领头,避免父 SIGINT 误杀。 # macOS 无 setsid(Linux util-linux 专有),探测后回退纯 nohup。 if command -v setsid >/dev/null 2>&1; then setsid nohup $cmd > "$LOGS/${name}.log" 2>&1 & else nohup $cmd > "$LOGS/${name}.log" 2>&1 & fi echo $! > "$RUN/${name}.pid" ) echo " ↳ $name PID=$(cat "$RUN/${name}.pid") log=$LOGS/${name}.log" } case "${1:-}" in -h|--help|help) usage ;; install) (cd "$ROOT" && cargo fetch) npm --prefix "$ROOT/src/frontend" install ;; build) (cd "$ROOT" && cargo build --release) npm --prefix "$ROOT/src/frontend" run build ;; dev) # 🔴 守卫与二进制检查**都在** kill_ports **之前** —— # 否则「用法错 / 二进制缺失」会先把 30010/5173 上的进程 kill -9 了(失败却先破坏现场)。 guard_port if [ ! -x "$BACKEND_BIN" ]; then echo "[启动失败] 后端二进制不存在: $BACKEND_BIN" echo " 先跑「./run.sh build」(cargo build --release)。" exit 1 fi kill_ports "$BACKEND_PORT" "$FRONTEND_PORT" mkdir -p "$LOGS" "$RUN" # 🔴 后端 cwd = 仓库根(dir=".")⇒ 相对路径的 PGLITE_DIR 也落在仓库内。 # 🔴 命令行**不带** PORT= 前缀 —— PORT 已由 .env / export 导出,子进程继承。 start_logged . "./target/release/sspf-admin" backend start_logged src/frontend "npm run dev" frontend # 🔴 就绪校验:后端没真正起来 ⇒ **不许**报成功。 if ! wait_backend_ready; then echo echo "[启动失败] 后端在 30 秒内没就绪(/api/health 不通)。" # 🔴 本次刚起的前端**一并收掉** —— 不许把一个 vite dev server 残在后台占着 5173 # (用户看到「启动失败」,机器上却留着一个前端 dev server,极难联想到是同一次启动留下的)。 # **两条都做**:`stop_pid` 走 PID 文件(SIGTERM → 1s → SIGKILL), # `kill_ports` 按端口 kill -9 **兜底** —— # 因为 `stop_pid` 依赖 npm 把 SIGTERM 转发给 vite(npm 的内部实现细节,**不是保证**), # 有了 `kill_ports` 兜底 ⇒「不会在 5173 上留残进程」**无条件**成立。 # **不用** pkill(模式太宽会误杀别的项目)。 stop_pid "$RUN/frontend.pid" kill_ports "$FRONTEND_PORT" echo " ↳ 本次刚起的前端进程已一并收掉(PID 文件 SIGTERM → SIGKILL + 按端口 kill -9 兜底)" echo "--- .logs/backend.log 尾部 ---" tail -n 20 "$LOGS/backend.log" 2>/dev/null || true exit 1 fi # 🔴 就绪校验(前端):vite 起不来时同样**不许**报成功。 if ! wait_frontend_ready; then echo echo "[启动失败] 前端在 60 秒内没就绪(http://127.0.0.1:${FRONTEND_PORT}/ 不通)。" # 🔴 同上:PID 文件 + 按端口兜底,两条都做 ⇒ 不在 5173 上留残进程。 stop_pid "$RUN/frontend.pid" kill_ports "$FRONTEND_PORT" echo " ↳ 本次刚起的前端进程已一并收掉(PID 文件 SIGTERM → SIGKILL + 按端口 kill -9 兜底)" # 🔴 本仓既定裁决:dev 失败**不收后端**(后端可能只是慢;下一次 dev/stop 的 # kill_ports ${BACKEND_PORT} 会自愈)⇒ 但必须把后端的去留**说清楚**。 echo " ↳ 后端仍在 ${BACKEND_PORT} 上运行,要停请执行「./run.sh stop」" echo "--- .logs/frontend.log 尾部 ---" tail -n 20 "$LOGS/frontend.log" 2>/dev/null || true exit 1 fi echo echo "服务已在后台启动(后端与前端**都已就绪**)。后端: http://127.0.0.1:${BACKEND_PORT} 前端: http://127.0.0.1:${FRONTEND_PORT}" echo "日志:tail -f $LOGS/{backend,frontend}.log" echo "停止:./run.sh stop" ;; backend) # 🔴 守卫在 kill_ports 之前(同 dev:失败却先破坏现场是不对的)。 guard_port if [ ! -x "$BACKEND_BIN" ]; then echo "[启动失败] 后端二进制不存在: $BACKEND_BIN" echo " 先跑「./run.sh build」(cargo build --release)。" exit 1 fi kill_ports "$BACKEND_PORT" # 🔴 用 exec ⇒ 后端**自己的**退出码原样透传(本仓二进制 panic 时是 101,不是 1)。 (cd "$ROOT" && exec ./target/release/sspf-admin) ;; frontend) kill_ports "$FRONTEND_PORT" npm --prefix "$ROOT/src/frontend" run dev ;; stop) mkdir -p "$LOGS" "$RUN" # 🔴 **实际的停止路径 = PID 文件(SIGTERM→SIGKILL)+ kill_ports(按端口 kill -9)**。 # pkill 只作为最后一道兜底,且**模式必须精确**: # macOS/BSD 的 `pkill -f` 匹配的是**完整命令行**(argv 全部拼接), # 宽模式(如按进程名)会连「命令行里提到本仓名字」的无关进程一起杀掉 # (本脚本自己、harness 的监督 shell、tail -f 日志、别的项目的 vite)。 stop_pid "$RUN/backend.pid" 3 stop_pid "$RUN/frontend.pid" kill_ports "$BACKEND_PORT" "$FRONTEND_PORT" # 只匹配后端本体的完整路径(cargo/rustc 的 argv 里是目录名与下划线形式,都不匹配)。 # 🔴 vite **不**用 pkill 收 —— 它由上面的 kill_ports 5173 按**端口**收, # 不会误杀别的项目的 vite dev server。 pkill -f "target/release/sspf-admin" 2>/dev/null || true # 🔴 旧名兜底:名称历经 `tds-lite-rs` → `ssw-jnpf-lite-rust` → `ssw-platform` # → **`sspf-admin`**(2026-11-04 默认装配独立成 crate,bin 名随之改), # 改名之前起的后端进程不会被上一行 pkill 匹配到 ⇒ 这里补收一次。 pkill -f "target/release/ssw-platform" 2>/dev/null || true pkill -f "target/release/tds-lite-rs" 2>/dev/null || true echo "stopped" ;; logs) mkdir -p "$LOGS" "$RUN" # 🔴 补 || true:日志文件不存在时 [ -f ] 返回 1,set -e 下会让脚本以 1 退出。 { [ -f "$LOGS/backend.log" ] && echo "=== backend ===" && tail -n 50 "$LOGS/backend.log"; } || true { [ -f "$LOGS/frontend.log" ] && echo "=== frontend ===" && tail -n 50 "$LOGS/frontend.log"; } || true ;; *) usage exit 2 ;; esac