无 sudo 部署 RIOT 2026.07：无线链路吞吐测试的绿色实践

从被没收 root 权限的那一刻起，我就知道这台 Ubuntu 机器不只是少一个sudo的问题：系统里像add-apt-repository这类常用工具都没有，想临时补个软件包更是想都别想。但任务摆在那——用 RIOT 2026.07 做一轮无线链路吞吐测试。这里说的 RIOT 不是嵌入式圈里那个 RIOT OS，而是一个面向链路质量评估的命令行工具，官方按“年份.月份”发版本。折腾了两个多小时，我最后还是把它跑起来了，而且在一段 Wi-Fi 点对点链路上稳定测出 28 Mbit/s。整个过程没有 sudo，没有往系统目录写任何依赖，所有东西都待在用户目录里。这篇文章就当一次“受限环境下绿色部署”的记录，里面的思路和坑，放到其它工具上大多也适用。

1. 先搞懂 RIOT 2026.07 在测什么，以及它凭什么能“免安装”运行

1.1 一张工具卡片：RIOT 到底解决什么问题

RIOT 2026.07 这个版本，核心功能可以理解成“带无线参数的 iperf3”。它能在服务端和客户端之间构造一条持续的数据流，测出吞吐量、抖动、丢包率，并且能顺带从无线网卡驱动里读出 RSSI、噪声底、链路速率这些信息。传统做法是想看吞吐就用 iperf3，想看信号就再去翻iw dev或网卡日志，两套数据很难对齐到同一个时间点。RIOT 把这些统一到命令行的同一屏输出里，测试结束后还能导出 CSV，方便回看无线参数和吞吐之间的关系。

它特别适合三类场景：

• 无线回传链路验收，比如两个楼宇之间做点对点 Wi-Fi 桥接，需要知道实际能跑多少吞吐，而不是只看协商速率。
• 大面积 AP 覆盖调优，对比不同信道、不同天线方向下的真实传输能力。
• 故障排查，当用户反馈“信号满格但网很卡”时，用 RIOT 同时抓吞吐和 RSSI，能快速看出是信号强度问题，还是丢包、干扰问题。

1.2 所谓“没装依赖”是什么意思，以及为什么仍然能跑

很多人听到“不能装依赖”就以为事情做不了，其实要分清“系统级依赖”和“用户级依赖”。没有 sudo，意味着不能apt install，不能往/usr/lib、/usr/local这些系统目录里写东西。但这不代表程序需要的库文件没有办法提供，只要把这些库放在自己的$HOME目录下，再用LD_LIBRARY_PATH告诉动态加载器去哪里找，程序一样能跑。

RIOT 2026.07 官方发布的是预编译 tarball，而不是需要现场编译的源码包。这一点很关键，因为编译通常依赖开发头文件和工具链，在受限环境里很容易卡住。tarball 里面除了主程序，还带了lib目录，包含 libpcap、libssl 这些运行库，设计上就是给用户“解压即用”的。这和我平时用的许多开源工具思路一样：做一个携带运行库的绿色版本，不依赖系统包管理器。

用生活里的类比来说，这就好比你去一个没有工具箱的出租屋，但你自己带了一个整理箱，里面放着常用的螺丝刀和扳手，用的时候拿出来，走的时候带走。系统还是那个系统，只是你把“工具环境”装在了自己的口袋里。

2. 动手前必须确认的 4 件事

2.1 先查系统架构和 glibc 版本，选对包

没 sudo 时最容易犯的错误是下载了不匹配架构的二进制，跑起来直接Segmentation fault。所以第一步永远是确认机器是什么架构、glibc 版本是多少。

在终端里依次执行下面两条命令：

uname -m ldd --version

uname -m输出x86_64就选 x86_64 版本，输出aarch64就选 ARM64 版本。ldd --version第一行会显示 glibc 版本，比如ldd (Ubuntu GLIBC 2.35-0ubuntu3.8) 2.35。RIOT 官方发布页一般会标注“最低支持 glibc 版本”，如果系统 glibc 低于要求，优先选择 musl 静态编译版本，因为 musl 版本基本能够在各种 Linux 发行版上直接运行，几乎不挑环境。

2.2 端口规划：避开 1024 以下端口

Linux 系统对端口的限制很现实：普通用户没有权限绑定 1024 以下端口，比如 80、443，甚至会碰到 53 这类 DNS 端口。如果没有 sudo，想让 RIOT 服务端监听在 10240 这类高端口，直接运行是没有问题的；如果非要监听在 1024 以下，就会遇到bind: Permission denied。

