Portainer CE · 轻量级容器化应用管理平台（Docker / Swarm / K8s）· 中文部署与使用全指南
项目仓库： https://github.com/portainer/portainer
开源协议：zlib · 形态：单容器（Linux / Windows 原生） · 环境：Docker / Docker Swarm / Kubernetes / Azure ACI · 端口：9000（CE 管理界面）、8000（边缘 agent，可选）
1 项目简介
Portainer Community Edition（CE，仓库名
portainer/portainer）是一个轻量级容器化应用服务交付平台，用来管理
Docker、Swarm、Kubernetes 和 ACI
环境。它部署简单、使用简单：一个容器就能跑在任何集群上，通过"聪明"的 GUI
和 / 或完整 API 管理所有编排器资源（容器、镜像、卷、网络等）。
Portainer 有开源 CE 与商业 BE（含 RBAC、支持等企业功能）之分；本文讲 CE。
1.1 核心信息一览
| 项目项 | 内容 |
|---|---|
| 项目名称 | Portainer Community Edition |
| 仓库地址 | github.com/portainer/portainer |
| 项目定位 | 容器化应用轻量管理平台 |
| 开源协议 | zlib |
| 形态 | 单容器（Linux / Windows 原生） |
| 环境 | Docker / Swarm / Kubernetes / Azure ACI |
| 端口 | 9000（管理界面）、8000（边缘 agent，可选） |
| 支持 Docker 版本 | 当前及前一个版本（Current - 2） |
1.2 适用场景
- 想用图形界面管理 Docker / Swarm / K8s 的容器、镜像、卷、网络。
- 不想在命令行里维护 compose，想要一个 Web 面板。
- 多环境（本机 Docker、远程 K8s）集中管理。
1.3 能力边界（官方口径）
- CE 是社区版，BE 额外有 RBAC、商业支持。
- 仅支持当前及前一个 Docker 版本；更早版本可能能跑但不受支持。
- 首次启动可选关闭 Matomo 匿名分析（GDPR 合规）。
2 功能特性
- 全资源 GUI：容器、镜像、卷、网络、Stack。
- 多编排器：Docker / Swarm / Kubernetes / Azure ACI。
- API：完整 API 可程序化管理。
- 单容器部署：一个容器跑起来。
- 公共 Demo：demo.portainer.io（admin / tryportainer，每 15 分钟重置）。
3 官方界面预览
封面为 Portainer 官方横幅。管理界面在
https://<主机>:9000，首次进入设置 admin 密码。
4 官方跳转链接汇总
| 类别 | 链接 | 说明 |
|---|---|---|
| 仓库主页 | https://github.com/portainer/portainer | 源码与 README |
| 部署文档 | docs.portainer.io/start/install | CE 安装 |
| 文档 | documentation.portainer.io | 完整文档 |
| Demo | demo.portainer.io | 公共演示（admin/tryportainer） |
| 产品对比 | portainer.io/products | CE vs BE |
5 前置要求
- Docker（管理本机 Docker 时）或 Kubernetes 集群。
- 开放 9000（管理界面）；8000 仅边缘 agent 模式需要。
6 方式一：Docker 部署 Portainer CE
# 创建数据卷并启动
docker volume create portainer_data
docker run -d -p 8000:8000 -p 9000:9000 \
--name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:latest启动后访问 https://<主机>:9000，首次进入设置 admin
密码并连接本地 Docker 环境。
7 方式二：Kubernetes / 其他环境
按官方部署文档（docs.portainer.io/start/install）选择
Kubernetes YAML 或其他环境；Portainer 也支持 Windows 原生容器。
8 配置项说明
- 数据卷
portainer_data存配置与用户。 - 挂载
/var/run/docker.sock管理本机 Docker。 - 8000 端口仅在边缘 agent（Edge Agent）模式使用，不需要可不暴露。
- 首次启动向导：设置 admin 密码、选择管理环境。
9 常用运维命令
docker logs -f portainer
docker restart portainer
docker pull portainer/portainer-ce:latest && docker rm -f portainer && docker run ... # 更新10 常见故障排查
- 9000 打不开：确认端口映射与防火墙；用 HTTPS 访问。
- 连不上本机 Docker：确认挂载了
/var/run/docker.sock。 - Docker 版本不受支持：官方只支持 Current - 2 个版本。
- 首次忘记 admin 密码：数据卷重置会丢配置，谨慎处理。
11 风险与合规说明
- zlib 许可；Portainer 挂载 Docker socket，等同完整 Docker 控制权，管理界面务必强密码 + 反向代理鉴权，不要把 9000 裸露公网。
- 首次启动可选关闭 Matomo 匿名分析。
- 本文命令、端口来自官方 README 与文档，随版本可能调整，以 docs.portainer.io 为准。