fix(deploy): 支持无 systemd 的环境，并修复降级路径的两个真实缺陷

用户实测：服务器没有 systemctl，install.sh 直接报错退出。原错误信息本身也是错的（建议 SKIP_NGINX=1，但那只跳过 nginx，仍走 systemctl）。进程管理改为四层降级： systemd → OpenRC → SysVinit → nohup 后台进程（deploy/ctl.sh） - 新增 deploy/ctl.sh：start/stop/restart/status/logs，PID 文件 + 进程名双重判定 - 新增 deploy/openrc/opendance-api、deploy/initd/opendance-api - 无 init 系统时写 crontab @reboot 实现开机自启 - uninstall.sh 同步支持四种模式清理（原先只处理 systemd，会留下运行中的进程） - 汇总输出按实际初始化系统给出对应运维命令测试中发现并修复降级路径的两个真实缺陷： 1. nohup 无法调用 shell 函数实测退出码 127 且什么都不执行（nohup 是外部命令，只能执行可执行文件）。这会让无 systemd 的降级路径完全失效——服务根本起不来。改为按 runuser / setpriv / su 显式拼接成外部命令后再 nohup。另加启动后 1 秒存活检测，失败立即打印日志，不再白等 30 秒。 2. find_pids 在无进程时返回一个空格在空输入下仍会执行一次 echo，输出空行，最终得到 " "；调用方 [ -n ... ] 会判为「有进程」，导致 start 直接跳过、status 谎报运行中。改为纯 bash 拼接，空时返回空串。实测（真实 API 进程，端口 3100）： start → 健康检查 200，PID 正确重复 start → 识别已在运行，进程数保持 1 status → 运行中 restart → 新 PID，健康检查 200 stop → 无残留进程，端口释放无 process 时 find_pids 返回空串，is_running=false
2026-09-15 00:34:52 +08:00
parent 1ffe3059af
commit c092b833fb
7 changed files with 421 additions and 30 deletions
@@ -0,0 +1,178 @@
+#!/bin/bash
+# ============================================================
+# OpenDance Studio Web API —— 进程控制（不依赖 systemd / OpenRC / SysV）
+#
+# 适用于没有 systemd 的环境（容器、LXC、精简系统等）。
+# 以 nohup 后台运行 Node 进程并记录 PID，日志写入 LOG_FILE。
+#
+# 用法（需 root）：
+#   bash deploy/ctl.sh start|stop|restart|status|logs
+#
+# 配置来源：$APP_DIR/deploy/.env
+# 可用环境变量覆盖：APP_DIR / SERVICE_USER / LOG_FILE
+# ============================================================
+set -uo pipefail
+
+APP_DIR="${APP_DIR:-/opt/opendance}"
+SERVICE_USER="${SERVICE_USER:-opendance}"
+LOG_FILE="${LOG_FILE:-/var/log/opendance-api.log}"
+RUN_DIR="${RUN_DIR:-/run}"
+PID_FILE="${PID_FILE:-$RUN_DIR/opendance-api.pid}"
+MAIN_JS="$APP_DIR/web-server/dist/main.js"
+
+die() { printf '\033[1;31m[ctl]\033[0m %s\n' "$*" >&2; exit 1; }
+log() { printf '\033[1;34m[ctl]\033[0m %s\n' "$*"; }
+
+[ "$(id -u)" -eq 0 ] || die "需要 root 权限"
+
+# 以服务用户身份执行；不使用 sudo（本脚本已要求 root）
+as_service_user() {
+  if command -v runuser >/dev/null 2>&1; then
+    runuser -u "$SERVICE_USER" -- "$@"
+  elif command -v setpriv >/dev/null 2>&1; then
+    setpriv --reuid="$SERVICE_USER" --regid="$SERVICE_USER" --init-groups -- "$@"
+  else
+    su -s /bin/bash "$SERVICE_USER" -c "$(printf '%q ' "$@")"
+  fi
+}
+
+# 后台启动服务进程，回显启动器 PID。
+# 注意：这里**不能**写成 `nohup as_service_user ...`。
+# nohup 是外部命令，只能执行可执行文件，无法调用 shell 函数
+# （实测直接退出码 127 且什么都不运行），会让无 systemd 的降级路径完全失效。
+# 因此三种降权工具各自显式拼接成外部命令。
+spawn_service_process() {
+  local node_bin="$1" script="$2"
+  if command -v runuser >/dev/null 2>&1; then
+    nohup runuser -u "$SERVICE_USER" -- "$node_bin" "$script" >>"$LOG_FILE" 2>&1 &
+  elif command -v setpriv >/dev/null 2>&1; then
+    nohup setpriv --reuid="$SERVICE_USER" --regid="$SERVICE_USER" --init-groups -- \
+      "$node_bin" "$script" >>"$LOG_FILE" 2>&1 &
+  else
+    nohup su -s /bin/bash "$SERVICE_USER" -c "$(printf '%q ' "$node_bin" "$script")" \
+      >>"$LOG_FILE" 2>&1 &
+  fi
+  echo $!
+}
+
+node_bin() {
+  command -v node 2>/dev/null || die "未找到 node"
+}
+
+# 按 pid 文件与命令行双重判定，避免 PID 记录失准。
+# 返回以空格分隔的 PID 列表；**没有进程时返回空串**。
+# 注意：不能再用 `echo "$pids" | xargs -n1` 去重 —— xargs 在空输入下仍会
+# 执行一次 echo，输出一个空行，最终得到一个空格。调用方 `[ -n "$(...)" ]`
+# 会把 " " 判为“有进程”，导致 start 直接跳过、服务根本没起来。
+find_pids() {
+  local pids=""
+  if [ -f "$PID_FILE" ]; then
+    local pid
+    pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+    if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+      pids="$pid"
+    fi
+  fi
+  # 兜底：命令行里带 main.js 绝对路径的进程（启动时即用绝对路径，故匹配精确）
+  local extra
+  extra="$(pgrep -f -- "$MAIN_JS" 2>/dev/null || true)"
+  for p in $extra; do
+    case " $pids " in
+      *" $p "*) ;;
+      *) pids="${pids:+$pids }$p" ;;
+    esac
+  done
+  printf '%s' "$pids"
+}
+
+is_running() { [ -n "$(find_pids)" ]; }
+
+start() {
+  [ -f "$MAIN_JS" ] || die "找不到 $MAIN_JS，请先执行 deploy/install.sh"
+  if is_running; then
+    log "已在运行（PID:$(find_pids)），跳过启动"
+    return 0
+  fi
+
+  # 载入部署环境变量
+  if [ -f "$APP_DIR/deploy/.env" ]; then
+    set -a; . "$APP_DIR/deploy/.env"; set +a
+  else
+    die "缺少 $APP_DIR/deploy/.env"
+  fi
+
+  mkdir -p "$(dirname "$LOG_FILE")" "$RUN_DIR"
+  touch "$LOG_FILE"
+  chown "$SERVICE_USER:$SERVICE_USER" "$LOG_FILE" 2>/dev/null || true
+
+  local NODE; NODE="$(node_bin)"
+  log "启动：$MAIN_JS（用户 $SERVICE_USER）"
+  cd "$APP_DIR/web-server" || die "无法进入 $APP_DIR/web-server"
+
+  # 用绝对路径启动，便于 stop 时精确匹配命令行
+  local launcher_pid
+  launcher_pid="$(spawn_service_process "$NODE" "$MAIN_JS")"
+  echo "$launcher_pid" > "$PID_FILE"
+
+  # 先确认启动器没有立刻失败（如降权工具不可用、node 路径错误）
+  sleep 1
+  if ! is_running; then
+    warn "进程未能启动，日志如下："
+    tail -20 "$LOG_FILE" >&2 || true
+    rm -f "$PID_FILE"
+    return 1
+  fi
+
+  # 等待端口就绪
+  local port="${PORT:-3000}"
+  for _ in $(seq 1 30); do
+    if command -v curl >/dev/null 2>&1; then
+      curl -fsS -m 2 "http://127.0.0.1:${port}/health" >/dev/null 2>&1 && { log "已就绪（PID:$(find_pids)）"; return 0; }
+    else
+      "$NODE" -e 'fetch(process.argv[1]).then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))' \
+        "http://127.0.0.1:${port}/health" >/dev/null 2>&1 && { log "已就绪（PID:$(find_pids)）"; return 0; }
+    fi
+    sleep 1
+  done
+
+  log "警告：30 秒内未通过健康检查，请查看 $LOG_FILE"
+  tail -20 "$LOG_FILE" >&2 || true
+  return 1
+}
+
+stop() {
+  local pids; pids="$(find_pids)"
+  if [ -z "$pids" ]; then
+    log "未在运行"
+    rm -f "$PID_FILE"
+    return 0
+  fi
+  log "停止：$pids"
+  for p in $pids; do kill -TERM "$p" 2>/dev/null || true; done
+  for _ in $(seq 1 15); do is_running || break; sleep 1; done
+  pids="$(find_pids)"
+  if [ -n "$pids" ]; then
+    log "优雅退出超时，强制结束：$pids"
+    for p in $pids; do kill -KILL "$p" 2>/dev/null || true; done
+  fi
+  rm -f "$PID_FILE"
+  log "已停止"
+}
+
+status() {
+  if is_running; then
+    log "运行中（PID:$(find_pids)）"
+    return 0
+  fi
+  log "未运行"
+  return 3
+}
+
+case "${1:-}" in
+  start)   start ;;
+  stop)    stop ;;
+  restart) stop; start ;;
+  status)  status ;;
+  logs)    tail -n "${2:-80}" -f "$LOG_FILE" ;;
+  *)       die "用法：bash deploy/ctl.sh start|stop|restart|status|logs" ;;
+esac
@@ -0,0 +1,35 @@
+#!/bin/sh
+### BEGIN INIT INFO
+# Provides:          opendance-api
+# Required-Start:    $network $remote_fs $local_fs
+# Required-Stop:     $network $remote_fs $local_fs
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 6
+# Short-Description: OpenDance Studio Web 管理服务端
+# Description:       OpenDance Studio Web 管理服务端（NestJS + TypeORM）
+### END INIT INFO
+#
+# SysVinit / LSB 启动脚本。实际启停逻辑复用 deploy/ctl.sh，
+# 避免 systemd / SysV / 纯进程三种模式各写一份。
+#
+# 也可以直接手动调用：
+#   /etc/init.d/opendance-api start|stop|restart|status
+
+APP_DIR="__APP_DIR__"
+SERVICE_USER="__SERVICE_USER__"
+
+export APP_DIR SERVICE_USER
+
+case "$1" in
+  start|stop|restart|status)
+    ;;
+  reload|force-reload)
+    set -- restart
+    ;;
+  *)
+    echo "用法: $0 {start|stop|restart|status}" >&2
+    exit 2
+    ;;
+esac
+
+exec /bin/bash "$APP_DIR/deploy/ctl.sh" "$1"
@@ -92,8 +92,6 @@ API_PORT="${PORT:-3000}"
 [ -n "${DB_PASS:-}" ] || die "deploy/.env 中 DB_PASS 未设置"
 [ -n "${DB_NAME:-}" ] || die "deploy/.env 中 DB_NAME 未设置"

