auto-solution/DEPLOY_OFFLINE.md

# Docker 离线部署说明（方式 A）

执行 `docker compose up -d` 即可启动。

## 1. 交付清单

请将以下内容放在同一目录（示例：`app/`）：

- `docker-compose.yml`
- `.env`（或将 `.env.example` 复制为 `.env` 后修改）
- `bundle-images.tar`（包含 `auto-solution-admin`、`mysql:8.0`、`redis:7-alpine`）
- `docker/mysql/init/01-ruoyi-table.sql`
- `docker/mysql/init/02-ruoyi-extra.sql`
- `docker/mysql/init/03-data.sql`

目录示例：

```text
app/
├─ docker-compose.yml
├─ .env
├─ bundle-images.tar
└─ docker/
   └─ mysql/
      └─ init/
         ├─ 00-create-db.sql
         ├─ 03-data.sql
```

## 2. 首次部署

在 `app` 目录执行：

```bash
docker load -i bundle-images.tar
docker compose down -v
docker compose up -d
```

说明：

- `down -v` 会删除旧数据卷，确保 MySQL 首次初始化时执行 `docker/mysql/init` 下的 SQL。
- SQL 执行顺序按文件名字典序，务必保持 `01 -> 02 -> 03`。

## 3. 启动验证

```bash
docker ps
docker inspect autosolution-mysql --format '{{.State.Health.Status}}'
docker logs --tail 100 autosolution-mysql
docker logs --tail 100 autosolution-app
```

期望结果：

- `autosolution-mysql` 状态为 `healthy`
- `autosolution-app` 状态为 `Up`

## 4. 访问地址

- 后端默认端口：`1777`
- 访问地址：`http://<服务器IP>:1777`

## 5. 常见问题

### 5.1 `Table 'autosolution_db.sys_config' doesn't exist`

原因：初始化 SQL 未执行或执行失败。

处理：

1. 确认 `docker/mysql/init` 下 SQL 文件存在且顺序正确
2. 执行：

```bash
docker compose down -v
docker compose up -d
```

3. 查看 MySQL 日志定位 SQL 报错：

```bash
docker logs --tail 300 autosolution-mysql
```

### 5.2 `dependency failed to start: container autosolution-mysql is unhealthy`

原因：MySQL 未通过健康检查（通常是 SQL 未执行完成或报错）。

处理：

```bash
docker logs --tail 300 autosolution-mysql
```

根据日志修复 SQL 后重新 `down -v` 再启动。

## 6. 版本升级

替换新的 `bundle-images.tar`（及必要 SQL）后执行：

```bash
docker load -i bundle-images.tar
docker compose down
docker compose up -d
```

如果本次升级包含库初始化变更并要求重建，请改用：

```bash
docker compose down -v
docker compose up -d
```