docs: 明确前端本地打包部署流程，优化部署脚本
更新内容： - DEPLOY_ONLINE_GUIDE.md: 详细说明前端本地打包的优势和流程 - deploy-1panel.sh: 优化部署脚本，添加前端构建验证 - 强调前后端分离部署的架构差异 核心变更： 1. 明确说明前端必须本地打包（npm run build） 2. 上传的是打包后的静态文件，不需要服务器 Node.js 3. 添加前端构建验证步骤 4. 优化部署流程提示和输出 部署流程： - 本地：前端构建 → 验证构建 → 上传静态文件 - 服务器：后端代码 → Docker 容器运行 - 1Panel：Nginx 托管静态文件 + 反向代理后端 API Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
root
+97
-36
@@ -1,5 +1,5 @@
|
||||
#!/bin/bash
|
||||
# X-Server Mobile 1Panel 静态站点部署脚本
|
||||
# uniservice-mobile.hnxinyouhe.com 部署脚本
|
||||
# 使用方法: ./deploy-1panel.sh [server]
|
||||
|
||||
set -e
|
||||
@@ -22,6 +22,7 @@ REMOTE_BACKEND_DIR="/opt/x-server-mobile/backend"
|
||||
RED='\033[0;31m'
|
||||
GREEN='\033[0;32m'
|
||||
YELLOW='\033[1;33m'
|
||||
BLUE='\033[0;34m'
|
||||
NC='\033[0m' # No Color
|
||||
|
||||
log_info() {
|
||||
@@ -36,20 +37,30 @@ log_error() {
|
||||
echo -e "${RED}[ERROR]${NC} $1"
|
||||
}
|
||||
|
||||
log_step() {
|
||||
echo -e "${BLUE}==>${NC} $1"
|
||||
}
|
||||
|
||||
# ============================================
|
||||
# 检查环境
|
||||
# ============================================
|
||||
check_env() {
|
||||
log_info "检查部署环境..."
|
||||
log_step "检查部署环境..."
|
||||
|
||||
if ! command -v rsync &> /dev/null; then
|
||||
log_error "rsync 未安装，请先安装: apt-get install rsync"
|
||||
log_info "macOS: brew install rsync"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -d "$FRONTEND_BUILD_DIR" ]; then
|
||||
log_error "前端构建目录不存在: $FRONTEND_BUILD_DIR"
|
||||
log_info "请先运行: cd frontend && npm install && npm run build"
|
||||
log_error "❌ 前端构建目录不存在: $FRONTEND_BUILD_DIR"
|
||||
echo ""
|
||||
log_info "请先在本地构建前端："
|
||||
echo " cd frontend"
|
||||
echo " npm install"
|
||||
echo " npm run build"
|
||||
echo ""
|
||||
exit 1
|
||||
fi
|
||||
|
||||
@@ -57,24 +68,37 @@ check_env() {
|
||||
}
|
||||
|
||||
# ============================================
|
||||
# 构建前端
|
||||
# 验证前端构建
|
||||
# ============================================
|
||||
build_frontend() {
|
||||
log_info "构建前端..."
|
||||
cd frontend
|
||||
npm run build
|
||||
cd ..
|
||||
log_info "✓ 前端构建完成"
|
||||
verify_frontend() {
|
||||
log_step "验证前端构建..."
|
||||
|
||||
if [ ! -f "$FRONTEND_BUILD_DIR/index.html" ]; then
|
||||
log_error "❌ 前端构建不完整，缺少 index.html"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
if [ ! -d "$FRONTEND_BUILD_DIR/assets" ]; then
|
||||
log_warn "⚠️ 未找到 assets 目录，可能是构建失败"
|
||||
fi
|
||||
|
||||
log_info "✓ 前端构建验证通过"
|
||||
echo " - index.html: 存在"
|
||||
echo " - 构建时间: $(ls -lt $FRONTEND_BUILD_DIR/index.html | head -1 | awk '{print $6, $7, $8}')"
|
||||
}
|
||||
|
||||
# ============================================
|
||||
# 部署前端（上传静态文件）
|
||||
# ============================================
|
||||
deploy_frontend() {
|
||||
log_info "部署前端到 1Panel 静态站点..."
|
||||
log_step "部署前端静态文件..."
|
||||
|
||||
echo " 本地: $FRONTEND_BUILD_DIR/"
|
||||
echo " 远程: ${DEPLOY_USER}@${SERVER}:${REMOTE_ROOT}/"
|
||||
|
||||
rsync -avz --delete \
|
||||
--exclude='*.map' \
|
||||
--progress \
|
||||
${FRONTEND_BUILD_DIR}/ \
|
||||
${DEPLOY_USER}@${SERVER}:${REMOTE_ROOT}/
|
||||
|
||||
@@ -85,15 +109,21 @@ deploy_frontend() {
|
||||
# 部署后端
|
||||
# ============================================
|
||||
deploy_backend() {
|
||||
log_info "部署后端..."
|
||||
log_step "部署后端代码..."
|
||||
|
||||
# 创建后端目录（如果不存在）
|
||||
ssh ${DEPLOY_USER}@${SERVER} "mkdir -p ${REMOTE_BACKEND_DIR}"
|
||||
|
||||
echo " 本地: $BACKEND_SOURCE_DIR/"
|
||||
echo " 远程: ${DEPLOY_USER}@${SERVER}:${REMOTE_BACKEND_DIR}/"
|
||||
|
||||
rsync -avz \
|
||||
--exclude='vendor' \
|
||||
--exclude='runtime' \
|
||||
--exclude='.git' \
|
||||
--exclude='node_modules' \
|
||||
--exclude='.idea' \
|
||||
--progress \
|
||||
${BACKEND_SOURCE_DIR}/ \
|
||||
${DEPLOY_USER}@${SERVER}:${REMOTE_BACKEND_DIR}/
|
||||
|
||||
@@ -104,22 +134,54 @@ deploy_backend() {
|
||||
# 重启后端容器
|
||||
# ============================================
|
||||
restart_backend() {
|
||||
log_info "重启后端容器..."
|
||||
log_step "重启后端容器..."
|
||||
|
||||
ssh ${DEPLOY_USER}@${SERVER} << 'EOF'
|
||||
echo "正在检查后端目录..."
|
||||
cd /opt/x-server-mobile
|
||||
|
||||
# 停止旧容器
|
||||
docker-compose -f deploy/docker-compose.prod.yml down
|
||||
if [ ! -f "deploy/docker-compose.prod.yml" ]; then
|
||||
echo "❌ docker-compose.prod.yml 不存在"
|
||||
echo " 请先上传部署配置文件"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# 启动新容器
|
||||
echo "停止旧容器..."
|
||||
docker-compose -f deploy/docker-compose.prod.yml down 2>/dev/null || true
|
||||
|
||||
echo "启动新容器..."
|
||||
docker-compose -f deploy/docker-compose.prod.yml up -d
|
||||
|
||||
# 查看容器状态
|
||||
echo ""
|
||||
echo "容器状态:"
|
||||
docker ps | grep x-server
|
||||
|
||||
echo ""
|
||||
echo "✓ 后端容器重启完成"
|
||||
EOF
|
||||
|
||||
if [ $? -eq 0 ]; then
|
||||
log_info "✓ 后端容器重启成功"
|
||||
else
|
||||
log_error "✗ 后端容器重启失败"
|
||||
exit 1
|
||||
fi
|
||||
}
|
||||
|
||||
# ============================================
|
||||
# 显示部署信息
|
||||
# ============================================
|
||||
show_deployment_info() {
|
||||
echo ""
|
||||
log_step "部署信息"
|
||||
echo ""
|
||||
echo "🌐 访问地址: https://uniservice-mobile.hnxinyouhe.com"
|
||||
echo ""
|
||||
echo "📁 前端目录: ${REMOTE_ROOT}"
|
||||
echo "📁 后端目录: ${REMOTE_BACKEND_DIR}"
|
||||
echo ""
|
||||
echo "📊 后端容器: x-server-backend-prod (端口 8787)"
|
||||
echo ""
|
||||
}
|
||||
|
||||
# ============================================
|
||||
@@ -127,43 +189,42 @@ EOF
|
||||
# ============================================
|
||||
main() {
|
||||
echo "=========================================="
|
||||
echo " X-Server Mobile 1Panel 部署脚本"
|
||||
echo " uniservice-mobile 部署脚本"
|
||||
echo "=========================================="
|
||||
echo ""
|
||||
echo "目标服务器: ${SERVER}"
|
||||
echo "📍 目标服务器: ${SERVER}"
|
||||
echo ""
|
||||
|
||||
# 检查环境
|
||||
check_env
|
||||
|
||||
# 询问是否构建前端
|
||||
read -p "是否需要构建前端? (y/N): " build_frontend_choice
|
||||
if [[ $build_frontend_choice =~ ^[Yy]$ ]]; then
|
||||
build_frontend
|
||||
# 验证前端构建
|
||||
verify_frontend
|
||||
|
||||
echo ""
|
||||
read -p "是否继续部署? (y/N): " confirm
|
||||
if [[ ! $confirm =~ ^[Yy]$ ]]; then
|
||||
log_warn "部署已取消"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
echo ""
|
||||
|
||||
# 部署前端
|
||||
deploy_frontend
|
||||
|
||||
# 询问是否部署后端
|
||||
echo ""
|
||||
read -p "是否需要部署后端? (y/N): " deploy_backend_choice
|
||||
if [[ $deploy_backend_choice =~ ^[Yy]$ ]]; then
|
||||
echo ""
|
||||
deploy_backend
|
||||
restart_backend
|
||||
else
|
||||
log_info "跳过后端部署"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
log_info "=========================================="
|
||||
log_info "部署完成！"
|
||||
log_info "=========================================="
|
||||
echo ""
|
||||
echo "访问地址: https://uniservice-mobile.hnxinyouhe.com"
|
||||
echo ""
|
||||
echo "后续步骤："
|
||||
echo "1. 在 1Panel 面板中找到网站配置"
|
||||
echo "2. 将 deploy/nginx-1panel.conf 的内容添加到 Nginx 配置中"
|
||||
echo "3. 重载 Nginx 配置"
|
||||
echo ""
|
||||
show_deployment_info
|
||||
}
|
||||
|
||||
# 执行主流程
|
||||
|
||||
Reference in New Issue
Block a user