-command -v systemctl >/dev/null 2>&1 || die "未找到 systemctl。本部署依赖 systemd 托管 Node 进程；
-  若目标系统没有 systemd（如容器/WSL1），请改用 SKIP_NGINX=1 手动以进程方式运行，或换一台服务器。"
 command -v node >/dev/null 2>&1 || die "未找到 node。请安装 Node.js 22 或更高版本。"
 NODE_BIN="$(command -v node)"
 NODE_MAJOR="$(node -p 'process.versions.node.split(".")[0]')"
@@ -233,19 +231,81 @@ as_service_user env \
  "DB_PASS=${DB_PASS}" "DB_NAME=${DB_NAME}" "DB_LOGGING=${DB_LOGGING:-false}" \
  "$NODE_BIN" scripts/migrate.mjs run

-# ---------- 4. systemd 服务 ----------
-log "安装 systemd 服务"
-SERVICE_FILE=/etc/systemd/system/opendance-api.service
-sed -e "s|__SERVICE_USER__|$SERVICE_USER|g" \
-    -e "s|__APP_DIR__|$APP_DIR|g" \
-    -e "s|__NODE_BIN__|$NODE_BIN|g" \
-    -e "s|__STORAGE_PARENT__|$(dirname "$STORAGE_DIR")|g" \
-    "$APP_DIR/deploy/systemd/opendance-api.service" > "$SERVICE_FILE"
-chmod 644 "$SERVICE_FILE"
+# ---------- 4. 安装为系统服务（按可用的初始化系统降级） ----------
+# systemd → OpenRC → SysVinit → 纯后台进程（nohup + PID 文件）
+# “运行在 Linux 上”不应等于“必须有 systemd”：容器 / LXC / 精简系统都很常见。
+INIT_SYSTEM=""
+if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
+  INIT_SYSTEM=systemd
+elif command -v rc-service >/dev/null 2>&1 && command -v rc-update >/dev/null 2>&1; then
+  INIT_SYSTEM=openrc
+elif [ -d /etc/init.d ] && { command -v update-rc.d >/dev/null 2>&1 || command -v chkconfig >/dev/null 2>&1; }; then
+  INIT_SYSTEM=sysvinit
+else
+  INIT_SYSTEM=none
+fi
+log "初始化系统：$INIT_SYSTEM"

