速云网络返回首页

Surge配置文件怎么写?从空白模板开始配置

更新于 2026-11-15 · suyungo.buzz

简答:Surge配置文件本质是按区块组织的纯文本配置,通常先写[General],再定义[Proxy]节点、[Proxy Group]策略组,最后用[Rule]分流并以FINAL兜底。新手可先复制最小模板,再替换节点和规则。

定义:Surge配置文件是一个采用INI风格、由多个区块组成的纯文本Profile,用来定义DNS、代理节点、策略组和流量匹配规则。

先看一份最小可用的Surge配置模板

如果你只是想先写出一份结构正确的Surge配置,不必一开始加入复杂的规则集、重写或脚本。官方快速入门示例把配置拆成[General]、[Proxy]、[Proxy Group]和[Rule]四个核心区块。可以先复制下面的模板,再替换域名、端口、用户名和密码。

[General]
dns-server = system, 1.1.1.1
proxy-test-url = http://example.com/
internet-test-url = http://example.com/
test-timeout = 5

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

[Proxy Group]
Proxy = select, ProxyHTTPS, DIRECT

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

这份模板的逻辑是:先声明DNS和测试参数,再定义一个HTTPS代理节点;随后建立一个可手动选择的策略组;最后让指定域名走Proxy,中国IP直连,其他没有匹配到的请求由FINAL处理。官方文档中的最小Profile也采用了相同的四段式结构,可参考Surge Quick Start和Profile Format。

先试这一步:把模板保存为普通文本文件,确认每一行没有全角逗号、全角等号或多余引号,再导入Surge。模板中的代理地址只是占位示例,不能直接作为可用节点。

Surge配置文件四个核心区块分别写什么

1. [General]:全局网络参数

[General]用于配置DNS、连通性测试地址、超时时间、跳过代理的地址以及部分系统接管行为。常见写法是每行一个key = value,参数名称和区块名称要按照当前官方文档支持的写法填写。

[General]
dns-server = system, 1.1.1.1
proxy-test-url = http://example.com/
internet-test-url = http://example.com/
test-timeout = 5
skip-proxy = 192.168.0.0/16, 10.0.0.0/8, localhost

DNS参数只决定Surge如何进行域名解析,不等于所有应用都会按照同样方式解析。若出现部分应用能打开、部分应用无法打开,应结合Surge请求记录、规则命中情况和系统网络设置排查,不要只修改DNS。

2. [Proxy]:定义具体代理节点

[Proxy]中的每一行都是一个代理策略,基本格式是名称 = 类型, 服务器, 端口, 其他参数。官方策略文档给出了HTTP、HTTPS、SOCKS5、Shadowsocks、Trojan、WireGuard等类型的支持情况和参数格式,具体协议参数应以Surge Policies当前页面为准。

[Proxy]
ProxyHTTP = http, proxy.example.com, 8080, username, password
ProxyHTTPS = https, proxy.example.com, 443, username, password
ProxySOCKS5 = socks5, proxy.example.com, 1080, username, password
ProxySS = ss, proxy.example.com, 8388, encrypt-method=chacha20-ietf-poly1305, password=your-password

节点名称是后续策略组和规则引用的标识。比如节点写成ProxyHTTPS,策略组里就必须完全写成ProxyHTTPS,包括大小写、空格和符号。节点名称不一致时,策略组可能显示空成员或加载失败。

3. [Proxy Group]:把节点组合成可选择的策略

策略组让规则引用一个稳定的名称,而不是直接绑定某个节点。常见格式是组名 = 类型, 成员1, 成员2。官方策略组文档列出了select、url-test、fallback、load-balance和smart等类型,可参考Policy Group Overview。

策略组写法适合场景行为
Proxy = select, ProxyA, ProxyB, DIRECT希望手动选择在界面中手动切换成员
Auto = url-test, ProxyA, ProxyB多个相近节点根据测试延迟选择成员
Fallback = fallback, ProxyA, ProxyB需要按优先级切换优先使用列表中第一个可用成员
Balance = load-balance, ProxyA, ProxyB需要分配请求在可用成员之间分配流量

url-test并不是对网页下载速度的完整测速,它通过测试地址检查策略的请求延迟;官方说明中提到,自动测试组使用HTTP HEAD请求,并按照测试结果选择成员,详细行为见Automatic Testing Group。因此不要把配置中的延迟测试结果直接理解为实际带宽保证。

4. [Rule]:按顺序匹配并决定策略

规则格式通常是规则类型,匹配值,策略名。例如:

