跳到主要内容

OpenWrt 部署

在 OpenWrt 路由器上部署 GoRelay Agent，可以让局域网内所有设备无需安装客户端即可享受中继加速服务。

前提条件​

  • 已注册 GoRelay 账号并购买套餐
  • 已在控制台创建中继隧道
  • OpenWrt 路由器可正常联网
信息

账号注册、套餐购买和隧道创建请参考：快速开始 · 注册账号 · 创建隧道

支持的架构​

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

第一步：下载二进制文件​

前往 客户端下载 页面，在 OpenWrt 分类下选择对应架构的二进制文件下载。

提示

如果不确定路由器架构，可通过 SSH 登录后执行 uname -m 查看。

将下载的文件上传到路由器并安装：

# 将文件移动到系统目录并重命名
mv gorelay-agent-x86_64 /usr/bin/gorelay-agent

# 赋予执行权限
chmod +x /usr/bin/gorelay-agent

第二步：测试运行​

先手动运行确认服务正常（OpenWrt 仅支持 Web 模式）：

gorelay-agent -w 8080

启动后访问 http://路由器IP:8080，使用您的 GoRelay 账号密码登录即可。

确认 Web 界面可正常访问后，按 Ctrl+C 停止，进入下一步配置开机自启。

第三步：配置开机自启​

创建 init.d 服务脚本：

cat > /etc/init.d/gorelay-agent << 'EOF'
#!/bin/sh /etc/rc.common

START=99
STOP=10
USE_PROCD=1

start_service() {
    procd_open_instance
    procd_set_param command /usr/bin/gorelay-agent \
        -w 8080
    procd_set_param respawn
    procd_set_param stdout 1
    procd_set_param stderr 1
    procd_close_instance
}
EOF

chmod +x /etc/init.d/gorelay-agent

启用并启动服务：

# 设置开机自启
/etc/init.d/gorelay-agent enable

# 启动服务
/etc/init.d/gorelay-agent start

# 查看服务状态
/etc/init.d/gorelay-agent status

启动后访问 http://路由器IP:8080，使用 GoRelay 账号密码登录，点击「启动」即可连接中继服务。

常用管理命令：

# 停止服务
/etc/init.d/gorelay-agent stop

# 重启服务
/etc/init.d/gorelay-agent restart

# 取消开机自启
/etc/init.d/gorelay-agent disable

第四步：查看入口地址​

部署成功后，进入 GoRelay 控制台，打开「中继 → 转发列表」，查看：

  • 入口节点地址：GoRelay 分配给您的接入域名 / IP
  • 监听端口：此隧道对应的端口号

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

升级​

前往 客户端下载 页面下载最新版本，然后替换二进制文件：

# 停止服务
/etc/init.d/gorelay-agent stop

# 替换二进制文件
mv gorelay-agent-x86_64 /usr/bin/gorelay-agent
chmod +x /usr/bin/gorelay-agent

# 启动服务
/etc/init.d/gorelay-agent start

卸载​

# 停止并禁用服务
/etc/init.d/gorelay-agent stop
/etc/init.d/gorelay-agent disable

# 删除文件
rm -f /usr/bin/gorelay-agent
rm -f /etc/init.d/gorelay-agent

常见问题​

如何确认路由器架构？​

uname -m

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

运行提示 "not found" 或 "Exec format error"？​

下载了与路由器架构不匹配的二进制文件。请重新确认架构后下载正确版本。

路由器存储空间不足？​

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

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

服务启动后连接失败？​

  • 确认路由器 DNS 解析正常
  • 检查防火墙是否放行了相关端口
  • 使用 -d 参数启用调试模式查看详细日志： 
    gorelay-agent -w 8080 -d

如何查看运行日志？​

logread | grep gorelay