{"repo":"YTwsy/OpenSurge-for-Mac","free":true,"listed":false,"github":"https://github.com/YTwsy/OpenSurge-for-Mac","clone":"git clone https://github.com/YTwsy/OpenSurge-for-Mac.git","description":"Surge-style whole-home gateway and control plane for macOS with IPv4/IPv6 support— mihomo TUN, dnsmasq-powered DHCP/DNS, per-device routing, and an agent-friendly validation workspace.","language":"Go","stars":2080,"topics":["dhcp","dns","gateway","harness-engineering","loop-engineering","macos","mihomo","transparent-proxy","tun","surge"],"license":"GPL-3.0","category":"networking-infra","readme_excerpt":"OpenSurge for Mac 把 Mac 变成可按设备分流的 Surge 风格全屋透明代理网关——既可让指定设备通过旁路由手动接入，也支持 DHCP/DNS 自动接管与实验性下游 IPv6 接管 简体中文 · English 下载 · App 指南 · 能力 · 每设备策略 · Web GUI · Agent 工作区 OpenSurge for Mac 是一个开源的 Surge 风格 macOS 网关与控制面。多数用户可以先从 旁路由模式开始：主路由 DHCP 保持开启，只让需要接入的设备使用稳定 IPv4，并把网关和 DNS 指向 Mac。需要让同一局域网的设备自动接入时，也可以选择局域网 DHCP 接管；有独立 AP、SSID 或 VLAN 时，则可以使用独立下游 LAN。三种模式均可按需启用实验性的 IPv6 接管。 无论采用哪种模式，你都可以为已登记设备配置不同的出口策略：手机和 Mac 一起走规则 分流、游戏机连美服、电视走流媒体节点。在局域网 DHCP 接管和独立下游 LAN 模式下， 接入相应网络的手机、电视、PS5 和 VR 设备，都可以自动从 Mac 获取 DHCP/DNS，无需逐台 修改网关和 DNS。 十张图带你了解 OpenSurge 左右滚动查看完整图文。 模式 适合场景 对现有网络的影响 --- --- --- 旁路由模式（常用，推荐首次体验） 先接入手机、电视、游戏机等指定设备 主路由 DHCP 保持开启；指定设备使用稳定 IPv4，并手工设置网关和 DNS 局域网 DHCP 接管（进阶 · 自动接入） 希望同一 LAN 的设备自动使用 OpenSurge 需要按引导关闭主路由 DHCP，停止时按恢复流程重新开启 独立下游 LAN 独立 AP、SSID 或 VLAN 不改变现有 LAN 的 DHCP；Mac 为独立下游网络提供 DHCP/DNS 和网关 - 可导入已有的 mihomo 配置或订阅，保留原有节点、代理组和规则 - Web GUI 实时展示每台设备的连接、上下行流量和实际出口链；菜单栏随时查看网关状态与恢复提醒。 - 菜单栏与 Web GUI 提供默认关闭、仅本次运行有效的 合盖保持运行 开关。 底层由 dnsmasq 提供 DHCP/DNS，mihomo 作为代理引擎。IPv4 使用 macOS pf 与 forwarding 提供原生网关路径；实验性的下游 IPv6 则由 dnsmasq RA/SLAAC/RDNSS、 macOS BPF packet broker 和本项目补丁构建的 mihomo 用户态数据面共同接管。 这个仓库也被有意设计成一个 AI Agent 友好工作区：项目知识与代码一起版本化，高风险 网络行为有可执行的证据门槛，Virtual Lab 与真实设备产生的证据会回流到下一轮工程 循环。 能力 友好的 App 体验 - 通过 macOS 菜单栏 App 随时查看状态、接收网络恢复提醒并打开本地 Web GUI；再次打开 /Applications/OpenSurge.app 会直接展开与菜单栏图标相同的状态面板； - 按需临时阻止空闲与合盖睡眠；开关不依赖网关状态，不保存偏好，退出 OpenSurge 或重启 Mac 后恢复正常睡眠； - 在一个控制面中完成订阅导入、网络设置、设备分流、节点健康、连通性检查与诊断； - 使用恢复状态机引导局域网 DHCP 接管的启动、客户端验收、停止和网络恢复。 第一次使用请参阅 OpenSurge for Mac App 使用指南。遇到","default_branch":null,"files":null,"tree":[],"storefront":"/r/YTwsy","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/YTwsy/OpenSurge-for-Mac/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}