https://github.com/tsosunchia/inetspeed-cli
Speedtest.net 命令行工具平替，支持单线程、多线程、延迟采样
https://github.com/tsosunchia/inetspeed-cli
speedtest
Last synced: 4 months ago
JSON representation
Speedtest.net 命令行工具平替，支持单线程、多线程、延迟采样
- Host: GitHub
- URL: https://github.com/tsosunchia/inetspeed-cli
- Owner: tsosunchia
- License: gpl-3.0
- Created: 2026-02-25T12:38:54.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T04:21:12.000Z (4 months ago)
- Last Synced: 2026-03-02T16:46:33.628Z (4 months ago)
- Topics: speedtest
- Language: Go
- Homepage:
- Size: 11.9 MB
- Stars: 76
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# iNetSpeed-CLI
> Speedtest.net 命令行工具平替
> 支持单线程、多线程、延迟采样
> 基于 Apple CDN（OOKLA speedtest.net 的国内节点基本掉光了，但是本工具用的苹果CDN有国内三网节点）
## 从这里开始（30 秒上手）
先选版本：
- **推荐：Go 版本**（单一二进制，零外部依赖，结果更稳定）
- **兼容：Shell 版本**（适合只想临时跑一轮，或已有脚本环境）
### 方式 A：Go 版本（推荐）
Linux 一键安装：
```bash
curl -sL nxtrace.org/speedtest_install | bash
```
macOS / Windows：从 Releases 下载预编译包后直接运行：
-
从源码直接运行：
```bash
go run ./cmd/speedtest/
```
### 方式 B：Shell 版本（兼容）
仓库内脚本直接运行：
```bash
sh scripts/apple-cdn-speedtest.sh
```
或在线脚本一键测试：
```bash
curl -sL nxtrace.org/speedtest | bash
```
## 仓库资源导航（按用途）
| 你要做什么 | 用哪个资源 |
|------|------|
| 完整测速（下载 + 上传 + 延迟） | `cmd/speedtest/main.go`（Go） / `scripts/apple-cdn-speedtest.sh`（Shell） |
| 只测下载 | `scripts/apple-cdn-download-test.sh` |
| 只测上传 | `scripts/apple-cdn-upload-test.sh` |
| 构建多平台二进制 | `scripts/build.sh`（输出到 `dist/`） |
| 一键安装 Go 版（Linux） | `scripts/install.sh` |
| 本地质量检查（格式 + vet + test + race + shell） | `scripts/check.sh` |
## 常见使用场景
### 1) 跑一次完整测速（默认配置）
```bash
# Go 版本
go run ./cmd/speedtest/
# Shell 版本
sh scripts/apple-cdn-speedtest.sh
```
### 2) 只测下载 / 只测上传（Shell）
```bash
sh scripts/apple-cdn-download-test.sh
sh scripts/apple-cdn-upload-test.sh
```
### 3) 自定义参数测速
```bash
# Go：环境变量方式
TIMEOUT=5 MAX=1G THREADS=8 LATENCY_COUNT=10 go run ./cmd/speedtest/
# Go：命令行方式（优先级高于环境变量）
./speedtest --timeout 5 --max 1G --threads 8 --latency-count 10
# Go：强制中文输出（参数优先级高于环境变量）
./speedtest --lang zh
```
## Demo
---
## Go 版本详细说明
使用 Go 重写，零外部依赖（无需 curl / awk / dd / pv 等），单一二进制即可运行。
### 环境要求
- Go 1.22+（仅构建时需要）
### 构建与运行
```bash
# 直接运行
go run ./cmd/speedtest/
# 构建二进制
go build -o speedtest ./cmd/speedtest/
./speedtest
# 查看版本
./speedtest --version
# 查看帮助
./speedtest --help
# 多平台交叉编译（输出到 dist/）
bash scripts/build.sh
```
### 一键安装（仅 Linux）
```bash
curl -sL nxtrace.org/speedtest_install | bash
```
- 自动识别 Linux 架构（`amd64`/`arm64`）
- 从 GitHub Releases 下载最新版本并校验 `sha256`
- 默认安装目录：`~/.local/bin`（root 为 `/usr/local/bin`）
- 若目标安装目录不在 `PATH`，则自动回退安装到当前目录（`$PWD`）
- 可通过 `INSTALL_DIR` 指定安装目录，例如：`INSTALL_DIR="$HOME/bin" bash scripts/install.sh`
### 环境变量
| 变量 | 默认值 | 说明 |
|------|--------|------|
| `DL_URL` | `https://mensura.cdn-apple.com/api/v1/gm/config` 下的 large URL | 下载测试地址 |
| `UL_URL` | `https://mensura.cdn-apple.com/api/v1/gm/config` 下的 slurp URL | 上传测试地址 |
| `LATENCY_URL` | `https://mensura.cdn-apple.com/api/v1/gm/config` 下的 small URL | 延迟测试地址 |
| `MAX` | `2G` | 每线程最大传输量（支持 K/M/G/T 以及 KiB/MiB/GiB/TiB） |
| `TIMEOUT` | `10` | 每线程传输超时（秒） |
| `THREADS` | `4` | 多线程并发数 |
| `LATENCY_COUNT` | `20` | 空载延迟采样次数 |
| `SPEEDTEST_LANG` | 自动 | 输出语言，`zh` 显示中文，其他显示英文（未设置时读取 `LC_ALL/LC_MESSAGES/LANGUAGE/LANG`） |
### 命令行参数（优先级高于环境变量）
| 参数 | 对应环境变量 | 说明 |
|------|--------------|------|
| `--dl-url` | `DL_URL` | 下载测试地址 |
| `--ul-url` | `UL_URL` | 上传测试地址 |
| `--latency-url` | `LATENCY_URL` | 延迟测试地址 |
| `--max` | `MAX` | 每线程最大传输量 |
| `--timeout` | `TIMEOUT` | 每线程传输超时（秒） |
| `--threads` | `THREADS` | 多线程并发数 |
| `--latency-count` | `LATENCY_COUNT` | 空载延迟采样次数 |
| `--lang` | `SPEEDTEST_LANG` | 输出语言，`zh` 显示中文，其他显示英文（优先级高于环境变量） |
### 输出模式
- **TTY**（终端直连）：彩色输出 + 实时进度刷新（`\r` 覆盖刷新）
- **非 TTY**（管道 / CI）：纯文本输出，无 ANSI 转义，无进度行
### 退出码
| 码 | 含义 |
|----|------|
| 0 | 全部成功 |
| 1 | 配置错误（参数非法） |
| 2 | 完成但部分查询降级（如 ip-api 不可达） |
| 130 | 被信号中断（Ctrl+C） |
### 节点选择逻辑
1. 并发查询 Cloudflare DoH 和 AliDNS DoH 获取 `mensura.cdn-apple.com` 的 **A + AAAA** 记录（4 路并发：CF-A、CF-AAAA、Ali-A、Ali-AAAA，各 1 秒超时）。
2. 合并结果：按 CF-A → CF-AAAA → Ali-A → Ali-AAAA 顺序拼接，全局去重后作为候选节点列表（同时支持 IPv4 和 IPv6）。
3. 仅当某一提供商的 A **和** AAAA 查询都超时时，该提供商才被视为超时；仅当两路都超时时，才触发 system DNS fallback。
4. 用 ip-api 查询每个 IP 的地域 / ASN 信息（中文环境自动附加 `lang=zh-CN` 参数，获取中文地理信息）。
5. 交互终端下可手动选择节点；非交互环境默认选择第 1 个。
6. 选中后通过 HTTP 客户端 DialContext 固定连接目标（等效于 `curl --resolve`）。
### 项目结构
```
cmd/speedtest/main.go 入口，信号处理
internal/
config/ 配置加载 & 校验 & 单位解析
netx/ HTTP/2 客户端工厂 + 端点固定（--resolve 等效）
endpoint/ 双 DoH（CF+Ali）A+AAAA 双栈解析 + ip-api 地理信息（自动中文） + 节点选择
latency/ 空载/负载延迟采样 & 统计
transfer/ 下载/上传传输（单/多线程、双限制）
runner/ 测试流程编排
render/ 事件总线 + TTY/Plain 渲染器
```
### 开发与质量检查
```bash
go test ./... -count=1 # 全部 Go 测试
go test -race ./... -count=1 # 含竞态检测
bash scripts/apple-cdn-speedtest_test.sh # Shell 单元测试
bash scripts/check.sh # 本地完整检查（格式 + vet + test + race + shell tests）
```
### CI / CD
- **CI**（[.github/workflows/ci.yml](.github/workflows/ci.yml)）：push / PR 触发，Go 稳定版 + 上一稳定版矩阵，macOS + Linux，缓存 go mod，运行 `check.sh`。
- **Release**（[.github/workflows/release.yml](.github/workflows/release.yml)）：`v*` tag 触发，先跑测试，再用 `build.sh` 产出 5 平台二进制（含 `windows/amd64`）+ sha256 校验文件，上传到 GitHub Release。
---
## Shell 脚本版本（原始实现）
### 包含脚本
- `scripts/apple-cdn-speedtest.sh`：完整测速（空载延迟、单/多线程下载、单/多线程上传）
- `scripts/apple-cdn-download-test.sh`：仅下载测速
- `scripts/apple-cdn-upload-test.sh`：仅上传测速
### 环境依赖
脚本启动时会进行环境检查，并给出缺失依赖与安装提示。
必需依赖（主脚本）：
- `curl`（必须支持 HTTP/2）
- `awk`
- `grep`
- `sed`
- `sort`
- `mktemp`
- `dd`
- `wc`
- `tr`
- `head`
必需依赖（单项脚本）：
- 下载脚本：`curl`, `awk`, `grep`, `head`, `dd`, `mktemp`, `date`, `cat`
- 上传脚本：`curl`, `awk`, `dd`, `mktemp`, `date`, `cat`
可选依赖：
- `pv`：用于实时进度显示（缺失不影响测速结果）
- `getent`/`dig`/`host`/`nslookup`/`ping`：用于 DNS 辅助解析（缺失仅影响部分展示信息）
网络访问要求：
- Apple 测速端点：`https://mensura.cdn-apple.com`
- Cloudflare DoH：`https://cloudflare-dns.com`（节点选择）
- AliDNS DoH：`https://dns.alidns.com`（节点选择）
- ip-api：`http://ip-api.com`（节点地理信息）
### 在线脚本（nxtrace）
```bash
# 上传速度
curl -sL nxtrace.org/upload | bash
# 下载速度
curl -sL nxtrace.org/download | bash
# One-key
curl -sL nxtrace.org/speedtest | bash
```
也支持 `https`，将域名前加上 `https://` 即可。
也可以先下载再执行：
```bash
wget https://nxtrace.org/speedtest
chmod +x speedtest
./speedtest
```
### 常用环境变量（Shell 版）
主脚本（`scripts/apple-cdn-speedtest.sh`）：
- `DL_URL`：下载 URL
- `UL_URL`：上传 URL
- `LATENCY_URL`：延迟探测 URL
- `MAX`：每线程最大传输量（默认 `2G`）
- `TIMEOUT`：每线程测试时长（默认 `10` 秒）
- `THREADS`：多线程并发数（默认 `4`）
- `LATENCY_COUNT`：空载延迟采样次数（默认 `20`）
示例：
```bash
TIMEOUT=5 MAX=1G THREADS=8 LATENCY_COUNT=10 sh scripts/apple-cdn-speedtest.sh
```
### 节点选择逻辑（Shell 版）
1. 并发查询 Cloudflare DoH 和 AliDNS DoH 获取 `mensura.cdn-apple.com` 的 **A + AAAA** 记录（4 路并发：CF-A、CF-AAAA、Ali-A、Ali-AAAA，各 1 秒超时）。
2. 合并结果：按 CF-A → CF-AAAA → Ali-A → Ali-AAAA 顺序拼接，全局去重后作为候选节点列表（同时支持 IPv4 和 IPv6）。
3. 仅当某一提供商的 A **和** AAAA 查询都超时时，该提供商才被视为超时；仅当两路都超时时，才触发 system DNS fallback。
4. 用 ip-api 查询每个 IP 的地域/ASN 信息（中文环境自动附加 `lang=zh-CN` 参数，获取中文地理信息）。
5. 交互终端下可手动选择节点；非交互环境默认选择第 1 个。
6. 选中后通过 `curl --resolve host:443:IP` 固定后续测试连接目标。
## 许可证
本项目采用 **GNU General Public License v3.0 (GPL-3.0-or-later)** 开源。
- 许可证全文见 `LICENSE`。