install linux.zh Hans

在 Linux 上安装 LightSpeed

Warning

机器翻译，未经母语者审核。以英文版为准。

Linux 是命令行优先的平台。图形界面能为 Linux 构建，但在无人值守和进阶用户的场景中，受支持的路径是命令行客户端（lightspeed-client）。

---

下载什么

从 Releases 页面获取最新版本。选择与你的 CPU 匹配的压缩包：

你的机器	目标平台	文件
x86_64（Intel/AMD）	x86_64-unknown-linux-gnu	lightspeed-client-...-x86_64-unknown-linux-gnu.tar.xz
ARM64（Ampere、Graviton、Raspberry Pi 4/5）	aarch64-unknown-linux-gnu	lightspeed-client-...-aarch64-unknown-linux-gnu.tar.xz

不确定自己用的是哪种？运行：

uname -m

x86_64 表示 64 位 Intel/AMD；aarch64 或 arm64 表示 ARM64。

---

安装

Shell 安装脚本是最省事的方式。它会识别你的架构并安装客户端：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/ShibbityShwab/lightspeed/releases/latest/download/lightspeed-client-installer.sh | sh

或者从压缩包手动安装：

# Replace the filename with the one you downloaded.
tar -xf lightspeed-client-...-x86_64-unknown-linux-gnu.tar.xz
sudo mv lightspeed-client /usr/local/bin/

验证二进制文件可以运行：

lightspeed-client --version

---

root 权限

Linux 的拦截器使用 nftables（或 iptables）来重定向游戏的 UDP 流量，这需要 root。启动拦截器时要用 sudo 运行客户端：

sudo lightspeed-client --start-interceptor --game rust

发现、探测和诊断（--probe-proxies、--test-control、--check）不需要 root。

如果你的发行版默认不带 nftables，请确保安装它：

# Debian/Ubuntu
sudo apt install nftables

# Fedora/RHEL
sudo dnf install nftables

# Arch
sudo pacman -S nftables

---

首次运行

客户端会通过签名注册表自动发现社区中继。不需要填写代理地址。

# Probe the community relays and print a report
lightspeed-client --probe-proxies

# Start the interceptor for your game
sudo lightspeed-client --start-interceptor --game rust

---

验证是否正常

检查中继发现。 运行：

lightspeed-client --probe-proxies

这会执行一次发现/探测，并打印一份可见的报告，列出每个已发现的中继及其延迟。你应该看到全部八台社区中继（洛杉矶、新泽西、新加坡、法兰克福、东京、孟买、马德里、悉尼）。

检查控制面注册。 运行：

lightspeed-client --test-control

这会连接 QUIC 控制面，注册一个会话，发送 ping，然后断开，并打印每一步的结果。注册成功就说明控制面可达、认证正常。

检查环境。 运行：

lightspeed-client --check

这会报告拦截器可用性、root 状态、游戏检测和代理可达性。

检查数据包流转。 拦截器运行、游戏连接服务器之后，客户端的数据包计数应该开始增长。如果 "Packets Sent" 一直是 0，说明拦截器还没看到游戏流量；参见故障排查。

---

下一步

• 支持的游戏
• 故障排查
• CLI 参考