portainer edge Agent安装（多域名）

Portainer Edge Agent 安装部署教程

本教程将详细介绍 Portainer Edge Agent 的完整安装和配置过程，包含实际生产环境中的常见问题和解决方案。

1. 概述

Portainer Edge Agent 是 Portainer 的边缘计算组件，用于管理远程 Docker 环境。它通过安全的隧道连接与 Portainer 服务器通信.

核心特性

• 安全隧道连接：通过端口 8000 建立 TLS 隧道
• 轻量级部署：最小资源占用
• 实时管理：支持容器、镜像、网络等完整管理

2. 环境准备

2.1 我的环境情况

• Docker Engine 28.3.3
• Portainer 服务器在云端，被管理端在本地机房
• 银河麒麟操作系统服务器版v10
• 鲲鹏CPU

2.2 网络要求

# Portainer 服务器需要开放的端口
- 8000: Edge Agent 隧道连接

# Edge Agent 设备要求
- 出站网络访问权限
- 能够访问 Portainer 服务器的 8000 端口

2.3 多域名

# 主服务域名
https://portainer.example.com

# 隧道服务域名（独立域名），为了方便管理
portainer-ws.example.com:8000

使用多域名，必须看3.2 最重要的一步

3. Portainer 服务器配置

3.1 启用 Edge Compute 功能

1. 登录 Portainer 管理界面

2. 进入设置页面：Settings → Edge Compute settings

3. 启用功能：

4. ✅ Enable Edge Compute features

5. ✅ Enforce use of Portainer generated Edge ID

3.2 最重要的一步

3.2.1 token base64解码

使用 www.base64decode.org/ ， 不要使用echo "$EDGE_KEY" | base64 -d

修改后，重新用https://www.base64encode.org/ base64编码。

4. 最终的命令

docker run -d \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/docker/volumes:/var/lib/docker/volumes \
  -v /:/host \
  -v portainer_agent_data:/data \
  --restart always \
  -e EDGE=1 \
  -e EDGE_ID=（保持不变） \
  -e EDGE_KEY=（最终生成的base64编码） \
  -e EDGE_INSECURE_POLL=1 \
  --name portainer_edge_agent \
  portainer/agent:2.32.0