Documentation
Start carefully and verify each layer
Installation and operating guidance with explicit boundaries for unsigned packages, DHCP, TUN, recovery, and experimental IPv6.
Getting started · 7 min read
Install OpenSurge, verify the package, and onboard one device
A careful first-run path for the unsigned macOS package, the local Web GUI, bypass-router mode, and downstream client validation.
Read page →
Mac-local traffic · 7 min read
Coordinate the Mac's egress mode and macOS system proxy
Understand OpenSurge Rule, Global, and Direct modes on the gateway Mac, and when the separate HTTP/HTTPS system-proxy compatibility layer should be enabled.
Read page →
Source and profile workflow · 8 min read
Import a mihomo configuration without giving up gateway safety
Use subscriptions and local mihomo YAML as OpenSurge sources while preserving their nodes, policy groups, rules, providers, and supported DNS policy.
Read page →