Docker 编排：一键构建并运行整套系统（应用 + MySQL + sftpgo）
docker-compose.yml 把整套系统编排为三个互相连通的服务，开箱即用。
| 服务 | 容器名 | 端口（宿主:容器） | 说明 |
|---|---|---|---|
| capacity-app | capacity-report-app | 9081:9081 | 应用（前端 + 后端），数据落在 /data 卷 |
| capacity-mysql | capacity-mysql | 13306:3306 | MySQL 8，自动建 CapacityReport 与 celldata 两库 |
| sftpgo | capacity-sftpgo | 2022:2022（SFTP）、18080:8080（Web） | 文件服务，供应用拉取数据 |
应用镜像
capacity-report-app:latest由本仓库根的Dockerfile构建；MySQL、sftpgo 为公共镜像。
前置要求
- 已安装 Docker（含 Docker Compose v2，命令为
docker compose）。 - 构建应用镜像需要先产出前端
frontend/dist（下方步骤会做）。 - 联网构建需要能拉取
python:3.13.11-slim、mysql:8.0.44、drakkan/sftpgo:v2.7.1； 内网离线见「方式 B」。
方式 A：联网机器，一键构建并启动
# 1) 构建前端（产出 frontend/dist，镜像会拷贝它）
cd ../frontend
npm ci && npm run build
cd ../packaging
# 2) 构建应用镜像并启动整套系统
docker compose build
docker compose up -d
# 3) 查看状态 / 日志
docker compose ps
docker compose logs -f capacity-app
启动后访问 http://localhost:9081（默认登录 root / Capacity）。
也可以用脚本一步构建并导出离线包：在仓库根执行
python scripts/build_docker.py， 产物在dist/docker/（含capacity-report-app-latest.tar+docker-compose.yml+mysql/+sftpgo/+ 默认脚本）。
方式 B：内网离线部署（无外网）
在有网机器准备好以下文件，拷贝到内网机器：
- 基础/公共镜像（python、mysql、sftpgo）——可用离线镜像目录方案：
- 有网机器：
docker pull三个镜像后docker save -o xxx.tar，连同导入脚本放一个目录。 - 内网机器：在该目录执行
python load_images.py逐个docker load -i ./xxx.tar。 - （示例：本项目已在
F:\CR\env\images准备了mysql_8.0.44.tar、sftpgo_v2.7.1.tar、python_3.13.11-slim.tar与load_images.py。）
- 有网机器：
- 应用镜像：在有网机器
docker compose build后docker save capacity-report-app:latest -o capacity-report-app.tar，拷到内网docker load -i ./capacity-report-app.tar。- 或直接用
python scripts/build_docker.py生成dist/docker/整包带走。
- 或直接用
- 编排文件：本目录的
docker-compose.yml+mysql/+sftpgo/。
内网机器导入镜像后，在编排文件目录执行：
docker compose up -d # 镜像已在本地，不会联网拉取
若内网机器不便构建应用镜像，务必走「先在有网机器 build 出
capacity-report-app:latest再 save」， 这样内网仅需docker load+docker compose up -d，无需 python 基础镜像与构建。
默认账号 / 连接
| 项 | 值 |
|---|---|
| 应用登录 | root / Capacity |
| MySQL | root / gmcc123，库 CapacityReport、celldata（容器内主机名 capacity-mysql） |
| SFTP 用户 | capacity / capacity123（home /srv/sftpgo/data/capacity） |
| sftpgo Web | admin / gmcc123（http://localhost:18080） |
应用首次启动时，entrypoint 会按 docker-compose.yml 里的环境变量把 Configure.json 的
「数据库 / SFTP 连接」自动改写为容器服务（主机名用 capacity-mysql / sftpgo）；
之后你在界面里的修改不会被覆盖。要改默认密码等，编辑 compose 的环境变量与 sftpgo/sftpgo-init.json。
上传数据
通过 SFTP（localhost:2022，capacity/capacity123）或 sftpgo Web（:18080）上传到 capacity 用户目录：
- 容量数据 →
/CapacityReportData（对应RemoteData.remote_dir，结构4G/ 5G/ RJ/）。 - CellData →
/网优日常优化数据文档/...（对应CellData.scan_paths）。
用仓库
test/make_test_data.py生成的小样本可直接传上来做快速测试。 上传后在「数据处理」页执行处理；首次会自动建表（db_init/前置检查）。
数据卷（持久化）
| 卷 | 内容 |
|---|---|
capacity-data |
应用 /data：Configure.json、ReportScript.sql、CellData.sql、db_init、历史、缓存 |
capacity-mysql-data |
MySQL 数据 |
sftpgo-config / sftpgo-data |
sftpgo 状态与上传的文件 |
常用运维
docker compose ps # 状态
docker compose logs -f capacity-app # 应用日志
docker compose restart capacity-app # 重启应用
docker compose down # 停止（保留数据卷）
docker compose down -v # 停止并删除数据卷（彻底重置，慎用）
# 改了代码 / 前端后更新应用：
cd ../frontend && npm run build && cd ../packaging
docker compose build capacity-app && docker compose up -d capacity-app
重置应用侧连接：
Configure.json仅在首次播种时按环境变量初始化；如需重新按 env 生成， 删除capacity-data卷（docker volume rm packaging_capacity-data）后重新up -d。