microserviceframework/portainer

Portainer 镜像文档

镜像概述

本镜像为适用于微服务框架核心栈的Portainer容器管理工具镜像。Portainer是一款开源的容器管理平台，通过直观的Web界面提供Docker环境的可视化管理能力，无需复杂的命令行操作，即可实现对容器、镜像、网络、卷等Docker资源的全生命周期管理。该镜像专为微服务框架核心栈设计，可无缝集成到微服务架构环境中，简化容器化应用的部署与运维流程。

核心功能和特性

• 可视化管理界面：提供直观的Web控制台，支持通过图形化界面管理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/portainer/micro-service-framework-core:latest

参数说明：

• -p 9000:9000：映射容器9000端口到主机，用于访问Web界面
• --name portainer：指定容器名称
• --restart always：设置容器自动重启
• -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/portainer/micro-service-framework-core:latest
    container_name: portainer
    restart: always
    ports:
      - "9000:9000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    environment:
      - TZ=Asia/Shanghai  # 设置时区

volumes:
  portainer_data:

访问与初始化

1. 启动容器后，通过浏览器访问 http://<主机IP>:9000
2. 首次访问需创建管理员账户（设置用户名和密码）
3. 选择"Local"选项管理本地Docker环境，或配置远程Docker环境连接

环境变量配置

持久化数据

Portainer的配置数据通过卷portainer_data持久化存储，包含用户配置、权限设置、连接信息等，确保容器重启后数据不丢失。