Portainer（Docker UI）

Q: 什么是Portainer（Docker UI）？它解决什么问题？

管理 Docker 主机、栈、容器、镜像和卷的 Web UI —— 适合不完全用 CLI 的团队。 它可帮助开发者在不自建基础设施的前提下完成部署、存储与扩展，是云服务选型的核心参考。

Q: Portainer（Docker UI） 的最佳实践有哪些？

Portainer（Docker UI） 的最佳实践包括：将 Portainer 放在带认证的反向代理后（Caddy + basic_auth 或 Cloudflare Access），避免 Docker 套接字暴露互联网。；多容器应用用 Portainer Stacks（Compose），使部署声明式且可通过 Git 版本控制。；限制 Docker 套接字访问 —— Portainer 通过套接字有主机完全 root 权限；用强密码和（如有）MFA 保护 Portainer 登录。。其中首条「将 Portainer 放在带认证的反向代理后（Caddy + basic_auth 或 Cloudflare Access），避免 Docker 套接字暴露互联网。」应作为团队默认规范写入 IaC 模板。

管理 Docker 主机、栈、容器、镜像和卷的 Web UI —— 适合不完全用 CLI 的团队。

VPS 与自托管入门

为什么

Portainer 提供 Docker 主机上所有容器、日志、统计和栈的可视化概览，带团队 RBAC。它本身是单容器，设置仅需一条命令。适合需检查或重启容器而无需 SSH 的运维团队。

何时使用

管理少量 Docker 主机且想要 UI 的小团队使用 Portainer。大型集群应避免 —— 用 Kubernetes 或托管编排器。

Portainer CE 免费；BE 增加 RBAC 和边缘计算。

如何做

1. 为 Portainer 数据创建 Docker 卷。 2. 运行 Portainer 容器，暴露 9443（HTTPS）和 8000（边缘代理）。 3. 打开 https://<host>:9443 设置管理员密码。 4. 将本地 Docker 套接字连接为环境。 5. 从 UI 管理容器、栈（Compose）、镜像和卷。 ```bash docker volume create portainer_data docker run -d -p 8000:8000 -p 9443:9443 --name portainer \ --restart=always -v /var/run/docker.sock:/var/run/docker.sock \ -v portainer_data:/data portainer/portainer-ce:latest ```

示例

通过 Portainer Web 编辑器部署栈（Compose），等效于 'docker compose up'： ```yaml # 粘贴到 Portainer > Stacks > Add stack > Web editor services: web: image: nginx:alpine ports: ["8080:80"] restart: unless-stopped db: image: postgres:16 environment: { POSTGRES_PASSWORD: secret } volumes: ["db:/var/lib/postgresql/data"] restart: unless-stopped volumes: { db: {} } ``` Portainer 存储栈，可启停/更新，并显示每容器实时日志和统计。

常见问题

⚠无法连接 Docker 套接字 —— 套接字挂载缺失或容器无权限；确保 -v /var/run/docker.sock:/var/run/docker.sock 存在。
⚠9443 用自签证书 —— 浏览器警告；前置反向代理（Caddy/nginx）加真实证书，或导入 Portainer 生成证书。
⚠环境间配置漂移 — 使用基础设施即代码（Terraform/Pulumi）保持 dev/staging/prod 一致

最佳实践

✓将 Portainer 放在带认证的反向代理后（Caddy + basic_auth 或 Cloudflare Access），避免 Docker 套接字暴露互联网。
✓多容器应用用 Portainer Stacks（Compose），使部署声明式且可通过 Git 版本控制。
✓限制 Docker 套接字访问 —— Portainer 通过套接字有主机完全 root 权限；用强密码和（如有）MFA 保护 Portainer 登录。

常见问题解答

什么是Portainer（Docker UI）？它解决什么问题？

管理 Docker 主机、栈、容器、镜像和卷的 Web UI —— 适合不完全用 CLI 的团队。它可帮助开发者在不自建基础设施的前提下完成部署、存储与扩展，是云服务选型的核心参考。

如何在 5 分钟内上手Portainer（Docker UI）？

两步即可跑通：① 为 Portainer 数据创建 Docker 卷。；② 运行 Portainer 容器，暴露 9443（HTTPS）和 8000（边缘代理）。。建议先用免费套餐验证流程，再接入生产环境。