portainer/kube-tools

Portainer Docker镜像文档

1. 镜像概述与主要用途

Portainer Docker镜像是Portainer官方提供的容器化部署包，集成了Docker客户端、kubectl工具及kind（Kubernetes IN Docker），旨在提供一站式容器及Kubernetes集群管理解决方案。该镜像通过图形化界面（GUI）简化Docker环境和Kubernetes集群的管理流程，支持从开发、测试到生产环境的全生命周期容器运维。

2. 核心功能与特性

2.1 容器与镜像管理

• 图形化界面直观管理Docker容器、镜像、网络及数据卷
• 支持容器生命周期操作（创建、启动、停止、重启、删除等）
• 镜像拉取、构建、推送及本地镜像管理

2.2 Kubernetes集群支持

• 内置kubectl工具，支持Kubernetes资源（Pod、Deployment、Service等）的可视化管理
• 集成kind（Kubernetes IN Docker），支持本地Kubernetes集群的快速部署与调试
• 多Kubernetes集群统一管理，支持集群健康监控与资源使用率分析

2.3 多环境统一管理

• 支持管理本地Docker环境、远程Docker主机、Kubernetes集群、Docker Swarm等多种容器环境
• 环境分组与标签管理，实现跨环境资源统一视图

2.4 安全与权限控制

• 基于角色的访问控制（RBAC），支持多用户与团队权限配置
• 操作审计日志，记录所有管理行为，满足合规性要求
• 支持TLS加密通信，保障数据传输安全

2.5 便捷工具集成

• 内置Docker客户端，可直接在界面中执行Docker命令
• 集成文件浏览器，支持容器内文件上传/下载与编辑
• 实时日志查看与容器控制台交互

3. 使用场景与适用范围

3.1 开发环境容器管理

• 本地Docker容器的快速启停与调试
• 开发环境镜像构建与测试
• 本地Kubernetes集群（基于kind）的应用部署验证

3.2 中小型生产环境运维

• 容器集群的日常监控与管理
• 资源使用率跟踪与性能优化
• 多环境统一运维入口，降低管理复杂度

3.3 教学与演示

• 容器技术入门教学的可视化工具
• Kubernetes基础操作演示平台
• 团队内部容器化部署流程培训

4. 使用方法与部署示例

4.1 快速启动（docker run）

本地Docker环境管理（推荐）：

bash
docker run -d \
  --name portainer \
  --restart always \
  -p 9000:9000 \
  -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/var/lib/portainer \
  docker.xuanyuan.run/portainer/portainer-ce:latest

说明：

• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程 socket，实现对本地Docker环境的管理
• -v portainer_data:/var/lib/portainer：持久化存储Portainer配置数据（推荐使用命名卷）
• -p 9000:9000：Web管理界面端口
• -p 8000:8000：Edge代理端口（用于管理远程Edge环境）
• --restart always：容器异常退出后自动重启

4.2 Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'

services:
  portainer:
    image: docker.xuanyuan.run/portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "9000:9000"  # Web管理界面
      - "8000:8000"  # Edge代理端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 本地Docker管理
      - portainer_data:/var/lib/portainer          # 配置数据持久化
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      # - ADMIN_PASSWORD=your_secure_password  # 可选：预设置管理员密码（需加密）

volumes:
  portainer_data:  # 自动创建命名卷，持久化Portainer数据

启动命令：

bash
docker-compose up -d

5. 配置说明

5.1 挂载目录说明

5.2 端口映射说明

5.3 环境变量配置

6. 注意事项

1. Docker Socket挂载安全：
   挂载/var/run/docker.sock会赋予Portainer容器管理主机Docker的权限，生产环境建议通过TLS限制访问范围，或使用Portainer Agent替代直接挂载socket。

2. 数据持久化：
   务必挂载portainer_data卷以持久化配置，避免容器重建后数据丢失。

3. 生产环境安全加固：

   • 启用HTTPS（配置9443端口及证书）
   • 设置强管理员密码并定期更换
   • 限制9000/9443端口的访问IP（通过防火墙或反向代理）

4. kind集群管理：
   如需通过Portainer管理本地kind集群，需确保容器内kubectl配置正确指向kind集群（通常通过挂载~/.kube/config至容器/root/.kube/config实现）。

7. 访问与初始化

1. 部署完成后，通过http://<主机IP>:9000访问Web界面
2. 首次登录需设置管理员账号密码
3. 根据向导选择管理环境（本地Docker/远程Docker/Kubernetes等）
4. 完成初始化后即可开始使用图形化界面管理容器环境