# koipy主页

## 介绍

koipy 读作 `/ˈkɒpi/`，音同 "copy"，也可以读作 `/ˈkɒpaɪ/`。

koipy 是专注于代理平台的连通性测试工具。它目前依赖 Telegram 作为展示前端，因此是一个测试机器人（Telegram bot）。koipy 采用前后端分离架构，后端是具体的代理测试工具实现，名为 [miaospeed](https://github.com/AirportR/miaospeed)，前端负责构建测试任务等操作。

koipy 起源于 [fulltclash](https://github.com/AirportR/FullTclash)，是 fulltclash 的下游分支。

## 源代码

目前，koipy 开源了 1.0 版本的代码。

仓库地址：

{% @github-files/github-code-block url="<https://github.com/koipy-org/koipy>" %}

koipy 后续版本的代码保持**闭源**。如果你愿意接受闭源产品，可以继续查阅此文档，此文档会跟进最新版 koipy 使用指南。

## 能干什么

* 给代理服务器（节点）进行连通性测试（包括延迟 RTT、地区流媒体解锁检测等）
* 给代理服务器（节点）进行**下行**速度测试
* 给代理服务器（节点）进行网络拓扑分析（检测入口和出口）

## 结果展示

![连通性测试+速度测试](https://raw.githubusercontent.com/koipy-org/koipy/master/resources/image/example.png)

![拓扑测试](/files/o4GH81BdilB33SpVTfcW)

## 如何开始

{% content-ref url="/pages/h69p9Mqgdt12Nn0XlJHX" %}
[快速开始](/koipy/kuai-su-kai-shi.md)
{% endcontent-ref %}

## 特性

在不断地开发迭代中，koipy不断地支持新的特性，包括但不限于：

* 全Clash系代理协议支持（包括vless、hysteria2、anytls、tuic）
* 批量测试（重要）
* 支持代理服务提供商（机场）URL订阅
* 可高度定制化的测试结果绘图
* 可高度定制化的配置文件支持（自定义测速线程、ping地址、ping次数、节点过滤等）
* 自由可拓展的javascript脚本支持
* 轻量的访问权限控制
* 本地化语言包支持
* 多测试后端配置支持
* 针对实时测试需求临时修改的指令参数、位置参数、以及终极测试规则

更多功能，请自行搭建体验。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://koipy.gitbook.io/koipy/koipy-zhu-ye.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.