Profile Format

The profile is the source of truth for Surge behavior. Most profile content can be adjusted in the user interface, but advanced or experimental features may still require manual editing.

Surge profiles use an INI-like format. Content is divided into sections such as [General], [Proxy], [Proxy Group], and [Rule].

[General]
loglevel = notify

[Proxy]
ProxyA = http, 1.2.3.4, 80

[Rule]
DOMAIN-SUFFIX,example.com,ProxyA
FINAL,DIRECT

Each section has its own syntax. Sections like [General] and [MITM] use key = value lines, and line order usually does not matter. In ordered sections such as [Rule], line order is part of the behavior.

Sections

Surge recognizes the following section names. Content in unrecognized sections is preserved as-is when the profile is saved, without errors.

Comments

Comment lines start with #, ;, or //. Inline comments are also supported.

# This is a comment line.
; This is a comment line.
// This is a comment line.

dns-server = 8.8.8.8 // This is an inline comment.
dns-server = 8.8.8.8 # This is an inline comment.
dns-server = 8.8.8.8 ; This is an inline comment.

When using inline comments, there must be at least one space before the delimiter.

Quoted Values iOS 5.21.0+ Mac 6.8.0+

Inside a double-quoted profile value, use \" for a literal double quote and \\ for a literal backslash. This allows values containing quotes or backslashes to be saved and reloaded without changing their contents.

example = "a quoted value: \"text\"; path: C:\\Proxy"

Profile Types

Profiles are divided into three categories:

1. Normal profile: created manually or used by default.
2. Managed profile: usually provided by an enterprise administrator or service provider. A managed profile cannot be modified locally because it can be updated remotely. To make changes, first create a copy to turn it into a normal profile.
3. Enterprise profile: Enterprise version only. It cannot be modified, viewed, or copied.

Detached Profile Section

To support complex setups, Surge can split one or more sections into another file with the #!include statement.

Main.conf

[Proxy]
#!include Proxy.dconf

The referenced file must contain the corresponding section declaration. The file can contain one section, multiple sections, or a complete profile.

Proxy.dconf

[Proxy]
ProxyA = http, 1.2.3.4, 80

This is useful when you want to:

1. Reference the [Proxy], [Proxy Group], and [Rule] sections of a managed profile while writing other sections yourself. This keeps proxy-related content updated without affecting local UI-managed settings.
2. Share sections across multiple profiles. For example, when using Surge on both iOS and macOS, [Proxy], [Proxy Group], and [Rule] are often the same, while [General] may be different. You can create iOS.conf and macOS.conf, then place the shared sections in another file.

[Proxy]
#!include Forwarding.dconf

[Proxy Group]
#!include Forwarding.dconf

[Rule]
#!include Forwarding.dconf

This way, adjusting [General] on iOS does not affect macOS, and you do not need to maintain two copies of the same routing configuration.

Additional notes:

• After modifying the profile in the UI, Surge writes the section back to the corresponding detached profile according to the include statement. If the included file contains other unused sections, only the used section is modified.
• If a managed profile is referenced, the referenced section cannot be edited locally, but other sections remain editable.
• A filename suffix is not required. If the file is a complete profile, you can continue using .conf. If it is not a complete profile, use another suffix to avoid showing it in the profile list.

• Starting from Surge iOS 4.12.0 and Surge Mac 4.5.0, one section can include multiple detached profiles. That section is marked read-only and cannot be edited in the UI.

    [Proxy]
    #!include A.dconf, B.dconf
  

Linked Profiles Mac 6.0.0+

#!include can also reference a remote managed profile (a URL) directly. This lets you build a local "overlay" profile that keeps following updates from the upstream config.

[Rule]
#!include https://example.com/managed.conf

When the referenced content is read-only, Surge will prompt to create a linked layer if you try to edit those sections. The local layer stores only your overrides, while the remote managed profile keeps receiving updates automatically.

Modules

Detached profile sections split one profile into multiple files. Modules are different: they patch selected parts of a profile to enable a specific behavior, and can be turned on and off independently.

Line Requirement

A line can be constrained to take effect only in specific environments, using the #!REQUIREMENT statement or the simplified notations #!IOS-ONLY, #!MACOS-ONLY, and #!TVOS-ONLY. See Line Requirement.