Surge配置文件怎么写?从空白模板开始配置
简答: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, localhostDNS参数只决定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配置文件的实际步骤
- 先确定使用场景。如果你已有托管配置或订阅链接,优先导入现成配置,不必手写所有节点;如果你只有一个独立节点,才适合从空白Profile开始。
- 创建普通文本文件。使用纯文本编辑器保存内容,文件扩展名通常使用
.conf。不要用会自动替换标点的富文本编辑器。 - 先写四个核心区块。按照
[General]、[Proxy]、[Proxy Group]、[Rule]的顺序组织,先让配置结构简单,再逐步加入规则集。 - 填写真实节点参数。把示例中的服务器、端口、用户名、密码和加密方式替换成服务提供方给出的值。协议类型不能凭名称猜测,HTTP、HTTPS、SOCKS5、Shadowsocks、Trojan和WireGuard的字段并不通用。
- 让策略组引用正确的节点名称。检查策略组中的成员名称是否与
[Proxy]完全一致,同时确认DIRECT等内置策略拼写正确。 - 让规则引用策略组名称。例如策略组叫
Proxy,规则末尾就写,Proxy,不要写成节点名称或另一个组名。 - 最后添加FINAL。根据需要选择
FINAL,DIRECT或FINAL,Proxy。如果希望未匹配请求直连或走代理,应明确写出,不要省略。 - 导入并启用配置。在Surge中导入本地文件或从URL下载配置,选择该Profile后启用规则模式。不同系统版本的菜单名称可能变化,以当前界面为准。
- 检查请求记录。打开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版本和平台支持范围内。
写完配置后,怎样确认真的生效
- 先确认Profile已加载。如果导入后仍在使用旧配置,修改文本不会影响当前请求。
- 确认出站模式。规则写得正确,但如果当前处于直连或全局模式,表现可能与规则模式不同。
- 查看请求记录。重点看域名、命中的规则、最终策略和失败阶段。
- 分别测试直连与代理。先用
DIRECT确认本地网络正常,再切换到代理组,避免把本地网络问题误判为配置错误。 - 检查DNS行为。如果域名解析结果异常,分别测试系统DNS、Surge配置的DNS和规则中是否涉及IP类匹配。
- 逐条恢复复杂功能。确认基础代理和规则生效后,再加入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格式。应使用对应客户端支持的配置或分享链接,并核对协议和字段是否受当前版本支持。