homecentr/portainer

HomeCentr - Portainer

镜像概述和主要用途

本Docker镜像是原始Portainer的重新打包版本，符合HomeCenter Docker镜像标准（包含S6 overlay、权限降低等特性）。Portainer是一款轻量级的Docker管理工具，提供直观的Web UI界面，用于管理Docker容器、镜像、网络和卷等资源。

核心功能和特性

• 基于官方Portainer构建，保留其完整的Docker管理功能
• 集成S6 overlay进程管理系统，符合HomeCenter镜像标准
• 支持权限降低（privilege drop），初始以root权限启动，完成配置后切换至指定用户运行
• 可通过环境变量灵活配置启动参数、DNS记录等待等功能
• 支持Docker Swarm环境中的代理自动发现

使用场景和适用范围

适用于需要通过Web界面管理Docker环境的用户，尤其适合：

• 个人开发者或小型团队管理本地Docker环境
• Docker Swarm集群环境中需要集中管理容器资源的场景
• 对容器安全性有要求，需要权限控制的环境

使用方法和配置说明

Docker Compose示例

yaml
version: "3.7"
services:
  portainer:
    image: homecentr/portainer
    restart: unless-stopped
    environment:
      PORTAINER_ARGS: "--no-auth"  # Portainer启动参数
      WAIT_FOR_NS_RECORD: "tasks.agent"  # 启动前需解析的DNS记录
      WAIT_FOR_NS_RECORD_TIMEOUT: 30  # DNS记录解析超时时间
    healthcheck:
      start_period: 40s  # 健康检查启动延迟
    ports:
      - "9000:9000/tcp"  # Web UI端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 挂载Docker socket

环境变量

使用DNS记录等待功能时，必须按示例设置健康检查的启动延迟（约10秒 + DNS记录超时时间），可通过compose文件中的service.healthcheck.start_period属性或命令行参数设置。否则健康检查可能在Portainer进程启动前开始，导致检查失败和容器无限重启。

暴露端口

卷挂载

在Docker Swarm外部使用时，确保挂载Docker socket（/var/run/docker.sock）。

安全

容器定期进行漏洞扫描和更新，更多信息可查看https://github.com/homecentr/docker-portainer/security%E3%80%82

容器用户

容器支持权限降低：虽然容器以root权限启动，但仅在初始配置阶段使用该权限，Portainer进程最终以PUID和PGID环境变量指定的用户身份运行。

⚠️ 请勿通过Docker Compose的user属性或--user命令行参数直接修改容器用户，这会破坏权限降低逻辑。

💡 要授予用户读取Docker socket的权限，可将PGID设置为主机上docker组的ID。