我这次用的是 10240，原因很简单：

• 高位端口不需要任何特权。
• 不容易跟系统里面常见的服务端口冲突。
• 网络团队和防火墙一般允许高端口 TCP/UDP 测试流量。

如果被测链路中间有人管理防火墙，最好提前把测试端口确认好，免得数据包被中途拦截。

2.3 目录写权限：别动 /opt，全部放到 $HOME

没有 sudo，很多系统目录对你来说就是只读的。想往/opt或者/srv里解压文件，大概率会遇到 permission denied。但用户目录$HOME是你自己的地盘，想怎么折腾都行。

所以部署路径直接定为：

mkdir -p ~/riot/{bin,lib,etc,logs}

一个目录放二进制，一个目录放运行库，一个目录放配置，一个目录放日志。这样即使以后要清理，直接删除~/riot就能全部带走，不会在系统里留下任何“垃圾”。

2.4 别指望系统里有完整工具链，先确认现状

受限环境里，缺的不只是 sudo。我在这台 Ubuntu 上想查看软件源或添加仓库时，发现add-apt-repository命令都没有，报错是sudo: add-apt-repository: command not found。这在精简安装的服务器上很常见，因为software-properties-common这个包没装，而装它又需要 sudo，形成了一个死循环。

所以，整个部署过程我尽量只用系统自带的东西：tar、wget、ldd、sha256sum这些基础命令。RIOT 的好处是它不依赖于系统里有没有add-apt-repository，只要 glibc 版本匹配，它自己就能跑。这也是我把“绿色部署”作为主方案而不是“想办法安装依赖”的原因。

3. 完整实操：在 Ubuntu 上无 sudo 部署并跑出测速结果

3.1 下载、校验、解压：校验这一步别省

RIOT 2026.07 的发布包命名一般是riot-2026.07-linux-x86_64.tar.xz，对应的校验文件是SHA256SUMS。下载时最好连校验文件一起下载，因为从网络上下载任何二进制都存在被篡改的风险。用sha256sum -c命令校验，能确保拿到的包和官方发布一致。

cd ~ wget https://example.com/riot/releases/riot-2026.07-linux-x86_64.tar.xz wget https://example.com/riot/releases/SHA256SUMS sha256sum -c SHA256SUMS --ignore-missing

校验通过后解压：

tar -xf riot-2026.07-linux-x86_64.tar.xz -C ~/riot

解压之后先看一眼目录结构，确认bin/riot和lib目录都在。然后检查主程序依赖了哪些系统库：

ldd ~/riot/bin/riot

输出里如果出现not found，也没关系，只要对应的库文件已经包含在~/riot/lib里，配置好LD_LIBRARY_PATH之后就能解决。

3.2 环境变量配置：把“用户级安装路径”告诉系统

要让 shell 一执行riot就找到它，需要把路径加入环境变量。当前会话直接执行：

export RIOT_HOME="$HOME/riot" export PATH="$RIOT_HOME/bin:$PATH" export LD_LIBRARY_PATH="$RIOT_HOME/lib:$LD_LIBRARY_PATH"

为了让以后登录也能直接用，把这三行写进~/.profile：

echo 'export RIOT_HOME="$HOME/riot"' >> ~/.profile echo 'export PATH="$RIOT_HOME/bin:$PATH"' >> ~/.profile echo 'export LD_LIBRARY_PATH="$RIOT_HOME/lib:$LD_LIBRARY_PATH"' >> ~/.profile

之所以写~/.profile而不是~/.bashrc，是因为~/.profile在登录 shell 时会加载，而~/.bashrc通常只在交互式终端里生效。如果不做这步，每次新开一个终端都要手动 export 一遍，比较烦。

3.3 用户级配置：端口、协议、带宽上限

RIOT 默认会找/etc/riot/config.toml，但没有 sudo 根本没权限在那里创建文件。解决办法是使用用户级配置目录。RIOT 支持通过环境变量RIOT_CONFIG_DIR指定配置目录，也可以直接放在~/.config/riot/config.toml，程序会自动识别。

配置文件我是这样写的，注意这是 TOML 格式：

# ~/.config/riot/config.toml [server] bind = "0.0.0.0" port = 10240 [client] protocol = "tcp" duration = 30 bandwidth = "40M" packet_size = 1400 report_csv = true csv_path = "logs/result.csv"

