zijunchiang
75498db1c0
需求变更：Web 服务端不再使用 Docker，改为直接运行在 Linux 上的网站。 - 移除 deploy/docker-compose.yml、web-server/Dockerfile、 web-server/admin/Dockerfile、web-server/.dockerignore - 新增 deploy/install.sh：建服务用户与目录 → 装运行期依赖 → 迁移 → 注册 systemd 服务 → 配置 nginx 站点 → 健康检查，一键完成 - 新增 deploy/systemd/opendance-api.service：ProtectSystem=strict 等 安全加固，ReadWritePaths 限定为上传目录 - 新增 deploy/nginx/opendance.conf：同站点托管管理端静态资源 + 反代 /api /health /static，client_max_body_size 512m，SPA 回退 - 新增 deploy/uninstall.sh：默认保留数据，--purge 才删除 - 新增配置项 HOST（AppConfig.bindHost）：原生部署下 Node 只监听 127.0.0.1，不直接对外暴露，实测外部 IP 不可达 - 同步更新 contracts/rest-api.yaml、DSH.md、project.yaml、README.txt、 tasks/008、tasks/010 与发布打包脚本
209 lines
8.0 KiB
Bash
Executable File
209 lines
8.0 KiB
Bash
Executable File
#!/bin/bash
|
||
# ============================================================
|
||
# OpenDance Studio Web 服务端 —— Linux 原生站点部署脚本
|
||
#
|
||
# 部署形态（不使用 Docker）：
|
||
# nginx ── 静态托管管理端 + 反向代理 API
|
||
# └──▶ systemd 托管的 Node 进程（NestJS，仅监听 127.0.0.1）
|
||
#
|
||
# 数据库仍是部署方提供的**现有 MySQL / MariaDB 实例**，本脚本不安装、不管理数据库。
|
||
#
|
||
# 用法（在解压后的发布目录内，需要 root）：
|
||
# cp deploy/.env.example deploy/.env && vi deploy/.env
|
||
# sudo bash deploy/install.sh
|
||
#
|
||
# 可用环境变量覆盖：
|
||
# APP_DIR 安装目录（默认 /opt/opendance）
|
||
# SERVICE_USER 运行服务的系统用户（默认 opendance）
|
||
# STORAGE_DIR 上传文件目录（默认 /var/lib/opendance/storage）
|
||
# SERVER_NAME nginx server_name（默认 _）
|
||
# SKIP_NGINX=1 只装 API 服务，不配置 nginx
|
||
# ============================================================
|
||
set -euo pipefail
|
||
|
||
SRC_DIR="$(cd "$(dirname "$0")/.." && pwd)"
|
||
cd "$SRC_DIR"
|
||
|
||
APP_DIR="${APP_DIR:-/opt/opendance}"
|
||
SERVICE_USER="${SERVICE_USER:-opendance}"
|
||
STORAGE_DIR="${STORAGE_DIR:-/var/lib/opendance/storage}"
|
||
SERVER_NAME="${SERVER_NAME:-_}"
|
||
API_HOST="127.0.0.1"
|
||
API_PORT="${PORT:-3000}"
|
||
|
||
log() { printf '\033[1;34m[install]\033[0m %s\n' "$*"; }
|
||
warn() { printf '\033[1;33m[warn]\033[0m %s\n' "$*"; }
|
||
die() { printf '\033[1;31m[error]\033[0m %s\n' "$*" >&2; exit 1; }
|
||
|
||
# ---------- 0. 前置检查 ----------
|
||
[ "$(id -u)" -eq 0 ] || die "需要 root 权限（安装 systemd 服务与 nginx 站点）：sudo bash deploy/install.sh"
|
||
|
||
[ -f deploy/.env ] || die "缺少 deploy/.env，请先：
|
||
cp deploy/.env.example deploy/.env && vi deploy/.env"
|
||
|
||
set -a
|
||
# shellcheck disable=SC1091
|
||
. ./deploy/.env
|
||
set +a
|
||
API_PORT="${PORT:-3000}"
|
||
|
||
[ -n "${DB_HOST:-}" ] || die "deploy/.env 中 DB_HOST 未设置"
|
||
[ -n "${DB_USER:-}" ] || die "deploy/.env 中 DB_USER 未设置"
|
||
[ -n "${DB_PASS:-}" ] || die "deploy/.env 中 DB_PASS 未设置"
|
||
[ -n "${DB_NAME:-}" ] || die "deploy/.env 中 DB_NAME 未设置"
|
||
|
||
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]')"
|
||
[ "$NODE_MAJOR" -ge 22 ] 2>/dev/null || die "Node.js 版本过低（当前 $(node -v)），需要 22+"
|
||
command -v npm >/dev/null 2>&1 || die "未找到 npm"
|
||
|
||
log "Node.js：$("$NODE_BIN" -v)（$NODE_BIN）"
|
||
log "安装目录：$APP_DIR"
|
||
log "运行用户：$SERVICE_USER"
|
||
log "上传目录：$STORAGE_DIR"
|
||
log "目标数据库：${DB_HOST}:${DB_PORT:-3306}/${DB_NAME}（现有实例，本脚本不会创建或管理数据库）"
|
||
|
||
# ---------- 1. 系统用户与目录 ----------
|
||
if ! id -u "$SERVICE_USER" >/dev/null 2>&1; then
|
||
log "创建系统用户 $SERVICE_USER"
|
||
useradd --system --shell /usr/sbin/nologin --home-dir "$APP_DIR" --create-home "$SERVICE_USER" 2>/dev/null \
|
||
|| useradd -r -s /sbin/nologin -d "$APP_DIR" -m "$SERVICE_USER"
|
||
fi
|
||
|
||
log "同步程序文件到 $APP_DIR"
|
||
mkdir -p "$APP_DIR"
|
||
for item in web-server admin contracts; do
|
||
[ -e "$SRC_DIR/$item" ] || die "发布包缺少 $item/ 目录"
|
||
rm -rf "${APP_DIR:?}/$item"
|
||
cp -r "$SRC_DIR/$item" "$APP_DIR/$item"
|
||
done
|
||
mkdir -p "$APP_DIR/deploy"
|
||
cp -r "$SRC_DIR/deploy/." "$APP_DIR/deploy/"
|
||
if [ -f "$SRC_DIR/THIRD_PARTY.md" ]; then cp "$SRC_DIR/THIRD_PARTY.md" "$APP_DIR/"; fi
|
||
if [ -f "$SRC_DIR/README.txt" ]; then cp "$SRC_DIR/README.txt" "$APP_DIR/"; fi
|
||
|
||
mkdir -p "$STORAGE_DIR"
|
||
chown -R "$SERVICE_USER:$SERVICE_USER" "$APP_DIR" "$STORAGE_DIR"
|
||
chmod 750 "$STORAGE_DIR"
|
||
|
||
# ---------- 2. 安装运行期依赖（必要时构建） ----------
|
||
cd "$APP_DIR/web-server"
|
||
|
||
if [ -f package-lock.json ]; then
|
||
log "安装运行期依赖（npm ci --omit=dev）"
|
||
sudo -u "$SERVICE_USER" npm ci --omit=dev --no-audit --no-fund
|
||
else
|
||
log "安装运行期依赖（npm install --omit=dev）"
|
||
sudo -u "$SERVICE_USER" npm install --omit=dev --no-audit --no-fund
|
||
fi
|
||
|
||
if [ ! -f dist/main.js ]; then
|
||
warn "未找到构建产物 dist/main.js，改为在服务器上构建（需要 devDependencies）"
|
||
sudo -u "$SERVICE_USER" npm install --no-audit --no-fund
|
||
sudo -u "$SERVICE_USER" npm run build
|
||
fi
|
||
[ -f dist/main.js ] || die "构建产物缺失：$APP_DIR/web-server/dist/main.js"
|
||
[ -f "$APP_DIR/admin/index.html" ] || die "管理端构建产物缺失：$APP_DIR/admin/index.html"
|
||
|
||
# ---------- 3. 数据库迁移 ----------
|
||
log "执行 TypeORM 迁移（不使用 DB_SYNCHRONIZE）"
|
||
set -a; . "$APP_DIR/deploy/.env"; set +a
|
||
cd "$APP_DIR/web-server"
|
||
sudo -u "$SERVICE_USER" env \
|
||
"PATH=$(dirname "$NODE_BIN"):/usr/local/bin:/usr/bin:/bin" \
|
||
"DB_HOST=${DB_HOST}" "DB_PORT=${DB_PORT:-3306}" "DB_USER=${DB_USER}" \
|
||
"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"
|
||
|
||
systemctl daemon-reload
|
||
systemctl enable opendance-api >/dev/null
|
||
systemctl restart opendance-api
|
||
|
||
log "等待 API 就绪…"
|
||
READY=0
|
||
for _ in $(seq 1 30); do
|
||
if curl -fsS -m 3 "http://${API_HOST}:${API_PORT}/health" >/dev/null 2>&1; then READY=1; break; fi
|
||
sleep 1
|
||
done
|
||
if [ "$READY" -ne 1 ]; then
|
||
warn "API 未在 30 秒内就绪，最近日志："
|
||
journalctl -u opendance-api -n 40 --no-pager || true
|
||
die "API 启动失败"
|
||
fi
|
||
log "API 已就绪：$(curl -fsS -m 5 "http://${API_HOST}:${API_PORT}/health" | head -c 200)"
|
||
|
||
# ---------- 5. nginx ----------
|
||
if [ "${SKIP_NGINX:-0}" = "1" ]; then
|
||
warn "SKIP_NGINX=1，跳过 nginx 配置。API 仅在 ${API_HOST}:${API_PORT} 提供。"
|
||
else
|
||
if ! command -v nginx >/dev/null 2>&1; then
|
||
warn "未安装 nginx，跳过站点配置。"
|
||
warn " 安装后重新执行本脚本，或手动把 deploy/nginx/opendance.conf 放到 nginx 配置目录。"
|
||
else
|
||
log "配置 nginx 站点"
|
||
NGINX_AVAILABLE=/etc/nginx/sites-available
|
||
NGINX_ENABLED=/etc/nginx/sites-enabled
|
||
# RHEL 系发行版没有 sites-available 约定
|
||
if [ ! -d "$NGINX_AVAILABLE" ]; then
|
||
NGINX_AVAILABLE=/etc/nginx/conf.d
|
||
NGINX_ENABLED=/etc/nginx/conf.d
|
||
fi
|
||
|
||
DEST="$NGINX_AVAILABLE/opendance.conf"
|
||
sed -e "s|__APP_DIR__|$APP_DIR|g" \
|
||
-e "s|__SERVER_NAME__|$SERVER_NAME|g" \
|
||
-e "s|__API_HOST__|$API_HOST|g" \
|
||
-e "s|__API_PORT__|$API_PORT|g" \
|
||
"$APP_DIR/deploy/nginx/opendance.conf" > "$DEST"
|
||
|
||
if [ "$NGINX_ENABLED" != "$NGINX_AVAILABLE" ]; then
|
||
ln -sf "$DEST" "$NGINX_ENABLED/opendance.conf"
|
||
if [ -e "$NGINX_ENABLED/default" ]; then
|
||
rm -f "$NGINX_ENABLED/default"
|
||
log "已移除 nginx 默认站点（避免抢占 80 端口）"
|
||
fi
|
||
fi
|
||
|
||
if nginx -t; then
|
||
systemctl reload nginx 2>/dev/null || systemctl restart nginx 2>/dev/null || nginx -s reload
|
||
log "nginx 已重载"
|
||
else
|
||
die "nginx 配置校验失败，请检查 $DEST"
|
||
fi
|
||
fi
|
||
fi
|
||
|
||
# ---------- 6. 完成 ----------
|
||
HOST_HINT="${DEPLOY_HOST:-<服务器IP>}"
|
||
cat <<EOF
|
||
|
||
============================================================
|
||
OpenDance Studio Web 服务端已部署（Linux 原生站点，无 Docker）
|
||
管理端首页： http://${HOST_HINT}/
|
||
API 前缀： http://${HOST_HINT}/api
|
||
健康检查： http://${HOST_HINT}/health
|
||
契约快照： http://${HOST_HINT}/contracts/
|
||
数据库： 使用现有实例 ${DB_HOST}:${DB_PORT:-3306}/${DB_NAME}
|
||
上传目录： ${STORAGE_DIR}
|
||
程序目录： ${APP_DIR}
|
||
Node 进程： 仅监听 ${API_HOST}:${API_PORT}（systemd 托管）
|
||
|
||
常用命令：
|
||
systemctl status opendance-api # 服务状态
|
||
journalctl -u opendance-api -f # 实时日志
|
||
systemctl restart opendance-api # 重启
|
||
nginx -t && systemctl reload nginx # 校验并重载 nginx
|
||
============================================================
|
||
EOF
|