Skip to content

出站总览 ​

outbounds 是从名字到出站映射的表。每个映射把 type 写在第一项;也可以直接写一条分享链接。

yaml
outbounds:
  direct:
    type: direct
    connect_timeout: 5s
  proxy:
    type: socks
    server: proxy.example:1080

route:
  final: direct

dns:
  servers:
    default: {type: udp, address: 127.0.0.1:53}
  final: default

类型 ​

type页面形式
directdirect本机直连
naivenaive代理协议
shadowsocksshadowsocks代理协议
sockssocks代理协议
httphttp代理协议
anytlsanytls代理协议
kasumikasumi代理协议
kyoukaikyoukai代理协议
miragemirage代理协议
iminaimina代理协议
selectorselector分组
fallbackfallback分组
urltesturltest分组
loadbalanceloadbalance分组
chainchain链

公共拨号字段 ​

有服务器的代理都接受下列平铺字段;direct 也使用其中与直接拨号有关的部分。共享说明见 dial 占位页。

detour ​

  • 类型:出站名。
  • 必填:可选。
  • 默认:直接拨服务器。
  • 限制:direct 和 naive 不收;链的非首跳也不能再写 detour。

domain_resolver ​

  • 类型:DNS 服务器名。
  • 必填:可选。
  • 默认:route.default_domain_resolver,再退回 bootstrap 或 DNS 规则。
  • 限制:direct 不收。

domain_strategy ​

  • 类型:字符串枚举。
  • 必填:可选。
  • 默认:不额外筛选。
  • 取值:as_is、prefer_ipv4、prefer_ipv6、ipv4_only、ipv6_only。

interface ​

  • 类型:接口名。
  • 必填:可选。
  • 默认:系统选择。
  • 限制:服务器经 detour 或作为链的非首跳时不能写。

mark ​

  • 类型:32 位无符号整数。
  • 必填:可选。
  • 默认:不设置。
  • 限制:只用于本出站直接拨号,不能与 detour 同时写。

bind_address ​

  • 类型:IP 地址,或 IP 地址数组。
  • 必填:可选。
  • 默认:系统选择。
  • 限制:每个地址族至多一个;只用于直接拨号。

connect_timeout ​

  • 类型:时长。
  • 必填:可选。
  • 默认:15s。

tcp_keep_alive ​

  • 类型:时长。
  • 必填:可选。
  • 默认:不设置。

tcp_keep_alive_interval ​

  • 类型:时长。
  • 必填:可选。
  • 默认:系统默认。
  • 限制:必须和 tcp_keep_alive 一起出现。

tcp_multi_path ​

  • 类型:布尔值。
  • 默认:false。

tcp_congestion ​

  • 类型:字符串。
  • 必填:可选。
  • 默认:系统拥塞控制。
  • 限制:显式设置只在 Linux 上可用。

公共代理字段 ​

下列字段只属于有服务器的代理;具体协议是否支持某一项见对应页面。

udp ​

  • 类型:字符串枚举。
  • 必填:可选。
  • 默认:该协议最好的承载方式。
  • 取值:native、over-tcp、xudp、connect-udp、off。
  • 限制:direct 和分组不收;native 只用于自己 UDP 可达服务器的协议。

max_concurrent_sessions ​

  • 类型:非负整数。
  • 必填:可选。
  • 默认:AnyTLS、Kyoukai 为 0(不限);Mirage 为 6。
  • 限制:只属于 AnyTLS、Kyoukai、Mirage。

min_idle_session ​

  • 类型:非负整数。
  • 必填:可选。
  • 默认:AnyTLS、Kyoukai 为 0;Mirage 为并发上限的三分之二,即默认 4。

idle_session_timeout ​

  • 类型:时长。
  • 必填:可选。
  • 默认:AnyTLS、Kyoukai 为 30s;Mirage 为 5m。

idle_session_check_interval ​

  • 类型:时长。
  • 必填:可选。
  • 默认:30s。

transport ​

  • 类型:transport 占位页。
  • 必填:可选。
  • 默认:不另套 stream transport。
  • 限制:direct、naive、imina 不收;Shadowsocks 的 SIP003 plugin 与它不能同时用。

