重构
This commit is contained in:
wchino
@@ -41,7 +41,7 @@ api ──► postgres:5432
|
||||
|
||||
---
|
||||
|
||||
## 三、一键部署（命令行）
|
||||
## 三、首次部署（命令行）
|
||||
|
||||
### 1. 上传代码
|
||||
|
||||
@@ -58,19 +58,39 @@ cp .env.docker.example .env.docker
|
||||
|
||||
- `POSTGRES_PASSWORD` — 数据库密码
|
||||
- `JWT_SECRET` — 足够长的随机字符串
|
||||
- 首次部署可保持 `SEED_DATABASE=true`，写入演示账号与默认数据；**种子跑完后改回 `false` 并重启 api**
|
||||
- `SEED_DATABASE=false` — 保持默认即可；首次部署脚本会在没有 `admin` 时一次性执行生产 seed
|
||||
|
||||
### 3. 构建并启动
|
||||
### 3. 首次部署
|
||||
|
||||
```bash
|
||||
docker compose -f docker-compose.prod.yml --env-file .env.docker up -d --build
|
||||
chmod +x scripts/*.sh
|
||||
./scripts/deploy-first.sh
|
||||
```
|
||||
|
||||
或使用脚本：
|
||||
脚本会执行：
|
||||
|
||||
- 启动 PostgreSQL / Redis
|
||||
- 构建 API、玩家端、管理端镜像
|
||||
- 执行 `prisma migrate deploy`
|
||||
- 启动全栈容器
|
||||
- 如果数据库中没有 `admin`，执行一次生产 seed
|
||||
|
||||
如果服务器已经提前 `docker load` 了镜像，不想在服务器构建：
|
||||
|
||||
```bash
|
||||
chmod +x scripts/docker-up.sh
|
||||
./scripts/docker-up.sh
|
||||
./scripts/deploy-first.sh --no-build
|
||||
```
|
||||
|
||||
如果上传的是 `thebet365-images.tar`，可让脚本自动加载镜像：
|
||||
|
||||
```bash
|
||||
./scripts/deploy-first.sh --images thebet365-images.tar
|
||||
```
|
||||
|
||||
如需全量初始化生产数据（会清空业务表，仅限全新库或明确重置）：
|
||||
|
||||
```bash
|
||||
./scripts/deploy-first.sh --init-db
|
||||
```
|
||||
|
||||
### 4. 查看状态
|
||||
@@ -86,7 +106,8 @@ docker compose -f docker-compose.prod.yml --env-file .env.docker logs -f api
|
||||
|------|------|
|
||||
| 玩家前台 | http://服务器IP:8082 |
|
||||
| 管理后台 | http://服务器IP:8081 |
|
||||
| API 文档 | http://服务器IP:3000/api/docs |
|
||||
|
||||
API 只在 Docker 网络内暴露，前端容器通过 `/api` 代理到 API。外层域名反代由宝塔网站配置处理。
|
||||
|
||||
---
|
||||
|
||||
@@ -101,7 +122,7 @@ docker compose -f docker-compose.prod.yml --env-file .env.docker logs -f api
|
||||
- 环境文件：选择 `.env.docker`（若面板支持）
|
||||
4. **构建并启动**
|
||||
|
||||
若面板不支持指定 env 文件，在 **终端** 中执行第三节第 3 步命令即可。
|
||||
若面板不支持指定 env 文件，在 **终端** 中执行第三节第 3 步脚本即可。
|
||||
|
||||
### 方式 B：绑定域名（Nginx 反代）
|
||||
|
||||
@@ -121,19 +142,17 @@ location / {
|
||||
|
||||
**管理站** — 将 `8082` 改为 `8081`。
|
||||
|
||||
API 端口 3000 建议**不要**直接公网暴露；Swagger 仅供内网或通过 VPN 访问。
|
||||
API 端口 3000 不在生产 compose 中公网映射；Swagger 如需临时查看，建议只在内网或通过 VPN 暴露。
|
||||
|
||||
---
|
||||
|
||||
## 五、演示账号
|
||||
## 五、默认账号
|
||||
|
||||
`SEED_DATABASE=true` 首次启动后可用（生产环境**仅创建 admin**，不含代理/玩家；详见 [默认数据说明.md](./默认数据说明.md)）：
|
||||
生产 seed 仅创建平台管理员与基础赛事/内容数据，不创建代理/玩家演示账号；详见 [默认数据说明.md](./默认数据说明.md)。
|
||||
|
||||
| 角色 | 用户名 | 密码 | 入口 |
|
||||
|------|--------|------|------|
|
||||
| 平台管理员 | admin | Admin@123 | 管理后台 :8081 |
|
||||
| 一级代理 | agent1 | Agent@123 | 管理后台 :8081 |
|
||||
| 玩家 | player1 | Player@123 | 玩家前台 :8082 |
|
||||
|
||||
---
|
||||
|
||||
@@ -149,8 +168,8 @@ docker compose -f docker-compose.prod.yml --env-file .env.docker down -v
|
||||
# 仅重建 API
|
||||
docker compose -f docker-compose.prod.yml --env-file .env.docker up -d --build api
|
||||
|
||||
# 手动种子（容器已运行时，仅增量写入，不会删除已有数据）
|
||||
docker compose -f docker-compose.prod.yml --env-file .env.docker exec api npx prisma db seed
|
||||
# 手动备份数据库
|
||||
./scripts/backup-db.sh
|
||||
|
||||
# 全量初始化（生产上线：仅 admin + WC2026 赛事，会先备份到 ./backups/）
|
||||
CONFIRM=YES ./scripts/prod-init-db.sh
|
||||
@@ -183,36 +202,49 @@ pnpm docker:ps
|
||||
备份 PostgreSQL 示例：
|
||||
|
||||
```bash
|
||||
docker exec thebet365-postgres pg_dump -U thebet365 thebet365 > backup.sql
|
||||
./scripts/backup-db.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 八、更新部署
|
||||
## 八、后续更新部署
|
||||
|
||||
**推荐：先删旧代码再解压新 zip**（避免 `packages/shared/public/球员` 等中文目录残留导致 Vite 构建失败）。
|
||||
|
||||
本地构建并导出镜像的详细步骤见：[docker/镜像构建与导出.md](./docker/镜像构建与导出.md)（脚本位于 `docs/docker/build-and-export-images.ps1` / `build-and-export-images.sh`）。
|
||||
|
||||
```bash
|
||||
cd /www/wwwroot
|
||||
mv thebet365 thebet365.bak.$(date +%Y%m%d) # 备份旧目录（保留 .env.docker）
|
||||
mkdir thebet365 && cd thebet365
|
||||
# 上传并解压新 zip 到当前目录
|
||||
cp ../thebet365.bak.*/.env.docker . 2>/dev/null || cp .env.docker.example .env.docker
|
||||
|
||||
docker compose -f docker-compose.prod.yml --env-file .env.docker build --no-cache
|
||||
docker compose -f docker-compose.prod.yml --env-file .env.docker up -d
|
||||
```
|
||||
|
||||
若仍覆盖解压，构建前可手动清理：
|
||||
### 方式 A：服务器直接拉代码并构建
|
||||
|
||||
```bash
|
||||
find packages/shared/public -mindepth 1 -maxdepth 1 -type d \
|
||||
! -name flags ! -name players -exec rm -rf {} +
|
||||
cd /www/wwwroot/thebet365
|
||||
./scripts/deploy-update.sh --pull
|
||||
```
|
||||
|
||||
API 容器启动时会自动执行 `prisma migrate deploy`，无需手动迁移。
|
||||
### 方式 B：上传 zip 后在服务器构建
|
||||
|
||||
保留原来的 `.env.docker`，替换代码后执行：
|
||||
|
||||
```bash
|
||||
cd /www/wwwroot/thebet365
|
||||
./scripts/deploy-update.sh
|
||||
```
|
||||
|
||||
### 方式 C：上传已构建镜像包
|
||||
|
||||
```bash
|
||||
cd /www/wwwroot/thebet365
|
||||
./scripts/deploy-update.sh --images thebet365-images.tar
|
||||
```
|
||||
|
||||
更新脚本默认会：
|
||||
|
||||
- 先备份 PostgreSQL 到 `./backups/`
|
||||
- 构建或加载新镜像
|
||||
- 使用新 API 镜像执行 `prisma migrate deploy`
|
||||
- 启动/替换 API、玩家端、管理端容器
|
||||
- 执行 `prisma migrate status` 检查数据库迁移状态
|
||||
|
||||
除非已经手工确认有其他备份，否则不要使用 `--no-backup`。
|
||||
|
||||
---
|
||||
|
||||
@@ -236,7 +268,7 @@ docker logs thebet365-api
|
||||
|
||||
### 4. 端口被占用
|
||||
|
||||
修改 `.env.docker` 中的 `API_PORT` / `PLAYER_PORT` / `ADMIN_PORT` 后重新 `up -d`。
|
||||
修改 `.env.docker` 中的 `PLAYER_PORT` / `ADMIN_PORT` 后重新部署。API 不对公网映射端口。
|
||||
|
||||
### 5. player/admin 构建报错 `ENOENT ... packages/shared/public/球员`
|
||||
|
||||
@@ -255,6 +287,7 @@ docker compose -f docker-compose.prod.yml --env-file .env.docker build --no-cach
|
||||
| 场景 | 命令 |
|
||||
|------|------|
|
||||
| 本地开发（仅 DB 用 Docker） | `docker compose up -d` + `pnpm dev` |
|
||||
| 生产全栈 Docker | `docker compose -f docker-compose.prod.yml --env-file .env.docker up -d --build` |
|
||||
| 生产首次部署 | `./scripts/deploy-first.sh` |
|
||||
| 生产后续更新 | `./scripts/deploy-update.sh` |
|
||||
|
||||
相关文档：[项目启动指南.md](./项目启动指南.md)
|
||||
|
||||
Reference in New Issue
Block a user