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

Build or import a mihomo configuration, then preview it before startup

Build nodes, groups and rules with Global Extension or import a mihomo profile. Preview policies and test latency while the OpenSurge gateway is stopped.

Read page →