跳到主要内容

Linux (软路由) 部署

GoRelay 提供一键安装脚本，适用于各种 Linux 发行版及 OpenWrt 等嵌入式系统。脚本会自动检测系统架构并下载对应版本的 Agent，让局域网内所有设备无需安装客户端即可享受中继加速服务。

前提条件​

  • 已注册 GoRelay 账号并购买套餐
  • 已在控制台创建中继规则
  • 设备可正常联网，已安装 curl
信息

账号注册、套餐购买和规则创建请参考：快速开始 · 注册账号 · 创建中继

支持的系统与架构​

脚本会根据 uname -m 自动识别架构并拉取对应二进制，常见对应关系如下：

架构常见设备
x86_64软路由、虚拟机、常规 Linux 服务器
aarch64树莓派 4、R2S/R4S、部分高端路由器
arm树莓派 2/3、部分中端路由器
mipsel小米、极路由等 MT7621 设备
mips部分 QCA/高通方案路由器
提示

脚本下载页：https://gorelay.net/downloads

一键安装​

执行下列命令即可自动完成下载、安装并配置开机自启。请根据您的系统选择对应命令：

Linux 发行版（Debian / Ubuntu / CentOS / Alpine 等，使用 systemd 或 OpenRC）：

curl -fsSL https://dl.gorelay.net/linux/install.sh | sudo sh

OpenWrt（BusyBox 环境，默认无 sudo，以 root 直接执行）：

curl -fsSL https://dl.gorelay.net/linux/install.sh | ash
信息

OpenWrt 使用 BusyBox 的 ash 作为默认 shell，且默认以 root 登录，因此无需 sudo；脚本会识别 OpenWrt 环境并注册为 /etc/init.d/gorelay-agent 服务。

安装完成后，脚本会输出 Web 管理地址（默认监听 18080 端口）。在浏览器中访问：

http://<设备IP>:18080

使用您的 GoRelay 账号密码登录，点击「启动」即可连接中继服务。

信息

安装脚本会自动完成：架构识别、二进制下载、安装到系统目录、注册为系统服务（systemd 或 OpenWrt init.d）并设置开机自启。

升级​

使用升级脚本拉取最新版本并自动重启服务：

Linux 发行版：

curl -fsSL https://dl.gorelay.net/linux/upgrade.sh | sudo sh

OpenWrt：

curl -fsSL https://dl.gorelay.net/linux/upgrade.sh | ash

卸载​

一键卸载会停止服务、删除二进制及服务文件：

Linux 发行版：

curl -fsSL https://dl.gorelay.net/linux/uninstall.sh | sudo sh

OpenWrt：

curl -fsSL https://dl.gorelay.net/linux/uninstall.sh | ash

查看连接信息​

部署成功并在 Web 界面点击「启动」后，进入 GoRelay 控制台，打开「中继 → 中继列表」，查看：

  • 入口信息：运行 GoRelay 客户端/App 设备的局域网 IP（即您当前这台 Linux / 软路由设备的 IP）
  • 监听端口：此规则对应的端口号

将以上信息填入需要加速的应用程序，即可开始使用中继服务。详见 应用接入配置。

常见问题​

如何确认设备架构？​

uname -m

常见输出对应关系：x86_64 → x86_64，aarch64 → aarch64，armv7l → arm，mips → mips，mipsel → mipsel。

OpenWrt 没有 curl？​

可先安装或改用 wget：

# 方式一：安装 curl
opkg update && opkg install curl ca-bundle

# 方式二：使用 wget（BusyBox 自带）
wget -O- https://dl.gorelay.net/linux/install.sh | ash

提示 "Exec format error"？​

通常是脚本未能正确识别架构。请执行 uname -m 确认架构，并在 下载页面 反馈或手动下载对应版本。

服务启动后连接失败？​

  • 确认设备 DNS 解析正常
  • 检查防火墙是否放行了 Web 管理端口（默认 18080）及中继规则端口
  • 查看服务日志定位问题（见下）

如何查看运行日志？​

# systemd 系统（大多数 Linux 发行版）
journalctl -u gorelay-agent -f

# OpenWrt
logread | grep gorelay

存储空间不足（OpenWrt）？​

GoRelay Agent 二进制约 20-30 MB。如果路由器闪存较小，可：

  • 挂载 USB 存储，将二进制文件放在 USB 上
  • 使用 extroot 扩展根分区