[Rule]
DOMAIN,api.example.com,Proxy
DOMAIN-SUFFIX,example.com,Proxy
DOMAIN-KEYWORD,video,Proxy
IP-CIDR,192.168.0.0/16,DIRECT
GEOIP,CN,DIRECT
FINAL,Proxy

规则从上到下匹配,第一条命中的规则决定请求使用哪个策略。官方规则说明明确要求最后使用FINAL处理前面没有匹配的请求;如果把宽泛规则放在前面,后面的精确规则可能永远不会生效。规则类型和匹配范围可查看Rules Overview。

从零编写Surge配置文件的实际步骤

  1. 先确定使用场景。如果你已有托管配置或订阅链接,优先导入现成配置,不必手写所有节点;如果你只有一个独立节点,才适合从空白Profile开始。
  2. 创建普通文本文件。使用纯文本编辑器保存内容,文件扩展名通常使用.conf。不要用会自动替换标点的富文本编辑器。
  3. 先写四个核心区块。按照[General]、[Proxy]、[Proxy Group]、[Rule]的顺序组织,先让配置结构简单,再逐步加入规则集。
  4. 填写真实节点参数。把示例中的服务器、端口、用户名、密码和加密方式替换成服务提供方给出的值。协议类型不能凭名称猜测,HTTP、HTTPS、SOCKS5、Shadowsocks、Trojan和WireGuard的字段并不通用。
  5. 让策略组引用正确的节点名称。检查策略组中的成员名称是否与[Proxy]完全一致,同时确认DIRECT等内置策略拼写正确。
  6. 让规则引用策略组名称。例如策略组叫Proxy,规则末尾就写,Proxy,不要写成节点名称或另一个组名。
  7. 最后添加FINAL。根据需要选择FINAL,DIRECT或FINAL,Proxy。如果希望未匹配请求直连或走代理,应明确写出,不要省略。
  8. 导入并启用配置。在Surge中导入本地文件或从URL下载配置,选择该Profile后启用规则模式。不同系统版本的菜单名称可能变化,以当前界面为准。
  9. 检查请求记录。打开Surge的Dashboard或请求列表,查看目标域名命中了哪条规则、使用了哪个策略。如果没有请求记录,先确认系统代理或虚拟网卡接管方式已经开启。

如果你使用的是订阅而不是手写节点,配置文件和订阅并不是同一个概念:订阅可能提供节点列表,Profile则负责策略组、规则和全局设置。需要导入订阅时,可继续参考站内的Surge订阅怎么添加?配置文件与策略组设置方法,不要把Clash的YAML、sing-box的JSON或其他客户端专用文件直接当作Surge Profile。

订阅、策略组和手写节点应该怎么组合

常见有三种配置方式:

方式配置内容适合谁注意事项
手写节点自己填写[Proxy]、策略组和规则只有少量固定节点节点参数、协议和密码需要逐项核对
本地Profile加订阅本地文件负责规则,订阅负责节点希望规则可控、节点可更新需要确认订阅格式和策略组引用方式
完整托管配置节点、策略组、规则由远程文件提供不想维护配置文本远程内容变化时要重新检查规则和权限

如果使用远程资源或外部规则集,建议先确认URL可以正常返回文本,并检查返回内容是否仍然是Surge支持的格式。官方文档说明,RULE-SET可以引用内置规则、Profile中的规则集、文件或URL;相关用法可查看Rule Set。

一种更容易维护的写法是把节点、策略组和规则拆到外部文件,再通过#!include引用。例如:

[Proxy]
#!include Proxy.dconf

[Proxy Group]
#!include Group.dconf

[Rule]
#!include Rules.dconf

不过,拆分文件会增加路径、权限和同步问题。第一次写配置时,建议先使用单文件版本,确认请求可以按预期匹配后,再考虑拆分。

配置导入后不生效,按这张表排查

现象可能原因先做什么
配置无法导入或提示格式错误区块名称、逗号、等号或文件编码不符合要求先删到四个核心区块,改用纯文本保存,再逐段加入内容
策略组里没有节点策略组引用的名称与[Proxy]不一致逐字对比节点名称、大小写、空格和符号
所有网站都走同一个策略前面的宽泛规则抢先匹配,或FINAL策略设置不符合预期查看请求记录,确认第一条命中的规则
规则写了但没有命中域名类型选错,或请求实际使用的是IP地址先用DOMAIN-SUFFIX测试域名,再检查请求详情
节点显示可用但连接失败服务器、端口、密码、TLS或协议参数错误单独测试该节点,并核对服务提供方给出的协议字段
url-test选出的节点体验不好延迟测试不能代表完整下载速度或特定应用质量改用select手动对比,或调整测试地址和策略组
导入后部分应用不走规则应用未遵循系统代理,或未启用相应的虚拟网卡接管查看Surge当前接管模式和请求记录,再区分系统代理与VIF问题

