v2.0.X
2.0.3
2.0.3-dev (2026-07-24)
- 重写了 miaospeed 客户端实现,使用面向对象编程思想解耦模块
- 更新 geoip 脚本
- 修复进度条百分比数值异常溢出的问题
- 修复 Telegram 话题模式下导致无法发送测试结果的问题
2.0.2
2.0.2-dev (2026-07-20)
- 小幅优化了启动速度
2.0.2-dev (2026-07-16)
- 修复内置的订阅转换无法解析纯 URI
- 优化本地化系统
- 固定 CA 证书,使用 koipy 自身携带的 CA 证书,现在系统根证书不值得信任
- 支持 mtls 双向证书验证,即 koipy(客户端)可以验证后端的证书,koipy 也可以提供自身证书给后端协商验证(需要 miaospeed 版本 4.7.2)
- 移除无用代码
2.0.2-dev (2026-06-15)
- 支持 age X25519 armor 加密订阅解密,可在
subscription.age中配置 - 原生实现了本地内置的订阅转换,只需要将
subconveter.mode=builtin即可启用内置转换 - 指令参数设置的线程上限从 64 提升到 256
- 内置的订阅转换支持返回原始订阅中的 dns 配置
- 不安全的后端配置将在绘图结果中显示
- 新的配置项:
image.showUnsafeTips用于关闭不安全的后端提示(请确保你真的明白你的后端通信处于安全隧道中)
2.0.1
2.0.1 (2026-06-14)
- 修复了语言包切换时判定成功的逻辑
- 归一化本地化中的占位符
- 切换语言包后将显示保存配置的按钮
- 修正配置模板中本地化语言包的地址例子
- 本地化语言包加载失败时将静默跳过加载
- 完善英语语言包中的本地化字段
- 测速线程设置上限从
64调整为256 - 现在拥有用户权限且在非邀请测试的场景中将默认启用
runtime.enableDNSInject运行时配置 - 添加了 DNS 动态注入时的日志提示。当
runtime.enableDNSInject=true时,会明确在后台日志中告知 - 移除 webapi 的废弃路由
- invite 测试下,每个 UID 仅会同时存在一个会话。意味着无法通过同时发起两个
/invite - 现在
webapi.password在webapi.enable=true时是必填配置 - sub-store 模板样例添加
fakeSub=true的查询参数 - 修复私聊中无法使用
/invite指令 - invite 内联键盘的创建优化
- 重构
/invite中上下文管理 - 修复错误的超时计时器。之前有 60 秒的接收订阅计时(实际为 57 秒),现已修正为正确数值
- 修复 invite 极端情况下的变量可能出现空值但并未正确处理的问题
- 移除内置的 web 面板静态路由
- 将
webapp配置项更改为webapi,功能不变 - 添加更多协议解析(OpenVPN 等)
- 修正了 mihomo dns 覆写的优先级。现在
runtime.enableDnsInject优先于后端配置里DNSServer - 移除了内部函数的 quote 参数
- 优化了多后端拓扑图的排版问题
- 更新依赖文件
- 改进 Web 配置 API 安全策略,强化来源校验并增加鉴权失败限流
- 优化 Web 配置管理入口,新增 Koiboard 路由及静态资源兼容
- 指令参数支持多后端指定,做法是写多个
s=<后端id>
2.0.1-dev (2026-06-06)
- 修复私聊中无法使用
/invite指令 - invite 内联键盘的创建优化
- 重构
/invite中上下文管理 - 修复错误的超时计时器。之前有 60 秒的接收订阅计时(实际为 57 秒),现已修正为正确数值
- 修复 invite 极端情况下的变量可能出现空值但并未正确处理的问题
2.0.1-dev (2026-05-30)
- 移除内置的 web 面板静态路由
- 将
webapp配置项更改为webapi,功能不变 - 添加更多协议解析(OpenVPN 等)
- 修正了 mihomo dns 覆写的优先级。现在
runtime.enableDnsInject优先于后端配置里DNSServer - 移除了内部函数的 quote 参数
- 优化了多后端拓扑图的排版问题
- 更新依赖文件
2.0.1-dev (2026-05-07)
- 改进 Web 配置 API 安全策略,强化来源校验并增加鉴权失败限流
- 优化 Web 配置管理入口,新增 Koiboard 路由及静态资源兼容
- 指令参数支持多后端指定,做法是写多个
s=<后端id> - 指令参数新增
t/d短别名,与thread/duration效果相同 - 升级 bot 依赖 kurigram 到 2.2.22
- webapi 功能已实现,现在可以通过 HTTP 请求的方式来管理 koipy 的配置文件
- 针对 webapi 功能写了一个 webapp,你可以在 @koipybot 的简介页面点击 webapp 按钮即可打开使用
- 新的配置:
webapp子类,可用于开启 webapi,配合 web 面板使用,前往配置文件实例查看具体配置 - webapp 注意事项。建议配合 Nginx 反向代理,否则可能只有回环地址的 api 能访问
2.0.0
2.0.0 (2026-04-09)
🎉 期待已久的正式版发布啦
📜 更新内容
- 往期 dev 版本的所有内容
- 修复了多后端联测测速时「每秒速度」的颜色块数值异常问题
- 新的 runtime 配置:
runtime.enableDNSInject,用于给后端注入 mihomo 的 dns 配置,让后端能够使用 mihomo 配置里的 dns 进行节点地址解析。这对某些自建 dns 的代理提供商有奇效 - 修复了 invite 下的并发竞态条件问题
- 现在后端配置里的
dnsServer可以输入类似mihomo://<经过base64编码后的mihomo配置文件>来给后端使用 mihomo 的 dns 解析功能(需后端版本至少 4.5.5)
Mihomo dns 客户端集成
miaospeed 服务器在接受到来自客户端(主端)的请求时,会将请求里的 dnsServer 配置字段进行解析。在本次更新中,添加了一种内部协调的 scheme 用来解析 dns 配置:
text
mihomo://<Base64编码后的mihomo配置>这个内容等同于 mihomo 配置中的 dns 字段,参见:mihomo DNS 配置文档
假设你有如下 dns 配置:
yaml
dns:
enable: true
cache-algorithm: arc
prefer-h3: false
use-hosts: true
use-system-hosts: true
respect-rules: false
listen: 0.0.0.0:1053
ipv6: false
default-nameserver:
- 223.5.5.5
enhanced-mode: fake-ip
fake-ip-filter-mode: blacklist
fake-ip-filter:
- '*.lan'
nameserver-policy:
'+.arpa': '10.0.0.1'
'rule-set:cn':
- https://doh.pub/dns-query
- https://dns.alidns.com/dns-query经过 base64 编码加上 scheme 后是这样的:
text
mihomo://ZG5zOgogIGVuYWJsZT...(已省略)这样的配置可以被 miaospeed 正确识别,使用集成的 mihomo dns 服务进行解析,这样就可以确保节点的 server 能够正确解析到 IP。
2.0.0-dev (2026-03-20)
- 修复多后端翻页按钮
- 优化多后端拓扑的绘图排版
- 现在测试脚本返回
background(全小写)字段会让绘图背景色生效 - 修复了深色背景图下协议 Logo 显示异常的问题
2.0.0-dev (2026-03-19)
- 修复 Netflix 检测脚本
- 修复 Tiktok 检测脚本
- 修复通过 miaospeed scheme 添加后端时初始化后端配置未成功的问题
- 移除冗余文件
- 修复多后端联测时消耗流量统计的数值错误
- 重构了整个订阅转换功能
- 移除 substore 及其所有子配置(包括自动部署)
- 新增了实用脚本位于
utils/substore_deploy.py,可以自动部署 sub-store - 修复了大量的 invite 测试场景中的内存占用问题
- 现在订阅转换需要重新书写配置,否则无法使用订阅转换,新的配置示例已更新位于
config.yaml.example
2.0.0-dev (2026-02-14)
- 修复旧版许可证导致的多后端选择异常
- 修复可能的翻页页数错误重定向
2.0.0-dev (2026-02-14)
- 多后端测速任务提供三种调度模式:流水线模式、并发模式、串行模式
- 多后端的测速任务默认采用新的调度模式——流水线模式
- 新的配置项
slaveConfig.speedScheduling,后端测速任务的调度模式,共有以下可用值:["concurrent", "pipeline", "sequential"],默认pipeline - 修正了多后端拓扑图的页脚后端信息显示异常
- 多后端拓扑图的信息合并逻辑有部分情况未生效,正在修复中,但不影响数据准确性
三种调度模式的含义:
text
流水线模式:当第一个后端返回第一个节点的测速结果时,下一个后端才开始测试
并发模式:所有后端同时开始测试
串行模式:当前一个后端完成测速任务时,下一个后端才开始测速2.0.0-dev (2026-02-12) 🎆 2026 农历新年特别版
本次更新为重大更新,为正在开发版本,追求稳定请勿更新。
- 重构了所有选择按钮的实现
- 重构了所有翻页按钮的实现
- 重构了所有文本按钮的实现
- 协议相关 Logo 启用缓存,防止重复在内存渲染。缓存文件在
./resources/image/查看 - 允许通过配置文件禁用所有测试指令,
/re除外 - 更新本地化语言包
- 修复了部分情况下进度条的节点计数错误
- 改进了消息编辑队列,多人公开测试的场景中更为稳定
- 优化了许可证中的激活码结构
- 新增指令
/license可用于展示许可证信息 - 发送 koipy 的激活码即可打印许可证信息
- 优化许可证的信息展示,
/panel页面移除了许可证信息 - 赞助用户可以任意定义自己的赞助的版本信息,方式为在语言包中覆写此键值:
license_parse_version2 /id现在发送的过长消息默认折叠- 支持多后端联测。可以同时将一个任务分发给多个后端,并汇总结果到主端进行绘图
- 实现多后端联测的按钮选择页面
- 实现多后端联测的结果绘图功能(包括流媒体、速度、拓扑测试图)
- 实现多后端联测的进度条功能
- 实现多后端联测的数据清洗功能
- 现在选择后端按钮的页面支持选择多个后端(选择单个后端即回退到之前的模式)
- 脚本选择按钮现在无需点击「完成选择」即可完成勾选时的记忆
- 实现规则配置中的多后端设置。即
rule.slaveid配置项为一个数组时,就表示启动多后端联测 - webapp 现在已经初步可用,可前往 @koipybot 的详情页点击「打开应用」,然后输入 bot-token 和 chat_id 即可使用
- 支持通过 webapp 进行重载配置
- 实现多后端联测的「中止测试」按钮功能
- 改进了多后端联测时的错误处理和错误信息展示
- 优化了多后端联测模式下绘图文本信息的「合并」逻辑
- 当触发
/invite指令的目标不是用户权限时,仅允许单后端选择 - 多后端选择页面现在支持显示「延迟」信息
2026 农历新年特别版(2.0.0-dev)说明
- 此版本允许所有许可证类型进行公开测试
- 此版本的「标准版」许可证最多可以进行 3 个后端的联测(够你三网测试),超过 3 个后端进行联测时会自动取前 3 个后端
关于多后端联测
多后端联测是指,对同一个测试任务,将其分配给多个后端,并同时进行测试,并将结果汇总给主端。
特性说明
- 每个后端的配置可能不一致(比如线程这些),这部分还需要优化
- 绘图结果的线程显示仅会显示其中一个后端的
- 绘图结果的页脚的后端名称显示将固定为「集群后端」
- 拓扑测试的结果可能因为 GEOIP 脚本的逻辑影响,导致结果不一致
- 多后端联测暂时无法进行「实时渲染」功能
- 解锁统计在此模式无法生效
