#!/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 < /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