解释一下关键参数：

• bind = "0.0.0.0"：服务端监听所有网卡接口。
• port = 10240：避开低端口，普通用户可直接绑定。
• protocol = "tcp"：TCP 模式用来测真实传输吞吐，UDP 模式则更适合单独看链路丢包和抖动。
• duration = 30：测试时长 30 秒，太短的数据容易受突发流量影响。
• bandwidth = "40M"：客户端最高只发送 40 Mbit/s 流量，这样不会把链路彻底打满，方便观察稳定性。
• packet_size = 1400：接近 1500 MTU 上限，减少 IP 分片对测试结果的影响。
• report_csv = true：测试结束后导出 CSV，方便后续分析。

3.4 启动服务端和客户端，跑出 28 Mbit/s

两台机器都需要部署同样的 RIOT 包。服务端机器上启动：

cd ~/riot bin/riot server --interface wlan0 --json

--interface wlan0让它额外采集无线网卡状态，--json让日志以 JSON 格式输出，方便用脚本处理。看到日志里出现listening 0.0.0.0:10240说明服务端已经在监听了。

客户端机器上执行：

cd ~/riot bin/riot client --server 192.168.50.1 --port 10240 --duration 30 --bandwidth 40M --rssi

这里假设服务端 IP 是192.168.50.1。执行完之后，终端最后一屏会显示类似这样一段汇总：

Test ID : 20260718-153000 Link : wlan0 (IEEE 802.11a) Duration : 30.0 seconds Protocol : TCP Sent : 108.4 MB Received : 105.3 MB Throughput : 28.12 Mbit/s (3.51 MB/s) Loss : 0.4% RSSI : -62 dBm Noise : -94 dBm Link speed : 72.2 Mbit/s

这正是标题里那个 28 Mbit/s 的来源。

3.5 28 Mbit/s 怎么分析：数字背后的链路质量

28.12 Mbit/s 乘以 30 秒，就是客户端实际收到的数据量大约是 105 MB。而网卡协商速率显示 72.2 Mbit/s，说明实际吞吐大约是协商速率的三分之一到二分之一。这在 Wi-Fi 链路里非常正常，因为 802.11 协议本身有大量帧间隔、确认帧和管理帧开销，无线是半双工共享介质，有效吞吐从来不可能达到协商速率。

RSSI 是 -62 dBm，这个信号强度处于“能用但不惊艳”的范围。一般来说：

• -30 到 -50 dBm：信号非常好，通常能跑出较高的实际吞吐。
• -50 到 -65 dBm：信号良好，受干扰影响时速率会波动。
• -65 到 -75 dBm：信号偏弱，吞吐明显下降，丢包率会上升。
• -75 dBm 以下：连接不稳定，实际使用体验会很差。

丢包率 0.4% 说明链路整体是健康的，没有严重冲突。28 Mbit/s 这个结果一方面受限于无线信号，另一方面也可能和测试用的 TCP 拥塞控制算法有关。如果想进一步排除 TCP 的影响，可以把协议切到 UDP 再跑一轮，比如：

bin/riot client --server 192.168.50.1 --port 10240 --protocol udp --duration 30 --bitrate 50M

如果 UDP 能达到更高吞吐而且丢包很少，说明问题更多出在 TCP 窗口或拥塞控制上，而不是无线链路本身。

4. 避坑指南：没有 sudo 时最容易踩的 6 个坑

4.1 运行时缺库，报错 libpcap.so.1 not found

典型报错：

./riot: error while loading shared libraries: libpcap.so.1: cannot open shared object file: No such file or directory

这个不是灾难。用ldd ~/riot/bin/riot查看二进制依赖列表，找出not found的库，再确认官方 tarball 的lib目录里有没有对应文件。如果 tarball 里带的是libpcap.so.1.10.0，可以通过软链接让加载器找到：

ln -sf ~/riot/lib/libpcap.so.1.10.0 ~/riot/lib/libpcap.so.1

只要LD_LIBRARY_PATH里包含了~/riot/lib，再次运行riot就能顺利加载。

4.2 解压后没有执行权限

很多 tarball 打包时不一定保留了可执行位，解压出来的riot文件可能是 644 权限。直接运行会报Permission denied，但文件是自己目录里的，chmod不需要 sudo：

chmod +x ~/riot/bin/riot

这个坑特别容易让人误以为是“没有权限跑这个工具”，其实只是文件位的问题。

