jodis/portainer

Portainer Docker镜像文档

镜像概述

Portainer是一款开源的Docker环境管理工具，通过直观的Web界面提供Docker环境的全生命周期管理。它支持管理Docker容器、镜像、网络、卷、配置等资源，适用于从个人开发者到企业级的各类Docker环境，帮助用户简化Docker操作，提高管理效率。

核心功能与特性

• Web界面管理：提供直观的图形化界面，无需命令行即可完成Docker资源管理
• 多环境支持：支持管理本地Docker引擎、Docker Swarm集群、Kubernetes集群等多种环境
• 容器生命周期管理：支持容器的创建、启动、停止、重启、删除等操作，实时查看容器状态与日志
• 镜像管理：支持镜像的拉取、构建、推送、删除，以及镜像仓库配置
• 网络与卷管理：可视化管理Docker网络（桥接、主机、覆盖网络等）和数据卷，支持卷的创建与挂载配置
• 用户权限控制：支持多用户管理，可配置细粒度的权限控制，适合团队协作
• 监控与日志：实时监控容器资源使用情况，查看容器运行日志，便于问题排查

使用场景与适用范围

• 开发环境：个人开发者或小型团队快速管理本地Docker环境，简化应用测试与部署
• 生产环境：企业级Docker Swarm或Kubernetes集群的可视化管理，降低运维复杂度
• 团队协作：多用户权限管理，实现不同角色对Docker资源的安全访问与操作
• 学习与教学：直观展示Docker核心概念与操作，帮助初学者快速掌握Docker技术

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速部署Portainer容器：

bash
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

参数说明：

• -p 8000:8000：映射Portainer的TCP隧道端口（用于远程Docker环境连接）
• -p 9443:9443：映射Portainer的Web界面HTTPS端口
• --restart=always：容器退出时自动重启
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程 socket，实现对本地Docker的管理
• -v portainer_data:/data：挂载数据卷，持久化Portainer配置与数据

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "8000:8000"
      - "9443:9443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

执行部署命令：

bash
docker-compose up -d

访问与初始化

1. 部署完成后，通过浏览器访问 https://<服务器IP>:9443（首次访问会生成自签名证书，需信任证书）
2. 首次登录需创建管理员账户（设置用户名和密码）
3. 选择管理环境：本地Docker（通过挂载的docker.sock）或远程Docker环境（输入远程Docker API地址）
4. 完成配置后即可进入Portainer管理界面，开始管理Docker资源

环境变量配置

Portainer支持通过环境变量自定义配置，常用变量包括：

• ADMIN_USERNAME：默认管理员用户名（仅首次启动有效）
• ADMIN_PASSWORD：默认管理员密码（需使用BCrypt加密，仅首次启动有效）
• PORT：Web界面HTTP端口（默认9000，CE版本推荐使用9443 HTTPS端口）
• SSL_CERT_FILE：自定义SSL证书路径
• SSL_KEY_FILE：自定义SSL密钥路径

示例（使用自定义管理员账户）：

bash
docker run -d -p 9443:9443 --name portainer \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD='$2y$10$xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest

注：ADMIN_PASSWORD需使用BCrypt算法加密，可通过在线工具或htpasswd生成。