一、概述
本文档介绍如何在常见 Linux/FreeBSD 系统上快速部署 GoEdge 管理平台及其组件，并提供离线激活、替换节点包、屏蔽官方域名等实用步骤。
二、前提条件
- 系统支持：CentOS 5/6/7/8/9、RockyLinux9、Fedora、Debian、Ubuntu、FreeBSD
- 软件依赖：
unzip、wget、curl - 网络环境：首次部署需访问外部镜像或使用国内 CDN；后续可通过屏蔽官方域名实现离线安装
- 端口需求：管理平台默认监听
7788，请确保防火墙已放通
三、安装 unzip 工具
不同系统对应命令如下：
# CentOS 5/6/7
sudo yum -y install unzip
# RedHat/CentOS 8/9、RockyLinux9、Fedora
sudo dnf -y install unzip
# Debian / Ubuntu
sudo apt install unzip
# FreeBSD
pkg install unzip
四、屏蔽 GoEdge 官方域名
为防止安装/升级时自动访问公网，建议将以下域名指向本地：
echo "127.0.0.1 goedge.cn" | sudo tee -a /etc/hosts >/dev/null
echo "127.0.0.1 goedge.cloud" | sudo tee -a /etc/hosts >/dev/null
echo "127.0.0.1 dl.goedge.cn" | sudo tee -a /etc/hosts >/dev/null
echo "127.0.0.1 dl.goedge.cloud" | sudo tee -a /etc/hosts >/dev/null
echo "127.0.0.1 global.dl.goedge.cn" | sudo tee -a /etc/hosts >/dev/null
echo "127.0.0.1 global.dl.goedge.cloud"| sudo tee -a /etc/hosts >/dev/null
或手动编辑 /etc/hosts，添加：
127.0.0.1 goedge.cn
127.0.0.1 goedge.cloud
127.0.0.1 dl.goedge.cn
127.0.0.1 dl.goedge.cloud
127.0.0.1 global.dl.goedge.cn
127.0.0.1 global.dl.goedge.cloud
五、创建安装目录
sudo mkdir -p /usr/local/goedge
cd /usr/local/goedge
六、下载并解压管理平台程序包
国际源（Cloudflare）
# X86_64
wget https://static-file-global.353355.xyz/goedge/edge-admin-linux-amd64-plus-v1.3.9.zip
# aarch64
wget https://static-file-global.353355.xyz/goedge/edge-admin-linux-arm64-plus-v1.3.9.zip
国内源（阿里云 CDN）
# X86_64
wget https://fj.ly93.cc/37/1809553326/edge-admin-linux-amd64-plus-v1.3.9.zip
# aarch64
wget https://fj.ly93.cc/37/1809551208/edge-admin-linux-arm64-plus-v1.3.9.zip
unzip -o ./edge-admin-linux-*-plus-v1.3.9.zip
七、启动管理平台
cd edge-admin/
bin/edge-admin start
- 启动成功会提示：
Edge Admin started ok, pid: xxxx - 使用
ps ax | grep edge-admin可确认进程是否存在 - 日志位于
logs/run.log，用于排查启动问题 - 默认监听端口：
7788，浏览器访问http://<服务器IP>:7788/
提示：若开启防火墙，请确保放通 TCP 7788 端口。
八、安装管理平台为系统服务
cd edge-admin/
bin/edge-admin service
九、安装 MySQL（如果尚未部署）
sudo curl -s https://static-file-global.353355.xyz/goedge/mysql/install-mysql.sh | bash
十、替换边缘节点程序包
确保管理平台使用的边缘节点程序为安全版本：
cd /usr/local/goedge/edge-admin/edge-api/deploy
rm -f *.zip
# 国际源
wget -O edge-node-linux-amd64-v1.3.9.zip https://static-file-global.353355.xyz/goedge/edge-node-linux-amd64-plus-v1.3.9.zip
wget -O edge-node-linux-arm64-v1.3.9.zip https://static-file-global.353355.xyz/goedge/edge-node-linux-arm64-plus-v1.3.9.zip
# 或国内源
wget -O edge-node-linux-amd64-v1.3.9.zip https://fj.ly93.cc/37/1809540483/edge-node-linux-amd64-plus-v1.3.9.zip
wget -O edge-node-linux-arm64-v1.3.9.zip https://fj.ly93.cc/37/1809540478/edge-node-linux-arm64-plus-v1.3.9.zip
十一、离线激活商业旗舰版
在浏览器中打开管理平台，依次进入：系统设置 → 商业版本 → 激活
粘贴以下注册码完成离线激活，永久免费：
F4BuVYEKSDWV+I13ISd5NUyBcWOlH0af4/ow9obzYBS3XvYC9IsK86k5UDyyBv9vqJWN2/FQTDbPyuAO0zxYlkLDC0c8rrShs+7PAkqM0O8wBIGknzForgidDZahky5Lo/ZWaPZ1dVFUxmV29ykb0I0b4tv7Q3OtnTylOuzf//MYrlvyw6VJQMGnsttmeHzsNL/r0yDONOEXZoGoLZsuBKnkfXt+qt6bZF+kM1ncbh+sY42BrPTWQ12sXqJS3qHlzU0FFl9lTNzLGYYhq5vi/4sJuPVE50/uLCtslTJdb9zOGR915hnM+jHYsR+jUk0QxOqtreaHpsvNuLkexXbkmA==
十二、边缘节点安装
- 浏览器中进入：边缘节点 → 创建节点
- 填写节点名称、公网 IP、SSH 端口及登录信息
- 点击“远程安装”，即可一键部署安全版本的边缘节点
- 安装完成后，建议在节点服务器上重复第四步中的 hosts 屏蔽操作，以彻底隔离官方域名
十三、用户平台安装（可选，仅商业化运营需要）
cd /usr/local/goedge
下载并解压
# 国际源
wget https://static-file-global.353355.xyz/goedge/edge-user-linux-amd64-v1.3.9.zip
wget https://static-file-global.353355.xyz/goedge/edge-user-linux-arm64-v1.3.9.zip
# 国内源
wget https://fj.ly93.cc/37/1809540410/edge-user-linux-amd64-v1.3.9.zip
wget https://fj.ly93.cc/37/1809540413/edge-user-linux-arm64-v1.3.9.zip
unzip -o ./edge-user-linux-*.zip
在管理平台中添加用户节点
- 依次进入：系统设置 → 高级设置 → 用户节点 → 添加节点
- 填写节点名称、监听端口（建议80/443）
- 点击“安装节点”，复制生成的配置内容
配置并启动
mkdir -p /usr/local/goedge/edge-user/configs
vi /usr/local/goedge/edge-user/configs/api_user.yaml # 粘贴配置内容
cd edge-user/
bin/edge-user start
bin/edge-user service
同样建议在节点上屏蔽官方域名。
十四、智能 DNS 模块安装（可选）
cd /usr/local/goedge
下载并解压
# 国际源
wget https://static-file-global.353355.xyz/goedge/edge-dns-linux-amd64-v1.3.9.zip
wget https://static-file-global.353355.xyz/goedge/edge-dns-linux-arm64-v1.3.9.zip
# 国内源
wget https://fj.ly93.cc/37/1809540514/edge-dns-linux-amd64-v1.3.9.zip
wget https://fj.ly93.cc/37/1809540511/edge-dns-linux-arm64-v1.3.9.zip
unzip -o ./edge-dns-linux-*.zip
在管理平台中添加 DNS 节点
- 智能DNS → 集群管理（首次需先创建集群）
- 点击“创建节点”，填写名称、公网 IP
- 点击节点名称 → “安装节点”，复制配置内容
配置并启动
mkdir -p /usr/local/goedge/edge-dns/configs
vi /usr/local/goedge/edge-dns/configs/api_dns.yaml # 粘贴配置内容
cd edge-dns/
bin/edge-dns service
同样建议在节点上屏蔽官方域名。
十五、常用排查命令
查看端口占用（53/7788）
sudo netstat -tuln | grep -E ":53|:7788"释放 53 端口
sudo systemctl stop systemd-resolved sudo systemctl disable systemd-resolved vi /etc/resolv.conf # 填写： nameserver 8.8.8.8 nameserver 8.8.4.4
十六、参考资料
- GoEdge 官方文档：https://goedge.cloud/docs
- GoEdge 镜像存档：https://drive.google.com/drive/folders/1-2JbKiNy-MWF7RLnIUIRXiT-AE37rUDx
至此，GoEdge 管理平台及各组件已完成安装，按界面提示进行后续配置即可开始使用。如遇问题，请检查日志或参考官方文档。
评论区