-systemctl daemon-reload
-systemctl enable opendance-api >/dev/null
-systemctl restart opendance-api
+case "$INIT_SYSTEM" in
+  systemd)
+    log "安装 systemd 服务"
+    SERVICE_FILE=/etc/systemd/system/opendance-api.service
+    sed -e "s|__SERVICE_USER__|$SERVICE_USER|g" \
+        -e "s|__APP_DIR__|$APP_DIR|g" \
+        -e "s|__NODE_BIN__|$NODE_BIN|g" \
+        -e "s|__STORAGE_PARENT__|$(dirname "$STORAGE_DIR")|g" \
+        "$APP_DIR/deploy/systemd/opendance-api.service" > "$SERVICE_FILE"
+    chmod 644 "$SERVICE_FILE"
+    systemctl daemon-reload
+    systemctl enable opendance-api >/dev/null
+    systemctl restart opendance-api
+    ;;
+
+  openrc)
+    log "安装 OpenRC 服务"
+    sed -e "s|__SERVICE_USER__|$SERVICE_USER|g" \
+        -e "s|__APP_DIR__|$APP_DIR|g" \
+        -e "s|__NODE_BIN__|$NODE_BIN|g" \
+        "$APP_DIR/deploy/openrc/opendance-api" > /etc/init.d/opendance-api
+    chmod 755 /etc/init.d/opendance-api
+    rc-update add opendance-api default >/dev/null 2>&1 || warn "rc-update add 失败，请手动加入默认运行级"
+    rc-service opendance-api restart 2>/dev/null || rc-service opendance-api start
+    ;;
+
+  sysvinit)
+    log "安装 SysVinit 服务"
+    sed -e "s|__SERVICE_USER__|$SERVICE_USER|g" \
+        -e "s|__APP_DIR__|$APP_DIR|g" \
+        "$APP_DIR/deploy/initd/opendance-api" > /etc/init.d/opendance-api
+    chmod 755 /etc/init.d/opendance-api
+    if command -v update-rc.d >/dev/null 2>&1; then
+      update-rc.d opendance-api defaults >/dev/null 2>&1 || warn "update-rc.d 失败，请手动建立启动链接"
+    elif command -v chkconfig >/dev/null 2>&1; then
+      chkconfig --add opendance-api >/dev/null 2>&1 || true
+    fi
+    /etc/init.d/opendance-api restart
+    ;;
+
+  none)
+    warn "未检测到 systemd / OpenRC / SysVinit，改用后台进程方式运行（nohup + PID 文件）"
+    chmod +x "$APP_DIR/deploy/ctl.sh"
+    APP_DIR="$APP_DIR" SERVICE_USER="$SERVICE_USER" bash "$APP_DIR/deploy/ctl.sh" restart
+
+    # 尝试用 cron 的 @reboot 实现开机自启（没有 cron 就只提示）
+    if command -v crontab >/dev/null 2>&1; then
+      CRON_LINE="@reboot /bin/bash $APP_DIR/deploy/ctl.sh start >/dev/null 2>&1"
+      if crontab -l 2>/dev/null | grep -qF "$APP_DIR/deploy/ctl.sh start"; then
+        log "开机自启已存在（crontab @reboot）"
+      else
+        ( crontab -l 2>/dev/null; echo "$CRON_LINE" ) | crontab -
+        log "已写入开机自启：crontab @reboot"
+      fi
+    else
+      warn "未找到 crontab，无法配置开机自启。重启后请手动执行："
+      warn "  bash $APP_DIR/deploy/ctl.sh start"
+    fi
+    ;;
+esac

 log "等待 API 就绪…"
 READY=0
