dockerframework/portainer

Portainer容器

镜像概述和主要用途

Portainer是一款针对Docker的简单管理界面（Simple Management UI for Docker），属于Docker框架容器。它通过直观的Web界面，帮助用户轻松管理Docker环境中的容器、镜像、网络、卷等资源，无需复杂的命令行操作，降低了Docker管理的技术门槛。

核心功能和特性

• 直观Web界面：提供图形化操作界面，替代复杂的Docker命令行操作
• 全面资源管理：支持管理Docker容器、镜像、网络、卷、配置等核心资源
• 用户权限控制：可配置不同用户角色及权限，保障管理安全性
• 多环境支持：兼容单机Docker环境和Docker Swarm集群
• 状态监控：实时展示Docker资源使用情况和运行状态
• 操作日志：记录用户操作历史，便于审计和问题排查

使用场景和适用范围

• 开发环境：开发人员快速管理本地Docker容器和镜像
• 测试环境：测试团队便捷部署和管理测试用Docker资源
• 小型生产环境：中小企业或团队管理Docker单机或小型集群
• 学习环境：Docker初学者通过可视化界面理解Docker核心概念和操作

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  -p 9000:9000 \
  --name portainer \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  docker.xuanyuan.run/dockerframework/portainer:2.0

参数说明：

• -p 9000:9000：映射容器9000端口到主机9000端口，用于访问Web界面
• --name portainer：指定容器名称为portainer
• --restart always：设置容器随Docker服务自动启动
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程 socket，使Portainer能管理主机Docker环境
• -v portainer_data:/data：创建数据卷持久化Portainer配置和数据

Docker Compose配置

yaml
version: '3'
services:
  portainer:
    image: docker.xuanyuan.run/dockerframework/portainer:2.0
    container_name: portainer
    restart: always
    ports:
      - "9000:9000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data

volumes:
  portainer_data:

访问和初始设置

1. 部署完成后，通过http://<主机IP>:9000访问Portainer Web界面
2. 首次访问需创建管理员账户（设置用户名和密码）
3. 选择"Local"选项管理本地Docker环境，或添加远程Docker环境

环境变量配置

目前该镜像主要通过卷挂载和端口映射进行配置，暂无额外必需环境变量。如有高级需求，可参考官方文档进行自定义配置。