AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它填补了 oixCloud 与 Surge/OpenSurge 之间的集成空白，提供多种部署方式，并带有校验完整性机制的自动更新功能。

适合谁使用

使用 Surge for Mac 的 oixCloud 订阅用户
希望搭建 DHCP/DNS 全屋网关的家庭网络管理员
在 Linux、NAS 或家用服务器上通过 Docker 部署的用户
需保留现有 Surge 配置并添加 oixCloud 节点的用户

典型使用场景

将 oixCloud 节点集成到 Surge 策略组中实现按应用分流
借助 OpenSurge 构建全屋网关，进行设备级流量控制
导出 OpenSurge 配置文件用于其他机器或 Docker 容器
在保留原有 Surge 配置文件的前提下接入 oixCloud 服务

项目优势

macOS 一键启动，菜单栏控制并支持常驻启动
提供 macOS、OpenSurge、Docker 多种部署场景
自动更新验证 SHA-256、开发者 ID 和版本号，失败时自动回滚
深度集成 OpenSurge，支持 DHCP/DNS 接管与设备策略管理

使用前须知

直接接入 Surge 仅限 macOS 平台，需安装 Surge for Mac
macOS 11-13 的 legacy 版本未经充分实机测试
专有软件，许可受限，非开源

README 快速开始

oixCloud Surge / OpenSurge 助手 / helper

把 oixCloud 节点接入 Surge，或使用 OpenSurge GUI 构建 DHCP/DNS 全屋网关

Connect oixCloud nodes to Surge, or build a DHCP/DNS gateway with the OpenSurge GUI

中文 · English

中文

选择部署方式

场景	文档
在当前 Mac 使用 Surge	继续阅读本页
使用 OpenSurge GUI 与 DHCP/DNS 接管	OpenSurge 接入指南
部署到 Linux、NAS 或家用服务器	Docker 部署
保留现有 Surge 配置或自定义规则	配置参考
安装或连接失败	排错

macOS 快速开始

准备：

Surge for Mac
oixCloud 账户和 Access Token
macOS 11 或更高版本

下载并解压仓库

下载 ZIP
双击 启动 oixCloud.command

首次使用选择「常驻启动」
点击菜单栏云朵图标，打开「账户 › 登录…」

粘贴 Access Token，也可使用邮箱和密码
打开「连接设置 › 接入 Surge」

Surge 首次要求安装时确认，然后开启 Set as System Proxy

默认使用本地多端口映射，节点直接在 Surge 策略组中选择

完成标志：

菜单栏显示云朵图标
Surge 出现 oixCloud 配置和节点策略组
切换节点后可以正常访问网络

macOS 11、12、13 自动使用 legacy 通用版，该版本尚未经过充分实机测试

OpenSurge 全屋网关

OpenSurge 可提供 Web GUI、mihomo TUN、DHCP/DNS、设备策略和流量观察，本助手继续负责 oixCloud 账户、节点与本地出站

在菜单栏打开「连接设置 › 导出 OpenSurge 配置」
在 OpenSurge 的「来源」页面导入 Finder 中选中的 OpenSurge.yaml
在 OpenSurge 的「网络设置」中选择局域网 DHCP 接管、旁路由或独立下游 LAN

局域网 DHCP 接管不会自动修改路由器，必须按 OpenSurge 恢复状态机人工关闭和恢复路由器 DHCP，禁止同时运行两个 DHCP 服务器

详细步骤、运行边界与排错见 OpenSurge 接入与 DHCP/DNS 接管

更新

菜单栏「工具 › 检查更新」可直接更新

启动 oixCloud.command 每次运行也会检查更新

更新器会校验 SHA-256、Developer ID 和版本号，安装失败时自动恢复旧版本

Docker 使用 latest，更新命令见 Docker 部署

常用操作

需求	入口
查看账户与流量	账户
切换接入模式	连接设置 › 接入模式…
修改规则后同步	连接设置 › 接入 Surge
导出 OpenSurge profile	连接设置 › 导出 OpenSurge 配置
检查运行状态	工具 › 诊断…
更新程序	工具 › 检查更新
停止自动启动	重新运行 `启动 oixCloud.command`，选择「卸载自动启动」

许可

专有软件，详见 NOTICE

第三方许可证见 ThirdPartyNotices

English

Choose a deployment

Scenario	Guide
Use Surge on this Mac	Continue on this page
Use the OpenSurge GUI and DHCP/DNS takeover	OpenSurge integration
Run on Lin

项目描述

oixcloud external-proxy helper — distribution (docs + binaries via Releases)

oixcloud-external-proxy-program