@@ -303,6 +363,31 @@ fi

 # ---------- 6. 完成 ----------
 HOST_HINT="${DEPLOY_HOST:-<服务器IP>}"
+
+# 按实际使用的初始化系统给出对应的运维命令（用变量拼装，避免嵌套 heredoc 出错）
+case "$INIT_SYSTEM" in
+  systemd)
+    CMD_HINT="  systemctl status opendance-api      # 服务状态
+  journalctl -u opendance-api -f      # 实时日志
+  systemctl restart opendance-api     # 重启"
+    ;;
+  openrc)
+    CMD_HINT="  rc-service opendance-api status     # 服务状态
+  rc-service opendance-api restart    # 重启
+  tail -f /var/log/opendance-api.log  # 实时日志"
+    ;;
+  sysvinit)
+    CMD_HINT="  /etc/init.d/opendance-api status    # 服务状态
+  /etc/init.d/opendance-api restart   # 重启
+  tail -f /var/log/opendance-api.log  # 实时日志"
+    ;;
+  *)
+    CMD_HINT="  bash ${APP_DIR}/deploy/ctl.sh status    # 服务状态
+  bash ${APP_DIR}/deploy/ctl.sh restart   # 重启
+  bash ${APP_DIR}/deploy/ctl.sh logs      # 实时日志"
+    ;;
+esac
+
 cat <<EOF

 ============================================================
@@ -314,12 +399,10 @@ OpenDance Studio Web 服务端已部署（Linux 原生站点，无 Docker）
  数据库：     使用现有实例 ${DB_HOST}:${DB_PORT:-3306}/${DB_NAME}
  上传目录：   ${STORAGE_DIR}
  程序目录：   ${APP_DIR}
-  Node 进程：  仅监听 ${API_HOST}:${API_PORT}（systemd 托管）
+  Node 进程：  仅监听 ${API_HOST}:${API_PORT}
+  进程管理：   ${INIT_SYSTEM}

 常用命令：
-  systemctl status opendance-api      # 服务状态
-  journalctl -u opendance-api -f      # 实时日志
-  systemctl restart opendance-api     # 重启
-  nginx -t && systemctl reload nginx  # 校验并重载 nginx
+${CMD_HINT}
 ============================================================
 EOF
@@ -0,0 +1,36 @@
+#!/sbin/openrc-run
+# OpenDance Studio Web 管理服务端 —— OpenRC 服务脚本
+#
+# 安装位置：/etc/init.d/opendance-api
+#   rc-update add opendance-api default
+#   rc-service opendance-api start
+
+name="opendance-api"
+description="OpenDance Studio Web 管理服务端"
+
+command="__NODE_BIN__"
+command_args="__APP_DIR__/web-server/dist/main.js"
+command_background="yes"
+pidfile="/run/opendance-api.pid"
+directory="__APP_DIR__/web-server"
+command_user="__SERVICE_USER__:__SERVICE_USER__"
+output_log="/var/log/opendance-api.log"
+error_log="/var/log/opendance-api.log"
+supervisor="supervise-daemon"
+
+depend() {
+    need net
+    after firewall
+    use dns logger
+}
+
+start_pre() {
+    # 载入部署环境变量（OpenRC 没有 EnvironmentFile，用 start_pre 导出）
+    if [ -f "__APP_DIR__/deploy/.env" ]; then
+        set -a
+        # shellcheck disable=SC1091
+        . "__APP_DIR__/deploy/.env"
+        set +a
+    fi
+    checkpath --directory --owner __SERVICE_USER__:__SERVICE_USER__ /var/log
+}
@@ -24,11 +24,34 @@ die()  { printf '\033[1;31m[error]\033[0m %s\n' "$*" >&2; exit 1; }
 [ "$(id -u)" -eq 0 ] || die "需要 root 权限。请以 root 身份执行，例如：
  su -c 'bash deploy/uninstall.sh'   或   sudo bash deploy/uninstall.sh"