排查时不要一次修改十几个参数。更有效的顺序是:先确认配置能加载,再确认节点能连接,然后确认策略组能选中,最后检查规则顺序和DNS。若问题表现为“连接成功但只有部分应用能用”,还可以参考站内的VPN连接后只有部分应用能用怎么办,从分流、DNS和系统接管范围继续定位。

Surge配置文件中的常见进阶写法

RULE-SET:把大量规则放到外部资源

当[Rule]越来越长时,可以用RULE-SET引用外部规则集:

[Rule]
RULE-SET,https://example.com/rules.list,Proxy
GEOIP,CN,DIRECT
FINAL,Proxy

外部规则集的地址、内容格式和更新状态都需要自行核验。若资源返回HTML错误页、空文件或规则类型不兼容,Surge可能无法按预期匹配。

policy-path:让策略组加载外部节点

如果策略组需要从远程资源读取节点,可以使用官方支持的外部策略引用方式,但具体参数要以当前版本文档和编辑器提示为准。未确认当前客户端支持的参数时,不建议照搬旧教程中的完整配置。

#!include:拆分多个配置文件

#!include适合在iOS和macOS之间共享相同的节点、策略组或规则,同时保留各平台不同的[General]设置。官方Profile格式文档对Detached Profile和包含文件的限制有详细说明,使用前应先确认本地文件路径、权限和Profile类型。

WireGuard与其他协议不要混写字段

WireGuard属于独立的代理策略类型,不能把HTTP或SOCKS5的用户名密码字段直接套用到WireGuard配置。节点类型不同,所需参数也不同;如果某个分享链接无法导入,应先确认该链接对应的协议是否在当前Surge版本和平台支持范围内。

写完配置后,怎样确认真的生效

  1. 先确认Profile已加载。如果导入后仍在使用旧配置,修改文本不会影响当前请求。
  2. 确认出站模式。规则写得正确,但如果当前处于直连或全局模式,表现可能与规则模式不同。
  3. 查看请求记录。重点看域名、命中的规则、最终策略和失败阶段。
  4. 分别测试直连与代理。先用DIRECT确认本地网络正常,再切换到代理组,避免把本地网络问题误判为配置错误。
  5. 检查DNS行为。如果域名解析结果异常,分别测试系统DNS、Surge配置的DNS和规则中是否涉及IP类匹配。
  6. 逐条恢复复杂功能。确认基础代理和规则生效后,再加入RULE-SET、脚本、重写、MITM或外部引用。

如果你需要配置分流而不是从零搭建节点,站内的VPN分流规则怎么设置可以作为后续阅读;本文只聚焦Surge Profile的基本结构、写法和验证流程。

常见问题

Surge配置文件必须叫.conf吗?

通常建议使用.conf扩展名保存普通Profile,但真正重要的是文件内容采用Surge支持的Profile格式。保存时使用纯文本,避免富文本格式、全角标点和自动替换字符。

Surge配置文件里的[Proxy]和[Proxy Group]有什么区别?

[Proxy]定义具体节点或代理策略,[Proxy Group]把一个或多个节点组合成可手动或自动选择的策略。规则通常引用策略组名称,而不是直接写服务器地址。

为什么Surge配置导入后策略组没有节点?

最常见原因是策略组成员名称与[Proxy]中的节点名称不完全一致,也可能是外部订阅、#!include文件或policy-path没有成功加载。先用单个手写节点测试,再逐步加入远程资源。

Surge规则为什么不生效?

Surge规则按从上到下的顺序匹配,第一条命中的规则会决定策略。检查是否有更宽泛的DOMAIN-KEYWORD、GEOIP或RULE-SET提前命中,并确认最后存在FINAL兜底规则。

url-test选出的节点一定最快吗?

不一定。url-test依据配置的测试地址和测试结果选择候选节点,结果更接近该测试请求的延迟,不等于所有网站、应用或下载任务的实际速度。

Clash的YAML能直接改成Surge配置吗?

不能直接混用。Clash常见配置是YAML,sing-box常见配置是JSON,而Surge使用自己的Profile格式。应使用对应客户端支持的配置或分享链接,并核对协议和字段是否受当前版本支持。

相关阅读

参考资料

  1. Surge Quick Start
  2. Surge Profile Format
  3. Surge Policies
  4. Surge Policy Group Overview
  5. Surge Automatic Testing Group
  6. Surge Rules Overview
  7. Surge Rule Set