bjarneo/velo

选用指南

AI 根据 README 整理 · 2026/10/28 19:41:24

使用方式

通过命令行运行，执行 `velo` 即可开始测试，支持多种交互按键和命令行参数。

查看 README 依据

omarchy-tui-install velo velo tile https://raw.githubusercontent.com/bjarneo/velo/main/assets/icon.png ``` Then press `Super` + `Space` and type `velo`. ### With Go velo needs Go 1.26 or later. ```sh go install github.com/bjarneo/velo@latest ``` ### From source ```sh git clone https://github.com/bjarneo/velo.git cd velo go build -o velo . ./velo ``` ## Run a test ```sh velo ``` velo finds the 10 nearest speedtest.net servers, measures the latency to each server, and selects the fastest one. Then it starts the test. A test takes about 18 seconds.

When you quit, velo prints the result of the last run: ``` velo: session closed · last run ↓ 495.8 ↑ 495.6 Mbps · 4.0 ms · C ``` ### Flags | Flag | Result | | --- | --- | | `--no-autostart` | velo waits for `⏎` before it starts a test. | | `--server 64051` | velo uses the server with this ID. The server list shows the IDs. | | `--theme nord` | velo starts with a built-in theme. | | `--private` | velo masks your IP address. Use it for screenshots and recordings. | | `--demo` | velo simulates the network. No data leaves the machine. | | `--version` | velo prints its version. |

部署要求

需要 Go 1.26 或更高版本才能从源码构建，或使用预编译的 amd64/arm64 二进制。

查看 README 依据

omarchy-tui-install velo velo tile https://raw.githubusercontent.com/bjarneo/velo/main/assets/icon.png ``` Then press `Super` + `Space` and type `velo`. ### With Go velo needs Go 1.26 or later. ```sh go install github.com/bjarneo/velo@latest ``` ### From source ```sh git clone https://github.com/bjarneo/velo.git cd velo go build -o velo . ./velo ``` ## Run a test ```sh velo ``` velo finds the 10 nearest speedtest.net servers, measures the latency to each server, and selects the fastest one. Then it starts the test. A test takes about 18 seconds.

<a href="docs/measurement.md">How velo measures</a> · <a href="docs/architecture.md">Architecture</a> · <a href="AGENTS.md">Agent guide</a> </p> ## Install ### Omarchy and other Linux Run the install script: ```sh curl -fsSL https://raw.githubusercontent.com/bjarneo/velo/main/install.sh | sh ``` The script downloads the latest release for your CPU, verifies the SHA-256 checksum, and installs `velo` to `~/.local/bin`. Release builds are for `amd64` and `arm64`. To add velo to the Omarchy app launcher, run: ```sh

已知限制

依赖 speedtest.net 服务器列表，不可用时无法测试；在东亚语言环境中可能因字体宽度问题导致布局错乱。

查看 README 依据

For the code structure, read [docs/architecture.md](docs/architecture.md). For instructions to coding agents, read [AGENTS.md](AGENTS.md). ## Limits - LOSS counts latency probes that failed or took longer than the timeout. velo uses TCP, so this value is not the packet loss of the link. - velo depends on the speedtest.net server list. When the list is not available, velo shows an error. Press `⏎` to try again. - velo draws with one-column glyphs. Some fonts in East Asian locales draw these glyphs two columns wide. Then the layout breaks. ## License