AI Booster on Linux

Linux 客户端是一个 Qt 6 / QML 桌面应用程序。软件包发布在 GitHub Releases 上。

它在 Ubuntu 22.04 (Qt 6.2) 和 Ubuntu 24.04 (Qt 6.4) 上构建和运行。其他装有 Qt 6.2 或更新版本的发行版通常也能工作，但只有这两个版本经过了实际测试。

安装

从发布页面下载适用于您系统架构的软件包，并使用您的发行版的包管理器进行安装。

发布包中包含一个预构建的隧道引擎，因此安装后即可工作。无需再获取任何其他东西。

构成原理

这值得了解，因为它解释了一些您可能误认为是 bug 的事情：

用户界面和隧道引擎是两个独立的程序。客户端将引擎作为子进程启动，并通过环回（loopback）与其通信——它从不将引擎加载到自身进程中。这个边界是刻意设计的：引擎是 GPL-3.0 授权的独立作品，并且将其保持在进程外也意味着，引擎崩溃时只会在窗口中显示为错误，而不会导致整个应用程序随之崩溃。

您会看到一个结果：如果引擎启动失败，UI 会保持运行并报告该问题。这是设计如此，而不是半崩溃状态。

客户端是开源的——指界面，而非引擎。其仓库是 AllianceInterStellar/aibooster-linux，如果您想自行编译，里面有构建说明。请注意，从源码构建的版本不包含引擎；您需要另外提供。

桌面代理及其撤销方法

这是本页最重要的内容。

当您连接时，客户端会将您桌面的代理设置重定向到引擎的本地入站端口——在 GNOME、Cinnamon 和 MATE 上是 gsettings，在 KDE Plasma 上是 kioslaverc。这是一个机器范围的状态，其生命周期长于该进程。如果客户端在代理被重定向时意外消失，桌面上的每个应用程序都会继续尝试访问一个没有任何服务监听的端口，其症状是“机器断网了”，且没有明显原因。

客户端的设计旨在避免让您陷入这种困境：

• 在更改任何设置之前，它会将您之前的设置写入 $XDG_STATE_HOME/aibooster/system-proxy-restore.json，并在下次启动时重放该文件。
• SIGINT、SIGTERM 和 SIGHUP 信号都会被处理，因此有序关闭——例如关闭窗口、注销、重启——会立即恢复代理设置。
• 任何程序都无法处理 SIGKILL 信号。在这种情况下，代理会一直保持重定向状态，直到您再次启动应用，届时它会自动恢复。

如果您需要手动撤销而不是等待：

# GNOME、Cinnamon、MATE
gsettings set org.gnome.system.proxy mode none
 
# KDE Plasma
kwriteconfig6 --file kioslaverc --group 'Proxy Settings' --key ProxyType 0

添加 profile

粘贴单个节点链接或一个 subscription URL。所有平台识别的 scheme 都是相同的：vless://、vmess://、trojan://、ss://、hysteria2:// (也包括 hy2://、hy://)、tuic://、wg://、ssh:// 和 warp://。一个 http:// 或 https:// 链接被视为一个 subscription——它会被获取并可刷新，而不是作为单个固定节点存储。

界面显示内容

• Subscription 和 profile，以及在它们之间切换
• 带有延迟测量的服务器列表，以及引擎自身的 selector 和 url-test 分组
• 从引擎本地 API 读取的实时流量和连接数
• 窗口内显示的引擎日志流
• 路由、DNS、入站、TLS 和 WARP 设置

故障排除

应用启动了但引擎没有启动。 窗口中会显示此信息。请检查软件包是否已完整安装——从源码构建的版本按设计是不捆绑引擎的。

崩溃后整个桌面都断网了。 再次启动 AI Booster；它会在启动时重放已保存的代理设置。如果您希望直接修复，请使用上面的两个命令。

已连接，但无法加载任何内容。 这通常是节点问题，而不是客户端问题。首先尝试同一 profile 中的另一个节点；完整的诊断步骤 涵盖了其余情况。

卸载

使用您的发行版的包管理器移除该软件包。在卸载之前，请先在应用内断开连接，以恢复桌面代理设置——一旦软件包被移除，已保存的设置文件将不会再为您自动恢复。