公共分组字段 ​

selector、fallback、urltest、loadbalance 共用本节;各页只列出自己的差异。

outbounds ​

  • 类型:出站名数组。
  • 默认:空。
  • 行为:直接写出的成员,保留数组顺序。

use ​

  • 类型:provider 名数组。
  • 默认:空。
  • 行为:从这些 provider 取代理;内部字段名是 providers,YAML 必须写 use。

include_all ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:收集所有 provider 的代理和所有写出的非分组出站。

include_all_proxies ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:收集所有写出的非分组出站。

include_all_providers ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:收集所有 provider 的代理,替代逐个写 use。

filter ​

  • 类型:字符串;一个或多个用反引号包住的正则。
  • 默认:不筛。
  • 行为:匹配代理名,命中顺序决定收集顺序。

exclude_filter ​

  • 类型:字符串;一个或多个用反引号包住的正则。
  • 默认:不排除。

exclude_type ​

  • 类型:字符串;Clash 类型名用 | 分隔。
  • 默认:不按类型排除。

default ​

  • 类型:出站名。
  • 默认:第一个成员。
  • 限制:只有 selector 接受。

url ​

  • 类型:HTTP/HTTPS URL。
  • 必填:可选。
  • 默认:实现内建的探测 URL。

interval ​

  • 类型:时长。
  • 必填:可选。
  • 默认:urltest 为 3m,fallback 和 loadbalance 为 5m,selector 不探测。

timeout ​

  • 类型:时长。
  • 必填:可选。
  • 默认:探测器的 5s 等待值。

lazy ​

  • 类型:布尔值。
  • 必填:可选。
  • 默认:没有流经过时跳过下一轮探测。
  • 限制:lazy: false 时不能再写 idle_timeout。

expected_status ​

  • 类型:字符串。
  • 必填:可选。
  • 默认:实现自己的成功状态判断。
  • 取值:mihomo 的状态列表/范围写法。

tolerance ​

  • 类型:非负整数,单位毫秒。
  • 默认:50。
  • 限制:只有 urltest 接受。

strategy ​

  • 类型:字符串枚举。
  • 默认:consistent_hashing。
  • 取值:consistent_hashing、round_robin、sticky_sessions。
  • 限制:只有 loadbalance 接受。

max_failed_times ​

  • 类型:非负整数。
  • 默认:5。
  • 行为:连续失败达到该次数后,成员在重新探测成功前视为不可用;0 表示不设上限。

idle_timeout ​

  • 类型:时长。
  • 必填:可选。
  • 默认:该分组的一轮探测间隔。
  • 行为:闲置超过它后暂停探测,直到下一股流到来。

interrupt_exist_connections ​

  • 类型:布尔值。
  • 默认:false。
  • 行为:选择改变时,也中断经过该分组的既有路由连接;字段名保留 Clash 的 exist 拼写。

disable_udp ​

  • 类型:布尔值。
  • 默认:false。

empty_fallback ​

  • 类型:出站名。
  • 必填:可选。
  • 默认:收集型分组为空时使用内建 COMPATIBLE。
  • 行为:仅对通过 provider 或 include_all* 收集成员的分组生效。

hidden ​

  • 类型:布尔值。
  • 默认:false。

icon ​

  • 类型:字符串。
  • 默认:无。
  • 行为:面板显示的 URL 或图片数据。

内建出站 ​

配置可以直接引用这些名字,但不能用它们作为 outbounds 的键:

名字行为
DIRECT直连
REJECT以 reset/refused 拒绝
REJECT-DROP静默丢弃
COMPATIBLE当前与 REJECT 相同;也作为空分组的默认落点
PASS、PASS-RULE路由规则里表示继续下一条;作为分组成员时不连接任何地方
GLOBAL全局模式使用的选择器;配置可自行定义 GLOBAL

说明 ​

type 后置、未知字段、重复键、缺失的成员/provider/detour 都会让 check 失败。分享链接可以直接放在出站位置,详见 分享链接配置占位页。

相关 ​

页面历史

开发者设计、代码地图和验证记录保留在仓库 manual/。