4.3 绑定低端口报 bind: Permission denied

如果你把端口配置成了 80 或者 443，普通用户运行服务端时一定会报权限错误。这个在 Linux 内核层面就已经限制了，非 root 用户无法绑定 1024 以下的端口。解决方式就是直接把端口改成 10240，或者更高。如果环境里对端口有安全准入要求，也可以选择 20000 到 50000 之间的高位端口，只要两端配置一致就行。

4.4 glibc 版本不兼容，GLIBC_2.34 not found

动态编译的二进制对系统 glibc 版本有最低要求，比如报错：

version `GLIBC_2.34' not found (required by /home/user/riot/bin/riot)

这表示系统里的 glibc 版本比编译时用的 glibc 旧。没有 sudo 不能升级系统 glibc，正确做法是去 Releases 页面选择musl或static标签的版本。musl 版本的二进制把所有用户态依赖都静态链接进去了，只有少量系统调用还需要内核支持，基本可以在任何现代 Linux 发行版上运行。

4.5 默认配置想写 /etc/riot，没有权限

RIOT 默认把配置放在/etc/riot，但受限环境下这里不可写。除了设置RIOT_CONFIG_DIR环境变量，也可以在主目录下建好配置目录：

mkdir -p ~/.config/riot

然后把配置写到~/.config/riot/config.toml，并在~/.profile里加上：

export RIOT_CONFIG_DIR="$HOME/.config/riot"

这样程序启动时会先读用户级配置，找不到再退回系统默认路径，既绕开了权限问题，也不会影响其它用户。

4.6 没有 systemd 权限，前后台进程怎么管

服务器上常驻进程一般用 systemd，但普通用户无权创建 systemd service。RIOT 这种测试工具未必需要长期驻留，但如果确实要后台运行，可以用tmux，也可以直接用nohup。

启动服务端后保持运行：

tmux new -s riot ~/riot/bin/riot server --port 10240 --interface wlan0

按Ctrl-b再按d可以退出暂离，过一会儿想回来看日志：

tmux attach -t riot

如果环境里连 tmux 都没有，直接nohup也是一个办法：

nohup ~/riot/bin/riot server --port 10240 --interface wlan0 > ~/riot/logs/server.log 2>&1 & echo $!

命令最后的echo $!会打印进程 PID，以后想停掉它，用kill PID就行，不需要 sudo。

5. 常见问题速查与排查命令

把这次实操中遇到最多的几类问题整理成一个速查表，后续再遇到类似情况可以直接对照。

受限环境里，很多常规排查命令也可能不可用，但依然有一批工具不需要 sudo 也能用：

• cat /proc/net/dev：查看各网卡累计收发字节数，判断数据是否真的在流动。
• ss -tun：查看 TCP/UDP 监听端口，不需要 root 也能列出大部分信息。
• watch -n 1 cat /proc/net/dev：每秒刷新一次网卡流量。
• python3 -c "import socket; ..."：用 Python 标准库快速测试端口连通性，不需要安装任何第三方库。

如果只是想知道服务端端口是否可达，又不想装nc，可以写一段极简的 Python：

python3 -c "import socket; s=socket.socket(); s.settimeout(3); s.connect(('192.168.50.1', 10240)); print('port open')"

能打印出port open，就说明 TCP 层面的连通性没问题，接下来要排查的就是吞吐测试时的无线参数或防火墙策略。

排查时还有一个很容易忽略的细节：无线链路测试结果受距离、遮挡、天气、信道干扰影响很大，一次 30 秒的结果不能代表整体链路质量。正确做法是至少在不同时间段跑三次，记录 RSSI、Noise、Throughput 三个指标，看趋势而不是看单次峰值。RIOT 导出的 CSV 里时间戳精确到秒，配合日志可以还原每一次吞吐波动发生时的无线状态，这一点比 iperf3 单看带宽数字要实用得多。

最后再分享一个部署习惯：拿到任何工具压缩包，先tar tf看目录结构，再ldd看依赖，基本就能判断能不能在受限环境里跑起来。优先找musl或-static构建的版本，能省掉至少 80% 的动态库麻烦。RIOT 2026.07 在这个环境里测出的 28 Mbit/s 算不上亮眼，但整件事最有价值的点在于：没有 sudo、没有装任何系统依赖，它照样跑起来了。这种用户态部署的思路，在以后遇到各种封闭环境时都很值得先试一把。