部署指南

社区版部署

使用 Docker 一键部署社区版一体机镜像 jiangzhikj/zq-platform-community （约 5–6GB）。请先检查 Docker，必要时参考 Docker 安装与配置后再拉取运行。

1 检查 Docker 是否已安装

在终端中执行以下命令。若均能输出版本信息，可直接进入拉取并运行；建议先配置国内镜像加速再拉取大镜像。

Windows（PowerShell 或 CMD）

PowerShell

docker version
docker compose version

Linux / macOS

Bash

docker version
docker compose version

若提示找不到 docker 命令，请前往 Docker 安装与配置完成安装；Windows 安装后若仍无效，可重启终端或注销重新登录。

2 拉取并运行一体机镜像

2.1 拉取镜像

Bash

docker pull jiangzhikj/zq-platform-community:latest

指定版本（示例 2.1.1）：

Bash

docker pull jiangzhikj/zq-platform-community:2.1.1
# 或
docker pull jiangzhikj/zq-platform-community:v2.1.1

若 docker pull 超时或连接 Docker Hub 失败，请先按配置国内 Docker 镜像加速完成配置后重试。

docker pull 只下载镜像，不会启动容器。端口 -p 9090:80 与卷 -v zq-platform-aio-data:/data 写在下面的 docker run 中。浏览器访问 http://<IP>:9090。

2.2 最简启动（一行）

Bash

docker run -d --name zq-platform -p 9090:80 -v zq-platform-aio-data:/data jiangzhikj/zq-platform-community:latest

未设置环境变量时使用镜像内默认凭据（仅适合内网试用）。上线请使用下一节并改为强密码。

2.3 启动容器（推荐，生产环境）

务必挂载数据卷，否则删除容器后数据库与上传文件会丢失。

Linux / macOS / Git Bash：

Bash

docker run -d \
  --name zq-platform \
  -p 9090:80 \
  -v zq-platform-aio-data:/data \
  --restart unless-stopped \
  --shm-size=256m \
  -e TZ=Asia/Shanghai \
  -e DB_PASSWORD='请改为强密码' \
  -e REDIS_PASSWORD='请改为强密码' \
  -e MINIO_ACCESS_KEY='请改为强用户名' \
  -e MINIO_SECRET_KEY='请改为强密码至少8位' \
  jiangzhikj/zq-platform-community:latest

Windows PowerShell（单行）：

PowerShell

docker run -d --name zq-platform -p 9090:80 -v zq-platform-aio-data:/data --restart unless-stopped --shm-size=256m -e TZ=Asia/Shanghai -e DB_PASSWORD="请改为强密码" -e REDIS_PASSWORD="请改为强密码" -e MINIO_ACCESS_KEY="请改为强用户名" -e MINIO_SECRET_KEY="请改为强密码至少8位" jiangzhikj/zq-platform-community:latest

若 9090 已被占用，可改用其它宿主机端口，例如 -p 8080:80。

变量	默认值（未设置时）	说明
`DB_PASSWORD`	`zqplatform`	仅首次初始化 Postgres 时生效；已有数据卷不会改库密码
`REDIS_PASSWORD`	`zqplatform`	Redis 密码
`MINIO_ACCESS_KEY` / `MINIO_SECRET_KEY`	`zqplatform`	MinIO 凭据（secret 至少 8 位）
`JWT_SECRET_KEY`	（自动生成）	可选；未设置时首次启动写入 `/data/secrets.env`

2.4 查看启动进度

首次启动约 1–5 分钟（建库、迁移、导入种子数据）：

Bash

docker logs -f zq-platform

容器健康后日志中会出现 backend / nginx 就绪信息。

3 访问与验收

访问地址	`http://<服务器IP>:9090/` 或 `http://localhost:9090/`
账号	`zqplatform`
密码	`123456`

登录后请尽快修改默认密码。

4 常用运维命令

Bash

# 状态
docker ps -a --filter name=zq-platform

# 停止 / 启动
docker stop zq-platform
docker start zq-platform

# 删除容器（不删数据卷）
docker rm -f zq-platform

# 进入容器
docker exec -it zq-platform bash

# 查看内部进程（supervisord）
docker exec zq-platform supervisorctl status

升级镜像（保留数据）：

Bash

docker pull jiangzhikj/zq-platform-community:latest
docker stop zq-platform
docker rm zq-platform
# 再次执行 2.2 / 2.3 节 docker run，使用同一卷名 zq-platform-aio-data

5 常见问题

现象	处理
`pull` 超时、连接 registry-1.docker.io 失败	参考配置国内 Docker 镜像加速；或配置代理、`docker login`、离线 `docker load`
9090 端口被占用	改用 `-p 8080:80` 等其它宿主机端口
页面长时间 502	等待首次初始化完成，`docker logs -f zq-platform`
重启后数据丢失	确认使用了 `-v zq-platform-aio-data:/data`
Windows 磁盘占用大	Docker Desktop → Resources 限制磁盘；`docker system prune`（勿误删仍在用的卷）

6 镜像名称说明

用途	镜像
社区版一体机（本文）	`jiangzhikj/zq-platform-community`
商业版/其它产品线	`jiangzhikj/zq-platform`（勿与社区版混用）

拉取社区版请始终使用 zq-platform-community 仓库名。