MoonshotAI
Featured
Kimi-K3
Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It bridges oixCloud's proxy service with Surge and OpenSurge, offering a streamlined multi-deployment approach and an integrity-checked update mechanism.
Who it is for
- Surge for Mac users who subscribe to oixCloud
- Home network admins wanting a DHCP/DNS gateway with OpenSurge
- Linux/NAS users deploying via Docker
- Users needing to preserve existing Surge profiles while adding oixCloud nodes
Use cases
- Integrating oixCloud nodes into Surge policy groups for per-app routing
- Building a whole-home gateway with OpenSurge for device-level traffic control
- Exporting OpenSurge configuration for use on a separate machine or Docker container
- Keeping an existing Surge profile intact while adding oixCloud connectivity
Strengths
- One-click macOS setup with menu bar control and persistent startup
- Multiple deployment paths (macOS, OpenSurge, Docker) for different environments
- Automatic updates with SHA-256, Developer ID, and version verification, with rollback on failure
- Close integration with OpenSurge for DHCP/DNS takeover and device policy management
Considerations
- Direct Surge integration is macOS-only; requires Surge for Mac
- Legacy build for macOS 11-13 has not been fully tested on physical hardware
- Proprietary software with license restrictions; not open-source
README quick start
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
中文
选择部署方式
| 场景 | 文档 |
|---|---|
| 在当前 Mac 使用 Surge | 继续阅读本页 |
| 使用 OpenSurge GUI 与 DHCP/DNS 接管 | OpenSurge 接入指南 |
| 部署到 Linux、NAS 或家用服务器 | Docker 部署 |
| 保留现有 Surge 配置或自定义规则 | 配置参考 |
| 安装或连接失败 | 排错 |
macOS 快速开始
准备：
- Surge for Mac
- oixCloud 账户和 Access Token
- macOS 11 或更高版本
-
下载并解压仓库
-
双击
启动 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 |
Description
oixcloud external-proxy helper — distribution (docs + binaries via Releases)
Related repositories
Similar projects matched by category, topics, and programming language.
xuchonglang
Featured
investing-for-beginners
A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.
Krishnagangwal
Featured
CS-Fundamentals
A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.