-log "停止并禁用 opendance-api 服务"
-systemctl stop opendance-api 2>/dev/null || true
-systemctl disable opendance-api 2>/dev/null || true
-rm -f /etc/systemd/system/opendance-api.service
-systemctl daemon-reload
+log "停止并移除 opendance-api 服务"
+# 与 install.sh 的四层降级一一对应，避免在非 systemd 系统上留下仍在运行的进程
+if [ -d /run/systemd/system ] && command -v systemctl >/dev/null 2>&1; then
+  systemctl stop opendance-api 2>/dev/null || true
+  systemctl disable opendance-api 2>/dev/null || true
+  rm -f /etc/systemd/system/opendance-api.service
+  systemctl daemon-reload
+elif command -v rc-service >/dev/null 2>&1 && [ -f /etc/init.d/opendance-api ]; then
+  rc-service opendance-api stop 2>/dev/null || true
+  rc-update del opendance-api default 2>/dev/null || true
+  rm -f /etc/init.d/opendance-api
+elif [ -f /etc/init.d/opendance-api ]; then
+  /etc/init.d/opendance-api stop 2>/dev/null || true
+  command -v update-rc.d >/dev/null 2>&1 && update-rc.d -f opendance-api remove 2>/dev/null || true
+  command -v chkconfig  >/dev/null 2>&1 && chkconfig --del opendance-api 2>/dev/null || true
+  rm -f /etc/init.d/opendance-api
+fi
+
+# 降级模式（nohup 后台进程）的停止与开机自启清理
+if [ -f "$APP_DIR/deploy/ctl.sh" ]; then
+  APP_DIR="$APP_DIR" SERVICE_USER="$SERVICE_USER" bash "$APP_DIR/deploy/ctl.sh" stop 2>/dev/null || true
+fi
+if command -v crontab >/dev/null 2>&1; then
+  if crontab -l 2>/dev/null | grep -qF "$APP_DIR/deploy/ctl.sh start"; then
+    crontab -l 2>/dev/null | grep -vF "$APP_DIR/deploy/ctl.sh start" | crontab -
+    log "已移除 crontab 开机自启"
+  fi
+fi

 if command -v nginx >/dev/null 2>&1; then
  log "移除 nginx 站点"