Skip to content

EEliberto/SurgeRelay-macOS

Repository files navigation

Surge Relay (macOS)

Surge Relay Icon

一款用于集中管理、转换、编辑和发布 Surge 模块的 macOS 应用程序。

基于 Script-Hub 的本地转换能力构建。

Surge Relay 适合需要同时维护大量 Surge 模块的用户,尤其是经常通过 Script-Hub 将 Loon、Quantumult X 或其他代理工具格式转换为 Surge .sgmodule 的场景。

它的目标是将模块转换、地址维护、规则编辑和多设备同步集中到一台 Mac 上完成。你只需要在 Surge Relay 中维护上游地址和转换规则,最终生成的 Surge 模块会被发布到稳定的分发地址,所有设备只需要订阅这些固定 URL。

预览

Surge Relay Preview

特性

1. 集中化模块管理

在传统流程中,如果上游作者修改了仓库地址、文件路径或目录结构,用户通常需要重新打开 Script-Hub,重新转换模块,再重新安装到 Surge。

对于拥有多台设备的用户来说,这个过程需要在每台设备上重复操作。即便通过 iCloud 同步,也依然需要多次点击安装,维护成本很高。

Surge Relay 将这些流程集中到一台 Mac 上完成。你只需要在 App 中维护上游地址、备用地址和转换规则,Surge 设备端无需关心原始模块来源。

Surge Relay Module Editor Surge Relay Remote Management

2. 稳定的模块分发地址

Surge Relay 会将处理后的 Surge .sgmodule 文件发布到私有 GitHub 仓库,并通过 Cloudflare 提供稳定地址;也可以保存到本地 iCloud Drive 目录。所有 iPhone、iPad、Apple TV 和 Mac 上的 Surge App 只需要订阅这些固定 URL。

即使上游模块地址发生变化,你也只需要在 Surge Relay 中修改一次。设备端的订阅地址保持不变,不需要重新安装模块,也不需要逐台修改配置。

image image

3. 本地转换与自动发布

Surge Relay 运行在你的 Mac 上,负责拉取上游模块、调用 Script-Hub 的本地转换逻辑、应用自定义规则,并生成最终可用的 Surge 模块。

生成后的模块可以自动发布到私有 GitHub 仓库并搭配 Cloudflare,或保存到 iCloud Drive (推荐)。为避免公开仓库被批量滥用,Surge Relay 不允许将公开仓库用作同步目标。Mac 只负责构建和发布,用户设备读取的是已经发布好的稳定文件。因此,即使 Mac 关机或暂时无法连接,已经发布的模块仍然可以正常使用。

Github 和 Cloudflare Worker 配置教程

  • 从零配置 GitHub 私有仓库与 Cloudflare Worker — 面向新手的图文教程,包含 Token 权限、Worker 配置、验证方法和常见错误。
  • 你可以使用 AI 工具,例如 Claude Code 或 Codex 进行一键部署。如果你觉得操作过于繁琐,建议直接使用 iCloud 同步模式,无需此步骤 (最推荐🌟)。

4. 可视化编辑与规则控制

Surge Relay 提供图形化界面,用于查看和编辑模块内容。

你可以集中管理模块地址、删除不需要的模块、屏蔽指定 MITM hostname、禁用部分 Script 或 Rewrite 规则,并对模块参数进行可视化调整。

相比手动编辑 .sgmodule 文件,Surge Relay 更适合长期维护大量模块。

Surge Relay Module Editor Surge Relay Remote Management

5. Web 端远程管理

除了 macOS 原生 App,Surge Relay 也支持 Web 端远程管理。你可以通过浏览器查看模块状态、检查同步结果、调试转换问题,或远程修改模块配置。

配合 Surge Ponte 功能,即使不在 Mac 旁边,也可以从你的任意一台设备访问 Surge Relay,完成状态查看、调试和编辑等操作。

image image

6. 多设备自动同步

所有设备只需要订阅 Surge Relay 发布后的固定模块地址。后续模块更新、上游地址修复、MITM 调整、规则禁用等操作,都可以在 Surge Relay 中统一完成。

当新的模块文件发布后,设备端会随着 Surge 的模块更新机制自动同步,避免重复配置和手动迁移。

Surge Relay Landscape Preview Surge Relay Portrait Preview

如果遇到“App 已损坏,无法打开,你应将其移到废纸篓”

此提示并不代表 App 真的损坏。只是因为没有经过 Apple 付费公证,macOS 自动加上了“隔离”标记。

请按照以下提示操作:

1.打开“终端”(“访达”>“应用程序”>“实用工具”>“终端”)。

2.拷贝并粘贴至终端如下命令后按 Return (回车) 键:

  sudo xattr -rd com.apple.quarantine /Applications/Surge\ Relay.app

3.输入 Mac 的开机密码 (输入时不会显示任何字符) 后按 Return (回车) 键。

4.重新打开 Surge Relay,即可正常使用。

声明

本项目展示页面中的模块、模块名称、作者名称及相关来源,仅用于说明 Surge Relay 的模块管理、转换、汇总和分发能力,不代表本项目对任何模块内容、使用方式、适用场景或安全性的推荐、背书、指导或保证。

示例中展示的模块来源可能包括但不限于:Surge Relay、@小白脸、@xream、@keywos、@ckyb、Ethan、RuCu6Maaseafmz200kelv1n1n可莉🅥zmqcherishVirgilClynezirawell、wish、奶思等。

所有模块的版权、署名、许可协议和使用限制均归原作者或原项目所有。Surge Relay 仅提供本地化的模块管理、转换、编辑和发布工具能力。用户在使用、转换、编辑、分发或订阅相关模块前,应自行确认对应模块的来源、许可、用途、风险和合规性。

反馈

如果你有任何问题,请在 Github 提交 Issue。

About

一款用于管理、编辑和汇总 macOS Surge 模块的应用程序,以 Script Hub (https://github.com/Script-Hub-Org) 作为上游项目。

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors