
nmlinux v1.7.11
适用于 Linux 的统一网络工具包 — Python 3 + PySide6
NMLinux · v1.7.16
一款面向 Linux 和 macOS 的统一网络工具包——检查、连接、诊断。
NMLinux 是一个单一、统一的图形界面,将 29 个网络模块汇聚于同一窗口:接口监控、Wi-Fi、DNS、SSH 终端、防火墙查看器、拓扑图、traceroute 等。完全使用 Python 和 PySide6(Qt 6)从零构建,支持 8 种界面语言,除标准系统工具外无任何外部依赖。
[!NOTE] NMLinux 与 Linux 系统守护进程
/usr/bin/NetworkManager(由 Red Hat/GNOME 开发的 NetworkManager)无关。 NMLinux 是一个使用 Python 和 PySide6 从零构建的独立项目。
由 Claude Code(Anthropic)及其作者共同构建。
开发过程
NMLinux 是在 AI 辅助下构建的——具体来说是 Claude Code——这一点在本仓库中没有任何隐藏。如今几乎每一个严肃的软件项目都在其流程的某个环节使用了 AI,无论它是否明说。因此,“是否使用了 AI”并不是有趣的问题。有趣的问题是:当 AI 出错时,有什么能发现它?
如果你更愿意亲自核实而不是听我一面之词,以下是能做到这一点的东西:
- 162 项测试——
pytest tests/ -v。纯逻辑测试加上少量真实的 Qt 控件测试(菜单、表格),没有把关键部分用 mock 掩盖掉。 docs/Decisions-Techniques.md——每一项非显而易见的技术决策、被否决的替代方案,以及被发现并修复的 bug(包括 AI 引入的 bug),都附有书面推理。docs/Architecture.md和docs/Carte-des-Modules.md——代码的实际结构,与实际发布的版本保持同步。- 每次发布前运行的 i18n 一致性检查,用于发现 8 种受支持语言中缺失的翻译键。
这些都不是因为 AI 不可信才存在的。它们存在,是因为任何东西都不该在没有检验流程的情况下发布——包括手写代码。请评判产出物及其验证方式,而不是评判帮助编写它的工具。
还是发现了 bug?这很有用,并不丢人——提交一个 issue。
社区
GitHub Discussions 已开放——分享反馈、提出想法、提问,或者只是打个招呼。作者拥有 30 多年的基础设施与运维经验,构建这个工具是因为 Linux 上也应该有优秀、免费且简单的软件。
截图
Linux 截图来自 v1.2.7——macOS 截图来自 v1.3.5。该应用现在有 29 个模块和 8 种界面语言(FR/EN/ES/DE/IT/PT/JA/ZH)。
Linux(KDE)
| 仪表盘 | 拓扑 |
|---|---|
![]() | ![]() |
| Traceroute | Wi-Fi |
|---|---|
![]() | ![]() |
macOS
| 仪表盘 | Traceroute |
|---|---|
![]() | ![]() |
更新日志
v1.7.16 — 2026-11-03
- AppImage — 更新信息:AppImage 现在内嵌
gh-releases-zsync|thongor77|nmlinux|latest|NMLinux-*x86_64.AppImage.zsync,并且每个发布版本都会附带匹配的.zsync文件,因此 AppImageUpdate 及类似工具可以从最新的 GitHub 发布版本对其进行增量更新(应 AppImageHub 目录检查的要求)。参见 DT-26。对 AUR/wheel 用户无影响。
v1.7.15 — 2026-11-03
- AppImage — 修复启动崩溃,第三次尝试:在 v1.7.14 修复了 glibc 问题之后,AppImageHub 测试仍然失败,因为应用在显示窗口之前就退出了——Qt 的
xcb平台插件无法加载(libxkbcommon-x11.so.0和libxcb-cursor0在打包中缺失,而该打包现在是在一个没有这些库的干净ubuntu:22.04容器中构建的)。现在容器会安装它们(以及其他libxcb-*辅助库),以便将它们打包进去。该打包还将 PySide6 固定在 6.12 以下,因为其 6.12.0 版本在 Python 3.11 下会在QPainter.drawPath中崩溃(参见 DT-25)。已在 Xvfb 下的干净 Ubuntu 22.04 容器中验证。
v1.7.14 — 2026-09-30
- AppImage — 修复启动崩溃,第二次尝试:v1.7.13 的修复(剥离打包的系统库)还不够——内嵌的 Python 解释器本身(
libpython3.14.so.1.0,针对 Arch Linux 开发机的 glibc 2.44 构建)仍然需要比 AppImageHub 目录测试机(Ubuntu 22.04,glibc 2.35)更新的 glibc 符号,因此 AppImage 在启动时仍然持续崩溃。build-appimage.sh现在改为在ubuntu:22.04容器内(通过podman)构建 PyInstaller 打包,而不是在宿主机上构建,因此每个内嵌二进制文件都链接到 AppImage 需要支持的确切 glibc 版本。
v1.7.13 — 2026-09-30
- AppImage — 修复启动崩溃(不完整,参见 v1.7.14):
build-appimage.sh直接从 Arch Linux 构建机的非常新的 glibc 中打包了共享库(libz.so.1、libstdc++.so.6、libX11.so.6、libfontconfig.so.1等)。在较旧的发行版上,AppImage 在启动时立即崩溃(GLIBC_ABI_DT_RELR' not found),被 AppImageHub 目录的自动化测试捕获。现在这些库已从打包中剥离,因此 AppImage 会回退到宿主系统自带的副本,这是 AppImage 的标准做法。
v1.7.12 — 2026-08-12
- Traceroute — 修复:在 Flatpak 下(v1.7.11,见下文——现已移除),
traceroute总是通过宿主 shim 在PATH上解析,即使宿主机没有安装真正的traceroute二进制文件,因此工作进程从未回退到tracepath,跟踪会立即完成,没有跳数,也没有显示错误。现在只要traceroute完全没有产生可解析的输出,无论为什么失败,它都会回退到tracepath。 - SSH 终端 — askpass 修复:当设置了
DISPLAY/WAYLAND_DISPLAY(任何 GUI 会话)且 ssh 没有干净的 tty 时,它可能会尝试使用$SSH_ASKPASS进行密码提示,而不是使用内嵌终端——如果没有安装 askpass 辅助程序,则会静默地认证失败。现在SSH_ASKPASS_REQUIRE=never强制密码提示始终通过终端本身进行。 - 移除 Flatpak 打包:v1.7.11 中提供的本地 KDE Linux 清单已停止使用。调查上述 SSH 密码提示 bug 时发现了一个内核级限制:通过
flatpak-spawn --host中继的进程永远无法成为转发 pty 的控制终端所有者(TIOCSCTTY被拒绝并返回EPERM——另一个不相关的会话已经拥有它;这是有意的内核安全边界,不是 bug)。唯一可行的变通方法(script,分配一个新的 pty)修复了密码提示,但破坏了该会话的实时终端调整大小传播——这被认为比完全不发布 Flatpak 更糟糕的权衡。今后支持的 Linux 安装途径是 AUR 和 AppImage。
v1.7.11 — 2026-08-03
- Flatpak 打包(KDE Linux):
packaging/flatpak/下的本地构建清单面向 KDE Linux 及其他仅支持 Flatpak 的发行版。宿主 CLI 工具(nmcli、pkexec、mount.cifs、ssh、nmap等)由 nmlinux 通过PATH上的flatpak-spawn --host垫片进行桥接调用,而不是逐个沙箱化;PySide6 来自 Flathub 的io.qt.PySide.BaseApp,而非 PyPI wheel。未发布到 Flathub——而是用packaging/flatpak/build-bundle.sh构建单个.flatpak包并附加到每个 release,与 AppImage 现有的方式相同。已在 v1.7.12 中停止支持——见上文。
v1.7.10 — 2026-08-03
- SSH 终端——修复:修复了一个竞态条件:如果会话启动时终端控件的实际尺寸尚不可知,PTY 可能以错误的(默认 24×80)尺寸启动,并静默丢弃调整尺寸的请求。这会使远程全屏应用(例如 Claude Code CLI、htop、vim)与实际窗口尺寸不同步,导致屏幕底部出现残留/陈旧文本,只有在新输出滚动经过时才会清除。由用户报告;已通过真实交互式会话复现
v1.7.9 — 2026-08-02
- SSH 终端——复制/粘贴:用鼠标选择文本(点击拖拽,高亮显示),用
Ctrl+Shift+C或右键菜单复制;用Ctrl+Shift+V粘贴(已有功能)。此前无法复制——根本不存在文本选择功能 - SSH 终端——多个同时会话:SSH 页面现在将每个连接打开在各自的标签页中,而不是单个共享会话。重新连接到已保存的连接——即使是同一个连接两次——过去会终止活动会话而不打开可用的替代会话;现在每次连接操作都会打开一个新的独立标签页
v1.7.8 — 2026-07-14
- 速度测试——新增 LAN(iperf3)标签页:在现有的互联网速度测试之外,新增一个标签页,针对内置的公共服务器列表(26 个国家)或已保存的自定义服务器(例如组织内部服务器)运行仅客户端模式的
iperf3测试。支持 TCP/UDP、IPv4/IPv6/自动,以及反向(下载)方向,UDP 测试会显示抖动/丢包。由 issue #6 建议 - 新增可选依赖:
iperf3——安装后即可启用 LAN 标签页;否则该标签页会显示提示横幅并保持禁用
v1.7.6 — 2026-07-05
- 资产清单——右键刷新:右键单击一个或多个已扫描的行(支持多选)并选择“刷新所选”,即可就地重新扫描这些主机,而无需重新运行完整的网络扫描
- 资产清单——SSH 认证失败反馈:被拒绝的 SSH 登录现在会显示“SSH 认证失败”,而不是静默失败,同时不会丢失 Nmap 检测到的主机名/操作系统基线——已在一台真实的 Synology NAS 上确认,该 NAS 的 DSM Auto Block 在首先尝试了其他已配置的凭据集后拒绝了正确的密码
v1.7.5 — 2026-07-04
- Ping 监视器——已保存目标目录:新增的左侧面板可让你将 ping 目标(名称、主机、间隔)保存到持久列表中,因此正在监视的主机在应用重启后仍然保留,无需重新输入。每个正在主动监视的行上的 ★ 按钮可在会话期间的任意时刻将该主机保存到目录中——无需在应用意外关闭前提前规划
- Ping 监视器——“开始监视”:选择一个已保存的目标并一键开始监视,复用其保存的间隔
v1.7.4 — 2026-07-04
- 资产清单 — 修复扫描结果不一致的问题:存活检查只发送一次超时为 1 秒的 ping 且不重试,在扫描器自身并发负载下(最多同时探测 40 台主机),或当 Wi-Fi 主机在信标之间短暂休眠时,可能会漏掉真实设备——已在一个真实子网上实测确认,同一网段重复运行会返回不同的设备数量。现在该检查会先重试 ping,再回退到 TCP 端口探测
- 资产清单 — 新增“刷新空结果”按钮:扫描后,仅重新扫描未返回任何数据的 IP,而不是再次扫描整个网段;新发现的主机会合并到现有结果中





