# NetStable <version>

## 下载

- `netstable-<version>-linux-amd64.tar.gz`: x86_64 Linux 服务器
- `netstable-<version>-linux-arm64.tar.gz`: ARM64 Linux 服务器
- `checksums.txt`: SHA256 校验和

## 快速启动

```bash
tar -xzf netstable-<version>-linux-amd64.tar.gz
chmod +x netstable
./netstable -listen 0.0.0.0:18080 -data /var/lib/netstable/records.jsonl -downloads-dir /var/lib/netstable/downloads
```

CLI 客户端测试：

```bash
./netstable client -server http://<server-ip>:18080 -duration 30
```

一键下载并测试：

```bash
arch=$(uname -m); case "$arch" in x86_64) arch=amd64;; aarch64|arm64) arch=arm64;; *) echo "unsupported arch: $arch"; exit 1;; esac; tmp=$(mktemp -d); curl -fsSL 'http://<server-ip>:18080/downloads/netstable-linux-'"$arch"'.tar.gz' | tar -xz -C "$tmp" && chmod +x "$tmp/netstable" && "$tmp/netstable" client -server 'http://<server-ip>:18080' -duration 30
```

CLI `iperf3` 测试，要求客户端和服务端都安装 `iperf3`：

```bash
./netstable client -mode iperf3 -server http://<server-ip>:18080 -duration 30 -protocol tcp
```

## 校验

```bash
shasum -a 256 -c checksums.txt
```

## 主要功能

- 单用户实时测速锁和 FIFO 队列，排队用户可看到当前位置。
- 理论最高带宽限制和页面展示。
- 保存脱敏后的用户 IP、地区、运营商、测试摘要和完整样本曲线。
- SSE 心跳辅助连接用于显示连接状态。
- CLI `iperf3` 模式通过服务端随机一次性高端口测速，并复用单用户测速锁。
- 网页可复制一键下载测试命令，用户服务器无需预先安装 `netstable`。
- 内置 ip2region IPv4 数据库，优先离线解析地区和运营商。
- 嵌入式 Web 页面，无需 Node、PHP 或数据库。