Quick Start

Surge is controlled by a profile. A profile describes how traffic is captured, how requests are matched, and which outbound policy is used.

Most setups only need four sections:

[General]
dns-server = system, 1.1.1.1, 8.8.8.8

[Proxy]
ProxyA = https, proxy.example.com, 443, username, password

[Proxy Group]
Proxy = select, ProxyA, DIRECT

[Rule]
DOMAIN-SUFFIX,example.com,Proxy
GEOIP,CN,DIRECT
FINAL,Proxy

How to Read This Profile

• [General] contains global options such as DNS servers, testing URLs, and takeover behavior.
• [Proxy] defines outbound policies. A policy can connect directly, reject traffic, or forward traffic to a proxy server.
• [Proxy Group] lets you choose among multiple policies manually or automatically.
• [Rule] matches requests from top to bottom. The first matched rule decides the policy.

Where to Go Next

• To write matching logic, read Rule.
• To configure proxy servers, read Proxy Policy.
• To choose among proxies, read Policy Group.
• To customize DNS behavior, read DNS Server and Local DNS Mapping.
• To modify HTTP requests and responses, read HTTP Processing and Scripting.