453 lines
24 KiB
Bash
Executable File
453 lines
24 KiB
Bash
Executable File
#!/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/admin@123,只是要在模型管理中心重配一遍。
|
||
warn "没有 scripts/seed/:跳过数据导入,服务器将用 mock 模型 + admin/admin@123 起步"
|
||
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 "admin@123"})
|
||
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
|