宝塔面板默认不带Docker，需手动安装官方脚本；装后须加用户到docker组并设开机自启；无原生容器管理界面，依赖命令行与反向代理共存；端口冲突须通过高位端口+反代解决；生产环境应指定精确镜像标签而非latest。
宝塔面板默认不带 Docker，装之前先确认系统干净
宝塔面板本身是基于 Linux 的 Web 管理工具，它不自带 Docker 运行时，也不干预系统级容器环境。很多用户以为点几下“软件商店”就能装好 Docker，结果发现没这个选项——因为宝塔官方插件市场从 8.x 开始已下架 Docker 插件，且不再维护。
所以你得手动装，但别急着 yum install docker 或 apt install docker.io：CentOS 7/8、Ubuntu 20.04+、Debian 11+ 的包管理器源里 Docker 版本普遍偏旧（比如 docker.io 是 20.10），而新版容器镜像、docker compose v2、甚至某些应用（如 Portainer 2.19+）会直接报错退出。
- 用官方脚本装最稳：
curl -fsSL https://get.docker.com | sh，它会自动识别系统并安装最新稳定版（目前是 24.x） - 装完必须执行
sudo usermod -aG docker $(whoami)，否则普通用户（包括宝塔后台的网站用户）执行docker run会提示Permission denied while trying to connect to the Docker daemon socket - 别跳过
sudo systemctl enable docker，否则服务器重启后容器全停，宝塔里看不到任何运行状态
在宝塔里管理 Docker 容器只能靠终端或 API，没有图形界面
宝塔面板至今没提供容器列表、日志查看、端口映射配置等原生支持。你看到的“Docker”菜单（如果存在）只是第三方插件，兼容性差、更新慢，容易和宝塔主程序冲突导致面板卡死。
真实工作流是：用宝塔建好站点 → 在对应网站根目录下放 docker-compose.yml → 通过宝塔终端或 SSH 进去执行 docker compose up -d。所有操作都绕不开命令行。
- 宝塔终端默认以
www用户身份运行，而该用户不在docker组里，直接执行会失败；必须切到 root 或你自己的用户再操作 -
docker compose（注意没横线）是 v2 命令，不是旧版docker-compose；如果你装的是 Docker Desktop 或某些旧系统，可能只有后者，得用sudo apt install docker-compose-plugin补上 - 宝塔的“计划任务”可以用来定时拉镜像或重启容器，但不能用它跑
docker run—— 因为环境变量缺失，$HOME指向错误，.docker/config.json认不到
端口冲突是部署失败最常见原因，尤其和宝塔共存时
宝塔默认占了 80、443、8888（面板）、888（PHPMyAdmin）、3306（MySQL）等端口。你用 docker run -p 80:80 启动 Nginx 容器，必然失败，错误是：Bind for 0.0.0.0:80 failed: port is already allocated。
解决方案不是关宝塔服务，而是改容器端口映射，再用宝塔反代把流量转进去。这是唯一稳妥、可管理的方式。
- 容器内服务保持默认端口（如 WordPress 用
80），宿主机映射用高位端口：-p 12345:80 - 在宝塔新建站点 → “反向代理” → 目标 URL 填
http://127.0.0.1:12345，别写localhost，否则某些容器 DNS 解析会出问题 - 如果容器需要 WebSocket（比如 VS Code Server），反代配置里必须打开“启用 Websocket”开关，否则连接立即断开
- 别在容器里直接绑定
0.0.0.0:443并自己配 SSL —— 宝塔的 HTTPS 证书续签、HTTP 自动跳转等功能就废了
镜像体积和启动速度影响体验，别无脑 pull latest
很多人用 docker run -d --name myapp nginx:latest 测试成功就以为通了，结果上线后发现每次 docker pull 要几分钟，CI/CD 构建超时，或者容器启动慢半拍，前端白屏好几秒。
Docker 镜像不是越新越好。latest 标签不等于稳定，它可能是开发分支构建的，也可能是多架构混合镜像（含 arm64 层），在 x86_64 服务器上拉下来一堆用不着的东西。
- 生产环境务必指定精确标签：
nginx:1.25-alpine比nginx:latest小 60%，启动快 2–3 倍 - Alpine 镜像虽小，但
glibc缺失，某些 Python/C++ 应用会报No module named '_ctypes'—— 这时候就得换:slim或:bookworm（Debian）版本 - 宝塔终端里执行
docker images会卡，因为要查所有镜像元数据；日常清理用docker image prune -f，别手欠删scratch或buildpack-deps这类基础镜像，否则后续构建失败
真正麻烦的从来不是“怎么装 Docker”，而是“怎么让容器活在宝塔的规则里还不打架”。网络、权限、路径、时区、日志落盘位置……每个点都能卡住半天。动手前先想清楚：这个容器到底要不要被宝塔感知？要不要和其他网站共享域名？要不要备份？想不清这些，装得再快也没用。
