通用配置
本页介绍配置文件 [General] 模块中的常用参数。
流量绕过
bypass-tun
让指定 IP 段或域名绕过 Loon 的 TUN，由系统直接处理：
bypass-tun = 192.168.0.0/16,localhost,*.local
skip-proxy
让指定 IP 段或域名绕过 HTTP Proxy：
skip-proxy = 192.168.0.0/16
DNS
多个 DNS 服务器使用英文逗号分隔。
dns-server
普通 UDP DNS。system 表示系统 DNS：
dns-server = system,1.1.1.1
doh-server
DNS over HTTPS：
doh-server = https://doh.dns.apple.com/dns-query
doq-server
DNS over QUIC，默认端口为 784：
doq-server = quic://example.com,quic://example2.com
doh3-server
DNS over HTTP/3：
doh3-server = h3://223.6.6.6/dns-query
hijack-dns
劫持指定目标的 UDP DNS 查询，并返回 Fake IP。适用于 Loon 3.2.5 (789) 及以上版本。
# *:53 表示所有目标的 53 端口
# *:0 表示所有目标和端口
# 8.8.8.8 表示该 IP 的所有查询
hijack-dns = *:53,8.8.8.8
IP 模式
ip-mode
适用于 Loon 3.2.3 (754) 及以上版本。
| 值 | 行为 |
|---|---|
ipv4-only | 仅使用 IPv4，不查询 AAAA，并拒绝 IPv6 连接 |
dual | 并发查询 A 和 AAAA，使用最先返回的结果 |
ipv4-preferred | 优先使用 IPv4，没有 A 记录时使用 IPv6 |
ipv6-preferred | 优先使用 IPv6，没有 AAAA 记录时使用 IPv4 |
ip-mode = dual
局域网访问
allow-wifi-access
允许局域网设备使用 Loon 的代理：
allow-wifi-access = true
wifi-access-http-port
局域网 HTTP 代理端口：
wifi-access-http-port = 8899
wifi-access-socks5-port
局域网 SOCKS5 代理端口：
wifi-access-socks5-port = 8898
测试
proxy-test-url
节点测速地址。策略组未单独指定地址时使用此项：
proxy-test-url = http://cp.cloudflare.com/generate_204
internet-test-url
网络可用性检测地址，建议使用可直连访问的 URL：
internet-test-url = http://wifi.vivo.com.cn/generate_204
test-timeout
节点测速超时时间，单位为秒：
test-timeout = 5
资源解析
resource-parser
指定订阅资源解析脚本：
resource-parser = https://github.com/sub-store-org/Sub-Store/releases/latest/download/sub-store-parser.loon.min.js
网络切换
ssid-trigger
根据 Wi-Fi 或蜂窝网络切换 Loon 模式：
ssid-trigger = "loon-wifi5g":DIRECT,"cellular":PROXY,"default":RULE
cellular：蜂窝网络。default：其他网络 。
interface-mode
指定流量使用的网络接口：
| 值 | 行为 |
|---|---|
Auto | 由系统自动选择 |
Cellular | Wi-Fi 和蜂窝网络同时可用时使用蜂窝网络 |
Performace | 使用当前表现最好的网络接口 |
Balance | 均衡使用可用网络接口 |
interface-mode = Performace
Fake IP
real-ip
让指定域名返回真实 IP，不使用 Fake IP。适用于系统服务或会缓存 Fake IP 的域名：
real-ip = *.apple.com,*.icloud.com
UDP 与 STUN
disable-udp-ports
禁止指定端口使用 UDP：
disable-udp-ports = 443,80
disable-stun
禁止 STUN UDP 流量，可用于减少 WebRTC IP 泄漏：
disable-stun = true
udp-fallback-mode
节点不支持 UDP 或未启用 UDP 转发时使用的策略。支持 DIRECT 和 REJECT，适用于 Loon 3.2.0 (702) 及以上版本。
udp-fallback-mode = REJECT
数据库
geoip-url
自定义 GeoIP 数据库下载地址。
ipasn-url
自定义 ASN 数据库下载地址，适用于 Loon 3.2.3 (754) 及以上版本。
域名拒绝
domain-reject-mode
设置域名拒绝规则的执行阶段，适用于 Loon 3.2.0 (702) 及以上版本。
| 值 | 行为 |
|---|---|
DNS | 在 DNS 阶段使用 Loopback IP、No Answer 或 NXDomain 拒绝 |
Request | 在请求转发阶段拒绝 |
domain-reject-mode = DNS
在 HTTP Proxy 与 TUN 模式下，Loon 能拦截的系统 DNS 较少，因此部分请求仍会在转发阶段被拒绝。
dns-reject-mode
设置 DNS 阶段的拒绝方式：
| 值 | 行为 |
|---|---|
LOOPBACKIP | 返回回环 IP |
NOANSWER | 返回空 DNS 响应 |
NXDOMAIN | 返回错误码 3 |
dns-reject-mode = LOOPBACKIP
已弃用参数
以下参数仅用于识别旧配置，新配置不应继续使用：
| 参数 | 说明 |
|---|---|
ipv6 | 从 Loon 3.2.3 (754) 起由 ip-mode 替代 |
switch-node-after-failure-times | Loon 现已自动检测节点可用性 |
force-http-engine-hosts | 从 Loon 3.2.3 (787) 起弃用 |
skip-first-packet | 从 Loon 3.5.0 (968) 起由 Loon 自动识别相关服务 |