部署前置

Docker 安装与配置

安装 Docker 并配置国内镜像加速，便于拉取 jiangzhikj/zq-platform-community 一体机镜像（约 5–6GB）。

1 安装 Docker

1.1 Windows

下载并安装 Docker Desktop for Windows（安装向导会按需提示启用 WSL2 等组件）。
安装完成后重启（若安装程序提示）。
打开 Docker Desktop，等待状态为 Running。
在 PowerShell 或 CMD 中执行 docker version 验证。

仅当安装失败时再排查：BIOS 虚拟化（VT-x/AMD-V）是否开启，或手动安装 WSL2。

1.2 Linux（Ubuntu / Debian 示例）

使用官方仓库安装 Docker CE（以 root 或 sudo 执行）：

Bash

# 卸载旧包（可选）
sudo apt-get remove -y docker docker-engine docker.io containerd runc 2>/dev/null || true

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo   "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu   $(. /etc/os-release && echo "$VERSION_CODENAME") stable" |   sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

sudo systemctl enable --now docker

非 Ubuntu 可参考 Docker 官方文档选择对应发行版。

可选：允许当前用户免 sudo 使用 Docker：

Bash

sudo usermod -aG docker "$USER"
# 重新登录 shell 后生效

2 配置国内 Docker 镜像加速（registry-mirrors）

国内从 Docker Hub 拉取大镜像时，建议配置镜像加速。实际只需设置一项：registry-mirrors（镜像站地址列表）。不要删掉 Docker Engine / daemon.json 里原有的其它字段，在其基础上增加或修改这一项即可。

下面「最小配置」就是多数情况下你要填的内容；公共镜像站可能失效，请以当前可用地址为准。加速针对 docker.io，社区版镜像 jiangzhikj/zq-platform-community 托管在 Docker Hub。

2.1 Windows（Docker Desktop）

打开 Docker Desktop → Settings → Docker Engine，会看到一段 JSON。
在 JSON 根对象中加入（或更新）registry-mirrors 数组；保留你已有的 builder、experimental 等字段，只动镜像加速即可。

只需配置的片段（复制进现有 JSON，注意逗号）：

registry-mirrors 示例

"registry-mirrors": [
  "https://docker.1ms.run",
  "https://docker.1panel.live"
]

若当前几乎是空配置，整段 JSON 可以是：

JSON（最小示例）

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live"
  ]
}

若原来已有内容，例如 { "experimental": false }，合并后类似： { "experimental": false, "registry-mirrors": [ "https://docker.1ms.run", "https://docker.1panel.live" ] }

点击 Apply & restart，等待 Docker 重启完成。

阿里云用户（推荐）：登录容器镜像服务 ACR → 镜像工具 → 镜像加速器，复制专属地址（形如 https://xxxx.mirror.aliyuncs.com），放进 registry-mirrors 数组最前面。

2.2 Linux

编辑 /etc/docker/daemon.json。若文件不存在或可以覆盖为仅含加速项，使用下面最小配置即可；若已有日志、存储等配置，请只增加或修改 registry-mirrors，勿删除其它键。

最小配置（仅镜像加速）：

daemon.json

{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live"
  ]
}

写入文件并重启 Docker（新装 / 无其它自定义项时）：

Bash

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.1panel.live"
  ]
}
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker

已有 daemon.json 时，请用编辑器打开，在 JSON 里加入上面的 registry-mirrors 段（注意逗号合法），再执行 sudo systemctl daemon-reload && sudo systemctl restart docker，勿直接覆盖整文件以免丢失日志等设置。

验证是否加载：

Bash

docker info | grep -A5 "Registry Mirrors"

2.3 仍无法拉取时（代理 / 登录）

HTTP/HTTPS 代理：Docker Desktop → Settings → Resources → Proxies；Linux 按公司规范为 docker 服务配置代理。
Docker Hub 限流：执行 docker login 后再 pull。
完全离线：在有网络的机器上 docker pull + docker save，目标机 docker load。

配置完成后，返回社区版部署继续拉取并运行一体机镜像。