794142134/portainer

Portainer Docker镜像文档

镜像概述

Portainer是一款开源的Docker可视化管理工具，提供直观的Web界面，用于管理Docker环境中的容器、镜像、网络、卷和Swarm集群。该镜像旨在简化Docker资源的管理流程，降低Docker使用门槛，适用于从个人开发者到小型团队的各类场景。

核心功能与特性

• 直观Web界面：通过图形化界面替代命令行操作，简化Docker资源管理
• 全面资源管理：支持容器、镜像、网络、卷的创建、删除、监控和配置
• 多环境支持：兼容单机Docker环境、Docker Compose应用及Swarm集群
• 权限控制：支持多用户管理，可配置细粒度的访问权限
• 轻量级部署：镜像体积小，资源占用低，部署简单快速

使用场景

• 个人开发者管理本地Docker环境
• 小型团队监控和维护Docker应用
• 教学环境中演示Docker操作和概念
• 快速搭建Docker管理平台，减少命令行操作复杂度

使用方法与配置说明

基本部署命令

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

docker
docker run -d -p 8000:9000 --name docker.xuanyuan.run/portainer -v /var/run/docker.sock:/var/run/docker.sock portainer

参数说明：

• -d：后台运行容器
• -p 8000:9000：端口映射，将主机8000端口映射到容器9000端口（Portainer默认端口）
• --name portainer：指定容器名称为portainer
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程 socket，使Portainer能够管理主机Docker环境

访问与初始化

1. 部署完成后，通过浏览器访问 http://<主机IP>:8000
2. 首次登录需设置管理员账号密码（用户名默认为admin）
3. 选择"Local"环境（通过挂载的docker.sock管理本地Docker），点击"Connect"完成初始化

数据持久化（推荐）

为避免容器重启后配置丢失，建议添加数据卷挂载：

docker
docker run -d -p 8000:9000 --name portainer \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data docker.xuanyuan.run/portainer

Docker Compose配置示例

创建docker-compose.yml文件：

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

volumes:
  portainer_data:

启动命令：docker-compose up -d

注意事项

• 挂载/var/run/docker.sock需要主机Docker权限，生产环境需评估安全风险
• 建议使用数据卷持久化配置，避免容器删除导致数据丢失
• 生产环境中可配置HTTPS，通过添加-p 443:9443并挂载证书实现安全访问