Portainer Docker镜像文档

镜像概述和主要用途

Portainer Docker镜像是Portainer容器管理平台的官方容器化分发形式。Portainer是一款轻量级、可视化的容器管理工具，旨在简化Docker及Kubernetes环境的管理流程。通过图形化界面，用户可直观操作容器、镜像、网络、数据卷等Docker资源，无需依赖命令行，降低容器技术的使用门槛。

核心功能和特性

1. 全图形化管理界面：支持容器、镜像、网络、数据卷的创建、启动、停止、删除等生命周期操作，实时展示资源状态。
2. 多环境兼容：支持管理单机Docker、Docker Swarm集群、Kubernetes集群等多种容器环境。
3. 用户权限控制：提供细粒度的角色与权限管理，支持多用户隔离（如管理员、普通用户、只读用户）。
4. 镜像仓库集成：支持对接Docker Hub、私有镜像仓库（如Harbor），实现镜像拉取、推送、搜索与标签管理。
5. 监控与日志：实时监控容器CPU、内存、网络等资源占用，支持查看容器运行日志与历史记录。
6. 数据持久化：支持配置数据（如用户信息、权限策略）持久化存储，避免容器重启后数据丢失。

使用场景和适用范围

• 开发人员：快速管理本地Docker环境，简化测试与调试流程。
• 运维人员：高效监控和维护生产环境中的容器集群，降低操作复杂度。
• 小型团队/企业：无需专业容器技术背景，即可实现标准化的容器资源管理。
• 教学与学***：作为容器技术入门工具，直观理解Docker核心概念（如镜像、容器、网络）。

使用方法和配置说明

前置条件

• 已安装Docker Engine（版本1.12+）或Docker Desktop。
• 确保主机网络可访问镜像仓库（如拉取portainer/portainer-ce镜像）。

基础使用（Docker Run命令）

社区版（CE）部署

# 拉取最新版Portainer CE镜像
docker pull portainer/portainer-ce:latest

# 启动容器（持久化数据+本地Docker环境管理）
docker run -d \
  -p 9000:9000 \  # 映射Web界面端口（宿主机:容器）
  -p 8000:8000 \  # 可选，用于Portainer Agent通信（Swarm/K8s集群场景）
  --name portainer \
  --restart always \  # 容器退出后自动重启
  -v /var/run/docker.sock:/var/run/docker.sock \  # 挂载Docker守护进程套接字，实现本地Docker管理
  -v portainer_data:/var/lib/portainer \  # 持久化数据卷（存储用户配置、权限等）
  portainer/portainer-ce:latest

企业版（EE）部署

需替换镜像为portainer/portainer-ee:latest，其他参数与社区版一致。

Docker Compose配置示例

创建docker-compose.yml文件，内容如下：

version: '3.8'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "9000:9000"  # Web界面端口
      - "8000:8000"  # Agent通信端口（可选）
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 本地Docker环境接入
      - portainer_data:/var/lib/portainer  # 数据持久化
volumes:
  portainer_data:  # 自动创建命名卷（推荐，优于宿主机目录挂载）

启动命令：docker-compose up -d

关键配置参数说明

环境变量

数据卷挂载

• /var/run/docker.sock：必须挂载（除非仅管理远程环境），用于Portainer访问本地Docker守护进程。
• /var/lib/portainer：存储Portainer配置数据（用户信息、权限策略等），必须持久化（推荐使用命名卷）。

访问与初始化

1. 容器启动后，通过http://<主机IP>:9000访问Web界面。
2. 首次登录需设置管理员密码（若未通过ADMIN_PASSWORD环境变量预设）。
3. 选择管理环境类型（如“Local”本地Docker、“Remote”远程Docker、“Kubernetes”等），完成初始化。

升级与卸载

• 升级：停止旧容器→拉取新版镜像→使用相同参数重新启动（数据卷会保留配置）。
• 卸载：

  docker stop portainer && docker rm portainer  # 停止并删除容器
  docker volume rm portainer_data  # 可选，删除持久化数据（谨慎操作）