zerolabssyseng/portainer

Portainer容器

镜像概述

Portainer容器是一个轻量级的Docker管理工具，基于Web界面提供Docker环境的可视化管理功能。该镜像基于zerolabssyseng/base-consul构建，集成Portainer 1.22.0版本，支持容器、镜像、网络、卷的全生命周期管理，以及用户权限控制和多环境配置，适用于简化Docker环境的日常运维操作。

核心功能与特性

• 版本信息：集成Portainer 1.22.0稳定版本，确保功能兼容性
• 用户隔离：创建独立的portainer用户和组，增强运行安全性
• 数据持久化：通过/var/lib/portainer卷实现配置和数据持久化存储
• 端口暴露：默认暴露9000端口，用于Web管理界面访问
• 环境变量支持：可通过环境变量配置Portainer版本、工作目录、模板等参数
• 灵活部署：支持通过make命令构建/推送镜像，或使用Docker Compose快速部署

使用场景

• 开发环境：开发者通过Web界面快速管理本地Docker容器和镜像
• 生产环境：系统管理员可视化监控和管理Docker集群资源
• 多环境配置：通过环境变量和模板适配不同部署环境（如本地、测试、生产）

使用方法

Makefile操作

通过Makefile提供镜像构建、清理、拉取和推送功能，支持以下命令：

bash
# 清理本地镜像
make clean-local

# 构建镜像（需指定TAG参数）
make build TAG=latest

# 拉取远程镜像
make pull TAG=latest

# 构建并推送镜像
make push TAG=latest

Docker Compose部署示例

以下是基础的Docker Compose配置模板，用于快速部署Portainer容器：

yaml
version: '3.5'

volumes:
    portainer:  # 持久化Portainer数据

services:
    portainer:
        image: zerolabssyseng/portainer:latest
        container_name: zerolabssyseng_portainer
        ports:
            - "9000:9000"  # 映射Web管理界面端口
        volumes:
            - /etc/localtime:/etc/localtime:ro  # 同步主机时间
            - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker守护进程套接字，实现容器管理
            - portainer:/var/lib/portainer  # 持久化Portainer数据
        environment:
            - ENV=local  # 环境名称（如local、test、prod）
            - PORTAINER_TEMPLATE=generic  # 配置模板类型
            - PORTAINER_VERSION=1.22.0  # Portainer版本号
            - PORTAINER_HOME=/var/lib/portainer  # 工作目录
            #- PORTAINER_OPTIONS=  # 额外Portainer启动参数（可选）

启动命令：

bash
docker-compose up -d

环境变量说明

数据持久化

通过挂载/var/lib/portainer卷（如Compose示例中的portainer卷），确保Portainer的配置、用户数据和管理状态在容器重启后不丢失。

访问方式

部署完成后，通过浏览器访问 http://<主机IP>:9000 即可打开Portainer Web管理界面，首次访问需创建管理员账户。