{"id":25027990,"url":"https://github.com/alice39s/aqua-speed-tools","last_synced_at":"2025-07-31T06:34:57.474Z","repository":{"id":269930891,"uuid":"908884516","full_name":"Alice39s/aqua-speed-tools","owner":"Alice39s","description":"一个基于 Golang 的轻量级测速命令行工具，使用高性能的 Aqua Speed 测速内核，内置多种 CDN 节点测试预设。","archived":false,"fork":false,"pushed_at":"2025-02-27T03:18:18.000Z","size":7764,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T18:13:21.365Z","etag":null,"topics":["go","golang","librespeed","librespeed-cli","speedtest","speedtest-cli"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alice39s.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-27T07:49:29.000Z","updated_at":"2025-02-27T03:18:21.000Z","dependencies_parsed_at":"2024-12-27T09:17:37.158Z","dependency_job_id":"dc2d9829-9e4c-4430-a1c5-185f8c5885e1","html_url":"https://github.com/Alice39s/aqua-speed-tools","commit_stats":null,"previous_names":["alice39s/aqua-speed-tools"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alice39s%2Faqua-speed-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alice39s%2Faqua-speed-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alice39s%2Faqua-speed-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alice39s%2Faqua-speed-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alice39s","download_url":"https://codeload.github.com/Alice39s/aqua-speed-tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251749512,"owners_count":21637551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","librespeed","librespeed-cli","speedtest","speedtest-cli"],"created_at":"2025-02-05T19:55:58.871Z","updated_at":"2025-04-30T17:23:35.368Z","avatar_url":"https://github.com/Alice39s.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# :ocean: Aqua Speed Tools\n\n一个基于 Golang 的轻量级测速命令行工具，使用高性能的 [Aqua Speed][aqua-speed] 测速内核，内置多种 CDN 节点测试预设。\n\n## :sparkles: 功能特点\n\n- :arrows_counterclockwise: 内置多种 CDN 节点测试\n- :rocket: 自动更新程序版本\n- :bar_chart: 支持单节点或批量测试\n- :art: 美观的表格输出格式\n- :wrench: 多线程并发下载测试\n- :electric_plug: 支持 Patch 动态更新 (TODO)\n- :globe_with_meridians: 支持自定义镜像源\n- :shield: 支持 DNS over HTTPS\n\n## :inbox_tray: 安装方式\n\n### :package: 下载预编译版本\n\n#### Linux :penguin: / MacOS :apple:\n\n```bash\n# 需安装 curl\ncurl -sL \"https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/')\" -o aqua-speed-tools\n\n# 国内用户可选镜像\ncurl -sL \"https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m | sed 's/x86_64/amd64/' | sed 's/aarch64/arm64/')\" -o aqua-speed-tools\n\nchmod +x aqua-speed-tools\n\n./aqua-speed-tools\n\n# 国内用户可使用镜像模式\n./aqua-speed-tools --use-mirrors\n```\n\n#### Windows :computer:\n\n```bash\n# 64位, 需安装 curl\ncurl -sL https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-windows-amd64.exe -o aqua-speed-tools.exe\n\n# 国内用户可选镜像\ncurl -sL https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-windows-amd64.exe -o aqua-speed-tools.exe\n\n./aqua-speed-tools.exe\n\n# 国内用户可使用镜像模式\n./aqua-speed-tools.exe --use-mirrors\n```\n\n各平台预编译版本下载链接：\n\n| 平台                       | 架构  | 下载链接                                                    |\n| :------------------------- | :---- | :---------------------------------------------------------- |\n| :penguin: Linux            | amd64 | [GitHub 源][linux-amd64] / [镜像源][linux-amd64-mirror]     |\n| :penguin: Linux            | arm64 | [GitHub 源][linux-arm64] / [镜像源][linux-arm64-mirror]     |\n| :desktop_computer: Windows | amd64 | [GitHub 源][windows-amd64] / [镜像源][windows-amd64-mirror] |\n| :desktop_computer: Windows | arm64 | ×[^1]                                                       |\n| :apple: macOS              | amd64 | [GitHub 源][darwin-amd64] / [镜像源][darwin-amd64-mirror]   |\n| :apple: macOS              | arm64 | [GitHub 源][darwin-arm64] / [镜像源][darwin-arm64-mirror]   |\n\n### :hammer_and_wrench: 从源码编译\n\n```bash\n# 克隆仓库\ngit clone https://github.com/alice39s/aqua-speed-tools.git\ncd aqua-speed-tools\n\n# 编译\ngo build -o aqua-speed-tools cmd/tools/main.go\n```\n\n## :rocket: 使用方法\n\n### :computer: 交互式模式\n\n直接运行程序即可进入交互式模式：\n\n```bash\n./aqua-speed-tools\n```\n\n### :keyboard: 命令行模式\n\n```bash\n# 列出所有可用节点\n./aqua-speed-tools list\n\n# 测试指定节点速度\n./aqua-speed-tools test \u003c节点ID\u003e\n```\n\n### :gear: 高级选项\n\n```bash\n# 开启调试模式\n./aqua-speed-tools -d\n\n# 使用自定义 GitHub Raw 镜像\n./aqua-speed-tools --github-raw-magic-url https://raw.example.com\n\n# 使用自定义 GitHub API 镜像\n./aqua-speed-tools --github-api-magic-url https://api.example.com\n\n# 使用自定义 DNS over HTTPS 端点\n./aqua-speed-tools --doh-endpoint https://doh.pub/dns-query\n\n# 查看帮助\n./aqua-speed-tools -h\n```\n\n## :wrench: 配置文件\n\n程序会自动在以下位置创建配置文件，您可以 **根据需要** 进行修改：\n\n- Windows: `%APPDATA%/aqua-speed-tools/base.json`\n- Linux: `/etc/aqua-speed-tools/base.json`\n- MacOS: `~/Library/Application\\ Support/aqua-speed-tools/base.json`\n\n### :clipboard: 配置格式\n\n配置文件包含以下主要部分：\n\n#### 基本配置\n\n| 字段               | 说明               | 类型     | 示例                 |\n| :----------------- | :----------------- | :------- | :------------------- |\n| `script.version`   | 程序版本号         | `string` | `\"3.0.0\"`            |\n| `script.prefix`    | 程序前缀           | `string` | `\"aqua-speed-tools\"` |\n| `download_timeout` | 下载超时时间（秒） | `number` | `30`                 |\n\n#### GitHub 配置\n\n| 字段                      | 说明              | 类型       | 示例                                                          |\n| :------------------------ | :---------------- | :--------- | :------------------------------------------------------------ |\n| `github_api_magic_url`    | GitHub API 镜像   | `string`   | `\"[alice39s/aqua-speed](https://s3-lb01.000000039.xyz/api/)\"` |\n| `github_raw_jsdelivr_set` | JSDelivr 镜像列表 | `string[]` | `[\"https://gcore.jsdelivr.net/gh\"]`                           |\n\n#### DNS over HTTPS 配置\n\n| 字段                 | 说明           | 类型       | 示例       |\n| :------------------- | :------------- | :--------- | :--------- |\n| `dns_over_https_set` | DoH 服务器配置 | `object[]` | 见下方示例 |\n\n每个 DoH 配置包含：\n\n| 字段       | 说明         | 类型     | 示例                                     |\n| :--------- | :----------- | :------- | :--------------------------------------- |\n| `endpoint` | 服务器端点   | `string` | `\"https://cloudflare-dns.com/dns-query\"` |\n| `timeout`  | 超时时间(秒) | `number` | `10`                                     |\n| `retries`  | 重试次数     | `number` | `3`                                      |\n\n### :pushpin: 配置示例\n\n```json\n{\n  \"binary\": {\n    \"prefix\": \"aqua-speed\"\n  },\n  \"script\": {\n    \"version\": \"3.0.0\",\n    \"prefix\": \"aqua-speed-tools\"\n  },\n  \"github_api_base_url\": \"https://api.github.com\",\n  \"github_api_magic_url\": \"https://s3-lb01.000000039.xyz/api/\",\n  \"github_raw_base_url\": \"https://raw.githubusercontent.com\",\n  \"github_raw_jsdelivr_set\": [\n    \"https://gcore.jsdelivr.net/gh\",\n    \"https://fastly.jsdelivr.net/gh\",\n    \"https://testingcf.jsdelivr.net/gh\",\n    \"https://cdn.jsdelivr.net/gh\"\n  ],\n  \"dns_over_https_set\": [\n    {\n      \"endpoint\": \"https://dns.alidns.com/dns-query\",\n      \"timeout\": 10,\n      \"retries\": 3\n    },\n    {\n      \"endpoint\": \"https://cloudflare-dns.com/dns-query\",\n      \"timeout\": 10,\n      \"retries\": 3\n    }\n  ],\n  \"table_padding\": 2,\n  \"log_level\": \"info\",\n  \"download_timeout\": 30\n}\n```\n\n## :clipboard: TODO\n\n- [ ] :dizzy: 支持将结果上传到服务器，并生成一个易于分享的网页和 OpenGraph 图片\n- [ ] :bar_chart: list 和 test 命令输出为 Markdown, CSV, JSON 等格式\n- [ ] :arrows_counterclockwise: 支持 Patch 动态更新\n- [x] :art: 优化表格输出\n- [ ] :speech_balloon: 多语言支持\n- [x] :shield: 支持 DNS over HTTPS\n\n## :page_facing_up: 许可证\n\n本项目采用 [AGPL-3.0](LICENSE) 开源许可证。\n\n[aqua-speed]: https://github.com/alice39s/aqua-speed\n[linux-amd64]: https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-linux-amd64\n[linux-arm64]: https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-linux-arm64\n[windows-amd64]: https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-windows-amd64.exe\n[darwin-amd64]: https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-darwin-amd64\n[darwin-arm64]: https://github.com/alice39s/aqua-speed-tools/releases/latest/download/aqua-speed-tools-darwin-arm64\n[linux-amd64-mirror]: https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-linux-amd64\n[linux-arm64-mirror]: https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-linux-arm64\n[windows-amd64-mirror]: https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-windows-amd64.exe\n[darwin-amd64-mirror]: https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-darwin-amd64\n[darwin-arm64-mirror]: https://s3-lb01.000000039.xyz/download/Alice39s/aqua-speed-tools/latest/download/aqua-speed-tools-darwin-arm64\n\n[^1]: 由于测速客户端主程序 [aqua-speed] 使用 Bun 编写，而 Bun 暂不支持 Linux 交叉编译至 Windows ARM64 架构，如有需要，请自行 [编译安装](#hammer_and_wrench-从源码编译)。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falice39s%2Faqua-speed-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falice39s%2Faqua-speed-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falice39s%2Faqua-speed-tools/lists"}