581_Portainer容器管理¶

# 创建数据卷（持久化 Portainer 数据）
docker volume create portainer_data  # 创建命名卷

# 运行 Portainer CE（社区版）
docker run -d \
  --name portainer \                               # 容器名
  --restart=always \                               # 自动重启
  -p 8000:8000 \                                   # TCP 隧道端口（Agent 通信用）
  -p 9443:9443 \                                   # HTTPS Web 管理界面端口
  -v /var/run/docker.sock:/var/run/docker.sock \   # 挂载 Docker socket（核心！）
  -v portainer_data:/data \                        # 持久化数据
  portainer/portainer-ce:lts                       # 使用长期支持版

# docker-compose.yml
services:
  portainer:
    image: portainer/portainer-ce:lts    # 社区版长期支持
    container_name: portainer            # 容器名
    restart: always                      # 自动重启
    ports:
      - "9443:9443"                      # HTTPS 管理面板
      - "8000:8000"                      # Agent 通信端口
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # Docker socket
      - portainer_data:/data             # 数据持久化

volumes:
  portainer_data:                        # 命名卷

docker compose up -d                     # 启动

# 浏览器打开：https://你的IP:9443
# 注意是 HTTPS（Portainer 2.9+ 默认启用 HTTPS）

# 首次访问设置管理员密码（至少12位）
# 选择 "Local" 管理本地 Docker 环境

# 在 Web 面板中（不用记命令！）：
#
# 查看容器列表：Home → Local → Containers
# 每个容器显示：名称、状态、镜像、端口、创建时间
#
# 常用操作（点击按钮）：
# - Start / Stop / Restart → 启动/停止/重启容器
# - Logs → 查看容器日志（实时滚动）
# - Console → 进入容器命令行（相当于 docker exec -it）
# - Stats → 查看 CPU/内存/网络使用率
# - Inspect → 查看容器详细配置

# Containers → Add Container
# 填写配置：
# - Name：容器名称
# - Image：镜像名（如 nginx:latest）
# - Port mapping：端口映射（如 8080→80）
# - Volumes：卷挂载
# - Env：环境变量
# - Restart policy：重启策略
# - Deploy the container → 创建并启动

# Stacks → Add Stack
# 方式1：Web editor → 直接粘贴 docker-compose.yml 内容
# 方式2：Upload → 上传 docker-compose.yml 文件
# 方式3：Git Repository → 从 Git 仓库拉取

# 示例（在 Web editor 中粘贴）：

services:
  web:
    image: nginx:alpine              # Nginx 镜像
    ports:
      - "8080:80"                    # 端口映射
    volumes:
      - ./html:/usr/share/nginx/html # 挂载网页目录

  db:
    image: postgres:16-alpine        # PostgreSQL
    environment:
      POSTGRES_PASSWORD: mypassword  # 设置密码
    volumes:
      - pgdata:/var/lib/postgresql/data

volumes:
  pgdata:

# Images → 查看本地所有镜像
# - Pull Image → 输入镜像名拉取（如 redis:7）
# - Build Image → 从 Dockerfile 构建
# - Remove → 删除不用的镜像
# - 显示镜像大小、标签、创建时间

# Networks → 查看/创建 Docker 网络
# - 创建自定义网络让容器之间通信
# - 支持 bridge / overlay / macvlan 等驱动

# Volumes → 查看/创建数据卷
# - 创建命名卷用于数据持久化
# - 查看卷的使用情况
# - 删除未使用的卷

# 方法1：通过 Agent 管理远程 Docker
# 在远程服务器上运行 Agent：
docker run -d \
  -p 9001:9001 \                                   # Agent 端口
  --name portainer_agent \                          # 容器名
  --restart=always \                                # 自动重启
  -v /var/run/docker.sock:/var/run/docker.sock \   # 挂载 Docker socket
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \ # 卷目录
  portainer/agent:lts                              # Agent 镜像

# 在 Portainer 中：
# Settings → Environments → Add Environment
# 选择 Agent → 填入远程IP:9001

# 方法2：Edge Agent（适合有防火墙的远程服务器）
# Environments → Add Environment → Edge Agent
# 复制生成的安装命令到远程服务器运行

# App Templates → 预配置的应用模板
# 一键部署常用服务：
# - WordPress + MySQL
# - Redis
# - GitLab CE
# - Elasticsearch
# - RabbitMQ
# - 更多...

# 也可以添加自定义模板仓库
# Settings → App Templates → 添加模板 URL

# Portainer Business Edition 支持：
# - RBAC（基于角色的访问控制）
# - LDAP / AD / OAuth / OIDC 集成
# - 团队管理和权限分配
# - 审计日志（记录谁做了什么操作）

# 角色示例：
# - Admin：完全管理权限
# - Helpdesk：只读 + 重启容器
# - Standard user：管理分配的资源

# Portainer 也支持管理 K8s 集群：
# Environments → Add Environment → Kubernetes
# 
# 支持的功能：
# - 查看/管理 Pods、Deployments、Services
# - 通过 GUI 部署应用（不用写 YAML）
# - 查看日志和终端
# - Helm Chart 部署
# - 查看资源使用情况

# === 安装 Portainer CE ===
docker volume create portainer_data
docker run -d --name portainer --restart=always \
  -p 9443:9443 -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data portainer/portainer-ce:lts

# === 安装 Agent（远程管理） ===
docker run -d --name portainer_agent --restart=always \
  -p 9001:9001 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  portainer/agent:lts

# === 更新 Portainer ===
docker stop portainer && docker rm portainer       # 停止并删除旧容器
docker pull portainer/portainer-ce:lts             # 拉取最新镜像
# 重新运行上面的 docker run 命令                     # 数据在 volume 中不会丢

# === 默认端口 ===
# 9443 → HTTPS Web UI（推荐）
# 9000 → HTTP Web UI（需手动启用）
# 8000 → TCP 隧道（Agent 通信）
# 9001 → Agent 端口

# === 面板导航 ===
# Home         → 所有环境概览
# Containers   → 容器管理
# Images       → 镜像管理
# Networks     → 网络管理
# Volumes      → 卷管理
# Stacks       → Stack（Compose）管理
# App Templates → 应用模板