nex_animation/scripts/server.sh

453 lines
24 KiB
Bash
Executable File
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

#!/usr/bin/env bash
# ============================================================
# Nex Animation Studio · 服务器部署与运行(单机生产模式)
#
# ./scripts/server.sh install 装依赖 → 构建前端 → 建表 → 体检并导入模型配置与管理员
# ./scripts/server.sh build 只重新构建前端(改了页面时用)
# ./scripts/server.sh start 启动(前端产物由后端一并托管,单进程)
# ./scripts/server.sh stop 停止
# ./scripts/server.sh restart 重启
# ./scripts/server.sh status 端口 / 健康 / 默认模型 / ComfyUI / 数据边界
# ./scripts/server.sh verify 打真实 HTTP 跑一遍 12 节点全流程自检
# ./scripts/server.sh logs 跟踪日志
# ./scripts/server.sh systemd 打印 systemd 单元(交给 root 安装)
#
# 选项:--port N --host ADDR --no-asr --skip-deps --skip-build --db URL
# install 专用:--only-missing(模型配置只补缺)、--allow-drift(体检不过也硬装)
#
# 与 scripts/dev.sh 的分工:dev.sh 面向开发(Vite 热更新 + uvicorn --reload),
# server.sh 面向部署(构建产物 + 不重载 + 首装数据)。两者共用 .local/run 与
# .local/logs,但 pid 名不同(server vs backend/frontend),可以并存,只要端口错开。
#
# 四个必须写在这里的为什么:
# 1) 只起一个 uvicorn 进程,绝不加 --workers。TASK_EXECUTOR=inline 时调度守护线程
# 跑在进程内,多 worker 就是 N 份守护线程同时抢同一批任务、重复派发;
# 要横向扩展请切 TASK_EXECUTOR=celery 并另起 worker
# (容器形态见 docker-compose.scale.yml,裸机形态见 README §3.2 末尾的 celery 命令)。
# 2) 前端产物由后端托管(SERVE_FRONTEND=on),所以对外只有一个端口,
# 反向代理只需转发一处,/api、/media、/docs 与页面同源,不再有 CORS 与代理漂移。
# 3) 首装顺序是「建表 + 灌数据 → 再启动服务」。先启动也能跑,但应用首启会自己
# 生成一把模型主密钥、把 mock 播成默认,导入时就得再纠正一次默认位。
# 4) 灌数据之前先体检。部署包里的 scripts/seed/*.json 是某天的快照,代码是活水:
# 快照落后时代码新增的能力位(例如 IndexTTS2 的 voice_instruct)不会报错,
# 只会让功能在页面上凭空消失。`seed.py install` 因此先跑 doctor 再写库,
# 不过就停住——install 一旦跑过就改掉了表结构与默认位,回不到原样。
# ============================================================
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
RUN_DIR="$ROOT/.local/run"
LOG_DIR="$ROOT/.local/logs"
PYBIN="$ROOT/.venv/bin/python"
NAME=server
env_value() { # 从仓库根 .env 读一个键(最后一行为准;去引号、去随行注释、去尾部空白)
[ -f "$ROOT/.env" ] || return 0
sed -n "s/^[[:space:]]*$1=//p" "$ROOT/.env" | tail -1 \
| sed -E 's/[[:space:]]+#.*$//; s/[[:space:]]+$//' | tr -d '\r"'"'"'' || true
}
HOST="${NEX_HOST:-0.0.0.0}"
# 部署形态的对外端口只有一个键:HOST_PORT(Docker 的端口映射、裸机监听的都读它)。
# 开发态的 BACKEND_PORT / FRONTEND_PORT 是另一码事,别混用(见 .env.example 的端口一节)。
# 取值优先级:命令行 --port > 环境变量 HOST_PORT/PORT > .env 的 HOST_PORT > 8000。
# 回读 .env 是有意的:.env 是运维唯一被要求编辑的文件,写进去的键必须真的生效,
# 否则表现就是「.env 明明改了 9000,服务还在 8000」。
PORT="${HOST_PORT:-${PORT:-$(env_value HOST_PORT)}}"
PORT="${PORT:-$(env_value PORT)}" # 旧键兼容:上一版模板这里叫 PORT
PORT="${PORT:-8000}"
ASR_MODEL="$ROOT/models/asr/ggml-small.bin"
# ---- 依赖下载源:默认国内源,优先级 环境变量 > .env > 内置默认 ----
# 裸机 install 也要装 pip/npm 依赖,不配国内源时首次 install 能卡十几分钟。
# 键名与 Dockerfile 的 --build-arg 完全一致,容器和裸机同一套口径。
PIP_INDEX="${PIP_INDEX_URL:-$(env_value PIP_INDEX_URL)}"
PIP_INDEX="${PIP_INDEX:-https://pypi.tuna.tsinghua.edu.cn/simple}"
NPM_REGISTRY="${NPM_REGISTRY:-$(env_value NPM_REGISTRY)}"
NPM_REGISTRY="${NPM_REGISTRY:-https://registry.npmmirror.com}"
# 听写权重 465MB:huggingface.co 国内实测连接直接被重置(curl 0.04s 返回 000),
# 默认走 hf-mirror.com;境外机器传 ASR_DOWNLOAD_URL 换回官方地址。
ASR_URL="${ASR_DOWNLOAD_URL:-$(env_value ASR_DOWNLOAD_URL)}"
ASR_URL="${ASR_URL:-https://hf-mirror.com/ggerganov/whisper.cpp/resolve/main/ggml-small.bin}"
WANT_ASR=1
SKIP_DEPS=0
SKIP_BUILD=0
SEED_ONLY_MISSING=0 # install:模型配置只补缺,不动服务器上已调好的同名模型
SEED_ALLOW_DRIFT=0 # install:数据体检报 error 也继续装(逃生门,默认关)
EXPLICIT_DB="${DATABASE_URL:-}"
if [ -t 1 ]; then C_G=$'\033[32m'; C_Y=$'\033[33m'; C_R=$'\033[31m'; C_B=$'\033[36m'; C_D=$'\033[2m'; C_0=$'\033[0m'
else C_G=""; C_Y=""; C_R=""; C_B=""; C_D=""; C_0=""; fi
ok() { printf ' %sok%s %s\n' "$C_G" "$C_0" "$*"; }
info() { printf ' %s\n' "$*"; }
warn() { printf ' %s!%s %s\n' "$C_Y" "$C_0" "$*"; }
die() { printf ' %sXX%s %s\n' "$C_R" "$C_0" "$*" >&2; exit 1; }
head2() { printf '\n%s%s%s\n' "$C_B" "$*" "$C_0"; }
pid_of() { [ -f "$RUN_DIR/$NAME.pid" ] && cat "$RUN_DIR/$NAME.pid" 2>/dev/null || true; }
alive() { local p="${1:-}"; [ -n "$p" ] && kill -0 "$p" 2>/dev/null; }
port_pids() { lsof -nP -iTCP:"$1" -sTCP:LISTEN -t 2>/dev/null | tr '\n' ' ' | sed 's/[[:space:]]*$//' || true; }
# 独立会话里起进程(同 dev.sh:`cmd &` 会被启动它的终端一起带走,SSH 断开即挂)
spawn() {
mkdir -p "$RUN_DIR" "$LOG_DIR"
local pid
pid="$("$PYBIN" - "$LOG_DIR/$NAME.log" "$ROOT" "$@" <<'PY'
import subprocess, sys
log_path, cwd, cmd = sys.argv[1], sys.argv[2], sys.argv[3:]
log = open(log_path, "ab", buffering=0)
print(subprocess.Popen(cmd, stdin=subprocess.DEVNULL, stdout=log, stderr=log,
cwd=cwd, start_new_session=True, close_fds=True).pid)
PY
)"
printf '%s\n' "$pid" > "$RUN_DIR/$NAME.pid"
printf '%s\n' "$pid"
}
wait_http() { local url="$1" limit="${2:-120}" i=0
while [ "$i" -lt "$limit" ]; do
curl -fsS --max-time 2 -o /dev/null "$url" 2>/dev/null && return 0
sleep 1; i=$((i + 1))
done; return 1; }
# ------------------------------------------------------------------ install
install_backend_deps() {
head2 "后端依赖"
command -v python3 >/dev/null || die "缺少 python3(需要 3.11+)"
if [ ! -x "$PYBIN" ]; then
info "创建虚拟环境并安装依赖(首次 1~2 分钟)…"
python3 -m venv "$ROOT/.venv" || die "venv 创建失败(Debian/Ubuntu 需 apt install python3-venv)"
"$PYBIN" -m pip install -q -i "$PIP_INDEX" --upgrade pip
fi
# 3.11+ 是硬门槛:Debian 12 自带的 python3 是 3.11(够用),但更老发行版的 3.9
# 会在 import 阶段就炸在 `str | None` 上。与其让服务起不来,不如装依赖时先说清楚。
"$PYBIN" -c 'import sys; sys.exit(0 if sys.version_info >= (3, 11) else 1)' \
|| die "Python 版本过低($("$PYBIN" -V 2>&1)),本项目需要 3.11+,请装更新的 python3"
"$PYBIN" -m pip install -q -i "$PIP_INDEX" -r "$ROOT/backend/requirements.txt" \
|| die "后端依赖安装失败(换源:PIP_INDEX_URL=https://… $0 install)"
ok "$("$PYBIN" -V 2>&1) · fastapi/uvicorn/sqlalchemy 就绪(pip 源 ${PIP_INDEX})"
if command -v ffmpeg >/dev/null && command -v ffprobe >/dev/null; then
ok "ffmpeg 就绪(合成、质检可用)"
else
warn "未找到 ffmpeg/ffprobe:合成与质检会失败(apt install ffmpeg / brew install ffmpeg)"
fi
# 中文字形:libass 找不到字形不报错,只会把字幕画成一片豆腐块,
# 所以宁可现在 warn 一句,也别等出片了才发现(探测复用 app/services/ffmpeg.py 的同一段逻辑)。
if command -v ffmpeg >/dev/null && ! NEX_BACKEND_DIR="$ROOT/backend" "$PYBIN" - <<'PY' 2>/dev/null
import os, sys
sys.path.insert(0, os.environ["NEX_BACKEND_DIR"])
from app.services.ffmpeg import cjk_font_catalog
sys.exit(0 if cjk_font_catalog() else 1)
PY
then
warn "没找到含中文字形的字体:烧字幕会出豆腐块(Debian/Ubuntu: apt install fontconfig fonts-noto-cjk)"
fi
}
build_frontend() {
head2 "前端构建"
command -v npm >/dev/null || die "缺少 npm(Node 18+)"
(cd "$ROOT/frontend" && { [ -d node_modules ] || npm ci --registry "$NPM_REGISTRY" --no-audit --no-fund; } && npm run build) \
> "$LOG_DIR/build.log" 2>&1 || { tail -30 "$LOG_DIR/build.log"; die "前端构建失败,详见 .local/logs/build.log"; }
[ -f "$ROOT/frontend/dist/index.html" ] || die "构建结束但没有 frontend/dist/index.html"
ok "frontend/dist 就绪($(du -sh "$ROOT/frontend/dist" | cut -f1),$(find "$ROOT/frontend/dist" -type f | wc -l | tr -d ' ') 个文件)"
}
fetch_asr_model() {
head2 "台词听写模型(whisper.cpp)"
if [ ! -x "$(command -v whisper-cli || true)" ] && [ ! -x "$(command -v whisper || true)" ]; then
warn "未安装 whisper-cli:台词听写质检(prompt_leak)不生效,其余功能不受影响"
info " macOS: brew install whisper-cpp Debian/Ubuntu: 从源码构建 https://github.com/ggml-org/whisper.cpp"
return 0
fi
if [ -f "$ASR_MODEL" ]; then ok "已存在 $(basename "$ASR_MODEL")($(du -sh "$ASR_MODEL" | cut -f1))"; return 0; fi
[ "$WANT_ASR" = 1 ] || { info "按 --no-asr 跳过(台词听写质检需要它)"; return 0; }
info "下载 ggml-small.bin(约 465MB,只下一次)…"
mkdir -p "$(dirname "$ASR_MODEL")"
curl -fL --retry 3 -o "$ASR_MODEL.tmp" "$ASR_URL" || die "下载失败:$ASR_URL"
mv "$ASR_MODEL.tmp" "$ASR_MODEL"
ok "$ASR_MODEL"
}
seed_data() {
head2 "表结构与初始数据"
if [ ! -d "$ROOT/scripts/seed" ]; then
# 从 git 克隆(而不是从部署包解压)时没有这个目录:不是错误,
# 应用首启会自己建表、播 mock、建 admin/admin1234,只是要在模型管理中心重配一遍。
warn "没有 scripts/seed/:跳过数据导入,服务器将用 mock 模型 + admin/admin1234 起步"
return 0
fi
# 体检不在这层重复实现:seed.py install 自己会先量包(列 / 适配器 / 能力位 /
# 默认位 / 主密钥能否解开包里的密文),量不过就不写库,这里只透传两个开关。
# --only-missing:只补库里没有的模型,不覆盖这台机器上已经调好的端点与参数
# (场景:同一台服务器换新包,想带上开发机新增的模型);
# --allow-drift :体检报 error 也照装,给「服务器代码比数据集新、但确认无碍」留门。
local -a seed_args=()
[ "$SEED_ONLY_MISSING" = 1 ] && seed_args+=(--only-missing)
[ "$SEED_ALLOW_DRIFT" = 1 ] && seed_args+=(--allow-drift)
"$PYBIN" "$ROOT/scripts/seed.py" install ${seed_args[@]+"${seed_args[@]}"} \
|| die "导入模型配置与管理员失败(多半是体检没过:上面每条 error 都写了怎么修)"
info "${C_D}数据边界:表结构 + 模型配置 + 管理员。项目/镜头/媒体不在部署包里,服务器从空库开始。${C_0}"
"$PYBIN" "$ROOT/scripts/seed.py" boundary || true
}
# 单机 .env:不能直接 cp .env.example —— 那份模板默认给的是 Postgres + Redis +
# TASK_EXECUTOR=celery(只有 docker-compose.scale.yml 那套才有 db/redis),照抄到一台
# 裸机上会因为连不上 db 而起不来;server.sh 承诺的是「一台机器一条命令跑起来」,
# 所以写 SQLite + inline —— 和 docker-compose.yml 的默认单容器形态是同一份配置。
ensure_env() {
[ -f "$ROOT/.env" ] && { ok ".env 就绪"; return 0; }
cat > "$ROOT/.env" <<'ENV'
# Nex Animation Studio · 单机部署配置(由 scripts/server.sh install 生成)
# 改完重启生效:./scripts/server.sh restart
# 模型配置不在这里:库里的配置,页面上在左侧栏「模型管理中心」改,改完即生效,不用重启服务。
# ---- 端口:对外暴露的端口(restart 后生效)----
HOST_PORT=8000
# ---- 存储:单机用 SQLite,媒体落 ./media ----
DATABASE_URL=sqlite:///./nex_animation.db
MEDIA_ROOT=./media
# ---- 执行后端:inline = 进程内线程池,不需要 Redis ----
# 想横向扩展(多 GPU、多机)再切 celery,并另起 worker/beat,见 docker-compose.scale.yml。
TASK_EXECUTOR=inline
# ---- 对外 ----
# 由后端一并托管前端产物:浏览器只访问一个端口。
SERVE_FRONTEND=on
AUTH_ENABLED=true
LOG_LEVEL=INFO
# ---- 本地听写权重(whisper.cpp 的文件路径,install 时下载)----
ASR_MODEL=models/asr/ggml-small.bin
ENV
warn "已生成单机版 .env(SQLite + inline + 托管前端);模型配置在数据库里,页面「模型管理中心」可改"
}
do_install() {
printf 'Nex Animation Studio · 服务器部署安装(cwd=%s)\n' "$ROOT"
head2 "配置"
ensure_env
[ "$SKIP_DEPS" = 1 ] || install_backend_deps
[ "$SKIP_BUILD" = 1 ] || build_frontend
fetch_asr_model
seed_data
head2 "下一步"
info "1) 编辑 .env:只有 DATABASE_URL / MEDIA_ROOT / AUTH_ENABLED 这类进程参数——模型地址不在这里"
info " (模型配置已在导入时随包带过来:$(ls "$ROOT/scripts/seed" 2>/dev/null | tr '\n' ' '))"
info " 换 GPU 机 / 改模型参数:登录后进左侧栏「模型管理中心」改 base_url 并点 🔌 探测"
info "2) ./scripts/server.sh start"
info "3) 浏览器打开 $BASE,用部署包里的管理员登录,随后立刻改密码"
info "4) ./scripts/server.sh verify # 用 mock/真实模型跑一遍全流程自检"
}
# ------------------------------------------------------------------ 运行
start_server() {
head2 "启动 :$PORT"
local pid busy
pid="$(pid_of)"
if alive "$pid"; then ok "已在运行 pid=$pid(跳过启动)"; return 0; fi
busy="$(port_pids "$PORT")"
[ -z "$busy" ] || die "端口 $PORT 被进程 $busy 占用;先 ./scripts/server.sh stop 或 --port 换端口"
[ -x "$PYBIN" ] || die "缺少 .venv:先 ./scripts/server.sh install"
[ -f "$ROOT/frontend/dist/index.html" ] || warn "没有 frontend/dist:本次只提供 API,页面请跑 ./scripts/server.sh build"
# SERVE_FRONTEND=on:由后端托管构建产物(见 backend/app/main.py 的 SPA 挂载)。
# --app-dir 从仓库根启动,.env / media / SQLite 相对路径全部锚定仓库根。
local cmd=(env SERVE_FRONTEND=on "$PYBIN" -m uvicorn app.main:app --app-dir "$ROOT/backend"
--host "$HOST" --port "$PORT")
pid="$(spawn "${cmd[@]}")"
if wait_http "$BASE/health" 120; then
ok "健康检查通过 pid=$pid"
else
tail -30 "$LOG_DIR/$NAME.log" 2>/dev/null || true
die "启动失败(120s 内 /health 未就绪)"
fi
if curl -fsS --max-time 3 -o /dev/null "$BASE/" 2>/dev/null; then
ok "页面 $BASE/"
else
warn "$BASE/ 未返回页面:确认已构建前端且 .env 没把 SERVE_FRONTEND 关掉"
fi
# 深链回落:React Router 用 browser history,/projects/1 在磁盘上没有对应文件,
# 必须回 index.html。这条挂了 = 用户刷新一次页面就 404(见 backend/app/main.py:spa_target)。
if curl -fsS --max-time 3 -o /dev/null "$BASE/projects/1" 2>/dev/null; then
ok "深链回落 $BASE/projects/1(history 模式正常)"
else
warn "$BASE/projects/1 没有回落页面:刷新深链会 404,检查 SERVE_FRONTEND 与 frontend/dist"
fi
# 不存在的接口必须是 JSON 404,不能被 SPA 壳伪装成 200 + HTML(前端会把 HTML 当 JSON 解析)
code="$(curl -s -o /dev/null -w '%{http_code}' --max-time 3 "$BASE/api/__spa_probe__" 2>/dev/null || echo 000)"
[ "$code" = "404" ] && ok "未知接口返回 404(未被 SPA 壳吞掉)" \
|| warn "$BASE/api/__spa_probe__ 返回 $code,期望 404:SPA catch-all 可能吞掉了 API 路径"
head2 "已启动"
info "${C_B}平台${C_0} $BASE/"
info "${C_B}接口${C_0} $BASE/docs"
local lan
lan="$( { iface="$(route -n get default 2>/dev/null | awk '/^[[:space:]]*interface:/{print $2; exit}')"
[ -n "$iface" ] && ipconfig getifaddr "$iface" 2>/dev/null; } || true )"
[ -n "$lan" ] && info "${C_B}局域网${C_0} http://$lan:$PORT/"
info "${C_B}日志${C_0} .local/logs/$NAME.log ${C_D}跟踪:./scripts/server.sh logs${C_0}"
info "${C_B}停止${C_0} ./scripts/server.sh stop"
}
stop_server() {
local pid; pid="$(pid_of)"
alive "$pid" || { rm -f "$RUN_DIR/$NAME.pid"; info "未在运行"; return 0; }
# pid 就是会话组长:按进程组回收,uvicorn 派生的 ffmpeg / whisper 子进程才不会被留下
kill -TERM -- "-$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true
local i=0
while alive "$pid" && [ "$i" -lt 30 ]; do sleep 0.5; i=$((i + 1)); done
alive "$pid" && { kill -KILL -- "-$pid" 2>/dev/null || true; warn "已强制结束 pid=$pid"; }
rm -f "$RUN_DIR/$NAME.pid"
ok "已停止(pid=${pid})"
}
status_server() {
head2 "运行状态"
local pid; pid="$(pid_of)"
if alive "$pid"; then
printf ' %srunning%s server :%-6s pid=%s\n' "$C_G" "$C_0" "$PORT" "$pid"
elif [ -n "$(port_pids "$PORT")" ]; then
printf ' %sbusy%s server :%-6s 被本脚本之外的进程占用 (pid=%s)\n' \
"$C_Y" "$C_0" "$PORT" "$(port_pids "$PORT")"
else
printf ' %sstopped%s server :%s\n' "$C_D" "$C_0" "$PORT"
fi
[ -f "$ROOT/frontend/dist/index.html" ] && ok "前端产物 frontend/dist" || warn "前端产物缺失:./scripts/server.sh build"
[ -f "$ASR_MODEL" ] && ok "听写模型 $(basename "$ASR_MODEL")" || warn "听写模型缺失:台词听写质检不生效"
if curl -fsS --max-time 3 -o /dev/null "$BASE/health" 2>/dev/null; then
NEX_BASE="$BASE" "$PYBIN" <<'PY' || true
import os, sys, httpx
GREEN, YELLOW, DIM, RESET = (("\033[32m", "\033[33m", "\033[2m", "\033[0m")
if sys.stdout.isatty() else ("", "", "", ""))
base = os.environ["NEX_BASE"].rstrip("/")
# 部署形态默认 AUTH_ENABLED=true,/api/* 要会话;未登录时这里会退化成
# 「HTTP 401 读不到模型」,看不出来是配置没导入还是没登录,所以先登录再读。
# 模型端点也在这里探:地址存在 model_specs 表里(不在 .env),页面/数据库说是什么就是什么,
# 以前那种「curl .env 里的 COMFYUI_BASE_URL」现在会探到一个已经不用的旧地址。
c = httpx.Client(base_url=base, timeout=10, trust_env=False)
h = c.get("/health").json()
print(f" executor={h.get('executor')} database={h.get('database')} ffmpeg={h.get('ffmpeg')} "
f"model_specs={h.get('model_specs')} frontend={h.get('frontend')} auth={h.get('auth_enabled')}")
try:
st = c.get("/api/auth/state").json()
if st.get("auth_enabled") and not st.get("authenticated"):
r = c.post("/api/auth/login", json={
"username": os.environ.get("NEX_USER") or (st.get("login_hint") or {}).get("username") or "admin",
"password": os.environ.get("NEX_PASS") or "admin1234"})
if r.status_code != 200:
# 登录不进去多半是首登强制改密没走界面,这里只提示,不阻塞 status
print(f" 模型注册表跳过:登录失败 {r.status_code}(改 NEX_USER/NEX_PASS 后重试)")
sys.exit(0)
listing = c.get("/api/providers").json()
for p in listing["providers"]:
if p.get("is_default"):
print(f" [默认] {p['media_type']:6s} {p['provider']}/{p['model']} 可用={p.get('available')}")
# 端点连通性:把库里真实用到的地址逐个探一遍(自建 ComfyUI 探 /system_stats)。
# 同一台机器常常同时挂视频/图像/配音三条模型,去重后只探一次。
endpoints = {}
for p in listing["providers"]:
if not p.get("enabled"):
continue
url = str((p.get("config") or {}).get("base_url") or "").rstrip("/")
if url and not p.get("uses_mock"):
endpoints.setdefault(url, []).append(f"{p['provider']}/{p['model']}")
for url, users in sorted(endpoints.items()):
probe = f"{url}/system_stats" if "comfy" in url.lower() else url
try:
c.get(probe, timeout=4)
print(f" {GREEN}reachable{RESET} {url} ← {', '.join(sorted(users))}")
except Exception:
print(f" {YELLOW}unreachable{RESET} {url} ← {', '.join(sorted(users))}"
f" {DIM}(这几条模型真实出片会失败,页面点 🔌 探测看细节){RESET}")
except Exception as exc:
print(f" 模型注册表读取失败:{type(exc).__name__}: {exc}")
PY
else
info "${C_D}服务未启动:健康检查、默认模型与模型端点连通性都要等进程起来才能读(地址在库里)${C_0}"
fi
# 数据边界:这台机器上「部署包带来的」与「本机业务跑出来的」各多少行。
# 直接读库而不是打 HTTP——装完还没 start 时也需要知道导入了什么,
# 而且这一眼能回答部署后最常见的问题:「业务数据是不是被我覆盖掉了」。
head2 "数据边界"
"$PYBIN" "$ROOT/scripts/seed.py" boundary || warn "读不到库:先 ./scripts/server.sh install,或 --db 指对连接串"
}
verify_server() {
head2 "全流程自检(真实 HTTP + ffprobe 实测)"
wait_http "$BASE/health" 5 || die "$BASE 没有可用的后端"
NEX_BASE="$BASE" "$PYBIN" "$ROOT/scripts/e2e_selfcheck.py"
}
do_systemd() {
local unit user
user="${SUDO_USER:-$(id -un)}"
cat <<UNIT
# /etc/systemd/system/nex-animation.service
# 安装:sudo ./scripts/server.sh systemd > /etc/systemd/system/nex-animation.service
# sudo systemctl daemon-reload && sudo systemctl enable --now nex-animation
[Unit]
Description=Nex Animation Studio
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=$user
WorkingDirectory=$ROOT
EnvironmentFile=$ROOT/.env
# SERVE_FRONTEND 之类已在 .env 里;这里显式再写一次,防止有人把 .env 换成 compose 版
# 前端产物由后端托管,对外一个端口;inline 执行器把调度守护线程跑在进程内,
# 所以只能一个进程——加 --workers 会变成 N 份守护线程重复派发。
ExecStart=$ROOT/.venv/bin/python -m uvicorn app.main:app --app-dir $ROOT/backend --host 0.0.0.0 --port $PORT
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
UNIT
}
# 帮助 = 文件头那段注释。取范围靠「第一条 # === 到第二条 # ===」而不是写死行号:
# 上一版是 sed -n '3,30p',头注释每加一行就得回来挪一次数字,很容易忘(deploy.sh 同修)。
usage() { awk '/^# ={10,}/{n++; next} n==1{sub(/^# ?/, ""); print} n>1{exit}' "${BASH_SOURCE[0]}"; }
ACTION=start
while [ $# -gt 0 ]; do
case "$1" in
install|build|start|stop|restart|status|verify|logs|systemd) ACTION="$1" ;;
--port) PORT="${2:?--port 需要端口}"; shift ;;
--host) HOST="${2:?--host 需要地址}"; shift ;;
--db) DATABASE_URL="${2:?--db 需要连接串}"; export DATABASE_URL; shift ;;
--no-asr) WANT_ASR=0 ;;
--skip-deps) SKIP_DEPS=1 ;;
--skip-build) SKIP_BUILD=1 ;;
--only-missing) SEED_ONLY_MISSING=1 ;;
--allow-drift) SEED_ALLOW_DRIFT=1 ;;
-h|--help) usage; exit 0 ;;
*) die "未知参数:$1(./scripts/server.sh --help)" ;;
esac
shift
done
# BASE 必须在解析完参数之后再算:早先算在文件头,`server.sh start --port 8020`
# 会把服务起在 8020、却去健康检查 8000,而那台机器 8000 上另有一个后端,
# 于是「健康检查通过」是个假绿灯。
case "$HOST" in 0.0.0.0|""|::|\[::\]) PROBE_HOST=127.0.0.1 ;; *) PROBE_HOST="$HOST" ;; esac
BASE="http://$PROBE_HOST:$PORT"
# 相对路径(models/asr、media、SQLite 文件名)一律锚到仓库根:
# 从 /etc/systemd 或 ~ 里启动服务时,cwd 不是项目目录,相对路径会指到别处。
cd "$ROOT"
if [ -n "$EXPLICIT_DB" ]; then export DATABASE_URL="$EXPLICIT_DB"; fi
case "$ACTION" in
install) do_install ;;
build) install_backend_deps; build_frontend ;;
start) start_server ;;
stop) stop_server ;;
restart) stop_server; start_server ;;
status) status_server ;;
verify) verify_server ;;
systemd) do_systemd ;;
logs) f="$LOG_DIR/$NAME.log"; [ -f "$f" ] || : > "$f"; exec tail -n 80 -F "$f" ;;
esac