佑桥系统安装部署文档

                          用户浏览器
                              │  http://服务器IP:80
                              ▼
                    ┌───────────────────┐
                    │  youqiao-web      │  Nginx + 前端静态资源
                    │  (Nginx 容器)     │  /prod-api/* 反向代理
                    └─────────┬─────────┘
                              │  http://backend:8688
                              ▼
        ┌─────────────────────────────────────────────┐
        │            youqiao-backend (容器)            │
        │   Spring Boot 3.x + MyBatis-Plus + Quartz    │
        └──────┬──────────────┬──────────────┬────────┘
               │              │              │
       ┌───────▼──────┐ ┌─────▼─────┐ ┌──────▼────────┐
       │ youqiao-mysql│ │youqiao-   │ │ 挂载卷         │
       │  (MySQL 8)   │ │redis(R7)  │ │ upload/plugins │
       └──────────────┘ └───────────┘ └────────────────┘

# 1) 安装 Docker Engine + Compose 插件（适用于多数 Linux）
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 2) 启动并设置开机自启
systemctl enable --now docker

# 3) 配置国内镜像加速（国内服务器强烈建议配置，否则拉镜像会很慢）
mkdir -p /etc/docker
cat > /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://mirror.ccs.tencentyun.com"
  ],
  "log-driver": "json-file",
  "log-opts": { "max-size": "100m", "max-file": "3" }
}
EOF
systemctl daemon-reload && systemctl restart docker

# 4) 验证
docker version && docker compose version

# 联网机器
docker pull mysql:8.0.36 redis:7.2-alpine eclipse-temurin:17-jre-jammy nginx:1.25-alpine
docker save -o base-images.tar mysql:8.0.36 redis:7.2-alpine eclipse-temurin:17-jre-jammy nginx:1.25-alpine

# 目标服务器
docker load -i base-images.tar

mkdir -p /opt/youqiao && cd /opt/youqiao
# 1) 解压部署脚手架
unzip youqiao-docker-3.8.9.zip
cd youqiao-docker-3.8.9

# 2) 放入后端 jar
cp /path/to/youqiao-admin-3.8.9.jar runtime/backend/

# 3) 放入前端产物（注意：放的是 dist 里面那一层，不要多套一层 dist/）
unzip /path/to/youqiao-web-frontend-3.8.9.zip       # 得到 dist/
cp -r dist/* runtime/web/
ls runtime/web          # 应能看到 index.html、static/、html/、styles/

# firewalld（CentOS / Rocky / openEuler）
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --reload

# ufw（Ubuntu / Debian）
ufw allow 80/tcp
ufw reload

# 云服务器还需在「安全组」中放行 80 端口

cp .env.example .env
vi .env

bash scripts/install.sh

================================================================
  安装完成
  访问地址：http://<服务器IP>:80
  超级管理员：admin
  初始密码  ：admin123
================================================================

# 1) 四个核心容器都应为 Up（backend 健康检查为 healthy）
./scripts/ctrl.sh status

# 2) 前端页面可打开
curl -sS -o /dev/null -w "HTTP %{http_code}\n" http://127.0.0.1:80/

# 3) 验证码接口可返回（无需登录，用于确认后端确实活着）
curl -sS -o /dev/null -w "HTTP %{http_code}\n" http://127.0.0.1:80/prod-api/captchaImage

# 4) 数据库表已建立
docker exec youqiao-mysql mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -e "USE yq2; SHOW TABLES;" | wc -l
# 期望输出约 70（69 张表 + 表头）

docker compose --profile search up -d

# 数据库备份（ctrl.sh 已内置）
./scripts/ctrl.sh backup
# 产物：backup/yq2_YYYYMMDD_HHMMSS.sql

# 文件数据备份：直接打包落盘目录
tar czf youqiao-data-$(date +%Y%m%d).tar.gz runtime/data runtime/logs

0 2 * * * cd /opt/youqiao/youqiao-docker-3.8.9 && ./scripts/ctrl.sh backup

# 停服后恢复（不要在运行中恢复）
./scripts/ctrl.sh stop
# 重新起一个空库并导入
docker compose up -d mysql
docker exec -i youqiao-mysql mysql -uroot -p"$MYSQL_ROOT_PASSWORD" < backup/yq2_20260926_020000.sql
docker compose up -d

./scripts/ctrl.sh uninstall     # 删除容器与数据卷（会清库！先备份）
vi .env                          # 修改新口令
bash scripts/install.sh          # 重新初始化

cp /path/to/new/youqiao-admin-x.y.z.jar runtime/backend/
rm -f runtime/backend/youqiao-admin-3.8.9.jar
sed -i 's/youqiao-admin-3.8.9.jar/youqiao-admin-x.y.z.jar/' backend/Dockerfile
cp -r /path/to/new/dist/* runtime/web/
./scripts/ctrl.sh pull-upgrade

./scripts/ctrl.sh logs backend   # 后端
./scripts/ctrl.sh logs web       # 前端 / Nginx
./scripts/ctrl.sh logs mysql     # 数据库
./scripts/ctrl.sh status         # 各容器健康状态

mysql -uroot -p -e "CREATE DATABASE yq2 DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -uroot -p yq2 < sql/01-schema.sql
mysql -uroot -p yq2 < sql/02-seed.sql

mkdir -p /home/youqiao/uploadPath /home/youqiao/plugins /home/youqiao/logs
cd /home/youqiao
nohup java -Xms1g -Xmx2g -jar youqiao-admin-3.8.9.jar \
  --server.port=8688 \
  --spring.profiles.active=druid \
  --spring.datasource.druid.master.url='jdbc:mysql://127.0.0.1:3306/yq2?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B8' \
  --spring.datasource.druid.master.username=root \
  --spring.datasource.druid.master.password='你的口令' \
  --spring.redis.host=127.0.0.1 \
  --spring.redis.password='你的口令' \
  --ruoyi.profile=/home/youqiao/uploadPath \
  --youqiao.plugin.home=/home/youqiao/plugins \
  > logs/backend.log 2>&1 &