runtime
这一页说明任务运行时相关配置。和 bot、image 这类长期静态配置不同,runtime 更偏向“本次任务怎么跑”。
runtime
yaml
runtime: # 测速任务可以动态调整的配置
entrance: true # 是否显示入口IP段
duration: 10 # 测速时长,优先级高于后端单独设置的测速时长
ipstack: true # 是否启用双栈检测
pingURL: https://www.gstatic.com/generate_204 # 延迟测试地址
speedFiles: # 速度测试的大文件下载地址
- https://dl.google.com/dl/android/studio/install/3.4.1.0/android-studio-ide-183.5522156-windows.exe
speedNodes: 300 # 最大测速节点数量
speedThreads: 4 # 后端测速线程数量,优先级高于后端单独设置的
output: image # 输出类型,目前支持 image 和 json 和 video 三种
realtime: false # 是否实时渲染测试结果
disableSubCvt: false # 是否针对单次测试禁用订阅转换
protectContent: false # bot输出的所有图片设置为保护内容
enableDNSInject: false # 是否启用 mihomo DNS 注入runtime 的作用域
- 顶层
runtime用来提供一组运行时默认值。 rules[].runtime可以为单条规则单独覆写。- 指令参数也能覆写其中一部分,例如:
?thread=8&duration=15&sort=http&realtime=true&nocvt=true - 源码里的
runtime结构还支持includeFilter、excludeFilter、sort,只是当前模板页没有全部展开。
注意
按目前情况,全局 runtime 最稳定的字段是 speedNodes、speedFiles、ipstack、entrance、protectContent、enableDNSInject。pingURL、duration、speedThreads、sort、output、realtime、disableSubCvt 更适合写在 rules[].runtime 或通过指令参数覆写。
runtime.pingURL
解释
- 这项配置用于覆写本次任务的延迟测试地址,对应后端里的
option.pingAddress。 - 如果你填的是
https://...,结果图里相关列名会更偏向 HTTPS/TLS 延迟;如果是http://...,则更偏向 HTTP 延迟。 - 它只影响延迟测试的结果,不影响大文件地址测速的结果。
特性
- 类型:
str - 更适合写在
rules[].runtime中。按当前源码,全局runtime.pingURL不会稳定地自动继承给每个任务。 - 如果当前任务没有设置它,程序会继续使用后端自身的
option.pingAddress。
配置示例
yaml
rules:
- name: "CF 延迟测试"
url: "https://example.com/sub"
runtime:
pingURL: "https://cp.cloudflare.com/generate_204"runtime.speedFiles
解释
- 这是测速大文件地址列表。
- 只有当后端的
option.downloadURL写成DYNAMIC:ALL时,后端才会从runtime.speedFiles中随机挑一个地址来测。 - 如果后端
downloadURL本来就是固定 URL,这个列表不会强行覆盖后端配置。
特性
- 类型:
list[str] - koipy也接受把它写成单个字符串,但最终会被转换成列表。
- 当前解析逻辑只保留以
http开头的条目。 - 这项全局默认值是稳定兜底生效的,如果规则和后端配置里均没有设置测速文件地址,则会使用顶层
runtime的值。 - 如果你的后端依赖
DYNAMIC:ALL,这里就不要留空。
配置示例
yaml
runtime:
speedFiles:
- "https://dl.google.com/dl/android/studio/install/3.4.1.0/android-studio-ide-183.5522156-windows.exe"
- "https://speed.cloudflare.com/__down?bytes=200000000"runtime.speedNodes
解释
- 限制一次任务最多允许测试多少个节点。
- 订阅拉取完成后,会先应用
includeFilter/excludeFilter过滤,再检查过滤后的节点数量是否超过这个值。 - 超过限制时,任务会直接报错,不会进入后端测速阶段。
特性
- 类型:
int - 默认值:
300 - 这项全局默认值是稳定生效的,也可以在
rules[].runtime里单独覆写。 - 它控制的是“节点数量上限”,不是测速线程数。
配置示例
yaml
runtime:
speedNodes: 300runtime.speedThreads
解释
- 用来覆写本次任务的后端测速线程数,对应后端的
option.downloadThreading。 - 线程开得越大,不代表结果一定越好;它更像是“并发压测强度”。
- 对低配后端或高倍率节点,线程过高反而更容易让测试结果失真。
特性
- 类型:
int - 后端校验范围是
1 ~ 64。 - 如果你通过指令参数传入,则
?thread=/?t=当前只接受1 ~ 64。 - 更适合写在
rules[].runtime或用指令参数临时覆写。按当前源码,全局runtime.speedThreads不会稳定地自动继承给每个任务。
配置示例
yaml
rules:
- name: "4线程测速"
url: "https://example.com/sub"
runtime:
speedThreads: 4runtime.duration
解释
- 用来覆写本次任务的测速时长,对应后端的
option.downloadDuration。 - 持续时间更长,通常更容易拉开高倍率节点之间的差距,但任务整体也会更慢。
- 这项配置主要对含有测速项的任务有意义,纯连通性测试基本不会用到它。
特性
- 类型:
int - 后端校验范围是
1 ~ 120秒。 - 如果你通过指令参数传入,则
?duration=/?d=当前只接受1 ~ 60。 - 更适合写在
rules[].runtime或用指令参数临时覆写。按当前源码,全局runtime.duration不会稳定地自动继承给每个任务。
配置示例
yaml
rules:
- name: "15秒测速"
url: "https://example.com/sub"
runtime:
duration: 15runtime.entrance
解释
- 控制拓扑结果中是否显示入口 IP 段。
- 关闭后,拓扑结果仍然会有入口聚类和入口地域信息,只是不再显示入口 IP 段这一列。
- 它主要影响的是拓扑图和 GEOIP 结果,不影响普通连通性测速图。
特性
- 类型:
bool - 默认值:
true - 这项全局默认值是稳定生效的,也可以在
rules[].runtime里单独开启。
配置示例
yaml
runtime:
entrance: trueruntime.ipstack
解释
- 控制拓扑结果中是否显示双栈信息,也就是常见的 IPv4 / IPv6 栈标识列。
- 关闭后,拓扑图仍可继续生成,只是不显示栈信息那一列。
- 它同样主要作用于 GEOIP / 拓扑结果。
特性
- 类型:
bool - 默认值:
true - 这项全局默认值是稳定生效的,也可以在
rules[].runtime里单独开启。
配置示例
yaml
runtime:
ipstack: trueruntime.sort
解释
- 控制结果输出时的排序方式。
- 如果值非法,结果会回退到
订阅原序。 - 当前koipy支持的完整值有:
text
订阅原序
HTTP升序
HTTP降序
平均速度升序
平均速度降序
最大速度升序
最大速度降序
RTT升序
RTT降序特性
- 类型:
str - 更适合写在
rules[].runtime或通过指令参数传入。按当前源码,全局runtime.sort不会稳定地自动继承给每个任务。 - 如果你走的是指令参数,当前还支持短别名,例如:
http、rhttp、aspeed、mspeed、rtt。
配置示例
yaml
rules:
- name: "HTTP排序测速"
url: "https://example.com/sub"
runtime:
sort: "HTTP升序"runtime.includeFilter / excludeFilter
解释
- 这两项用于按节点名称做筛选。
includeFilter是先保留匹配项,excludeFilter是再排除匹配项。- 支持正则表达式。
特性
- 类型:
str - 过滤顺序是:先
includeFilter,再excludeFilter。 - 过滤发生在节点数量限制
speedNodes之前。 - 正则写错时,koipy会记录错误日志,并退回到“不做这次过滤”的效果。
配置示例
yaml
rules:
- name: "只测日韩,排除低倍率"
url: "https://example.com/sub"
runtime:
includeFilter: "(JP|KR)"
excludeFilter: "(0\\.1x|剩余流量)"runtime.output
解释
- 控制任务结果输出格式。
- 当前公开配置模板里列出的稳定值是:
image、json、video。 image是普通结果图,json适合下游程序处理,video用于展示动态炫酷图。
特性
- 类型:
str - 更适合写在
rules[].runtime或通过指令参数传入。按当前源码,全局runtime.output不会稳定地自动继承给每个任务,未显式设置时仍会回退到image。 video只适合单后端、含测速项、节点数不过大的任务;不满足条件时,程序会回退到image。- 如果你的运行环境没有正确安装视频生成依赖库——ffmepg,
video会回退到图片结果。
配置示例
yaml
rules:
- name: "测速导出JSON"
url: "https://example.com/sub"
runtime:
output: "json"runtime.realtime
解释
- 控制测速任务是否默认打开实时渲染。
- 实时渲染会在任务进行过程中不断编辑或更新结果图,比普通进度条更直观。
- 它主要对“单后端 + 含测速项 + 图片/视频输出”的任务有意义。
特性
- 类型:
bool - 更适合写在
rules[].runtime或通过?realtime=true这类指令参数启用。按当前源码,全局runtime.realtime不会稳定地自动继承给每个任务。 - 单后端时,当前默认实时渲染节点上限是
40;多后端时会按后端数量分摊这个上限。 - 多后端目前没有稳定的合并实时画布,因此就算打开,更多也只是保留实时进度语义,而不是稳定输出一张实时总图。
配置示例
yaml
rules:
- name: "实时测速"
url: "https://example.com/sub"
runtime:
realtime: trueruntime.disableSubCvt
解释
- 这项配置用于在单次任务里临时禁用订阅转换。
- 它只在你已经启用了全局
subconverter/sub-store之类的订阅转换时才有意义。 - 开启后,本次任务会直接拿原始订阅去解析,不再先走订阅转换。
特性
- 类型:
bool - 更适合写在
rules[].runtime或通过?nocvt=true这类指令参数启用。按当前源码,全局runtime.disableSubCvt不会稳定地自动继承给每个任务。 - 它适合处理“某些新协议经过转换后反而丢节点”的场景。
配置示例
yaml
rules:
- name: "直连原始订阅"
url: "https://example.com/sub"
runtime:
disableSubCvt: trueruntime.protectContent
解释
- 控制 bot 发送的结果媒体是否使用 Telegram 的“保护内容”模式。
- 开启后,TG 前端会限制转发、保存、复制等行为。
- 它主要影响图片和视频这类媒体结果。
特性
- 类型:
bool - 默认值:
false - 这项全局默认值是稳定生效的,也可以在
rules[].runtime中单独开启。
配置示例
yaml
runtime:
protectContent: trueruntime.enableDNSInject
解释
- 控制是否把订阅里的
dns:配置注入到后端请求中。 - 开启后,如果当前订阅本身带有 mihomo 风格的
dns段,koipy会把它编码成mihomo://...的字符串,并插到后端配置dnsServer列表最前面。 - 如果订阅里没有
dns字段,或者编码后过长 / 非法,就会静默回退到后端原有的 DNS 列表。
特性
- 类型:
bool - 默认值:
false - 这项全局默认值是稳定生效的,也可以在
rules[].runtime中单独开启。 - 它依赖后端对
mihomo://DNS格式的支持,要求较新的 miaospeed 后端版本。 - 当前版本里,顶层
runtime.enableDNSInject会作为默认值参与任务回填;
配置示例
yaml
runtime:
enableDNSInject: true