在 Linux 发行版中安装与配置 Happ

在 Linux 上安装 Happ：AppImage 与 .deb

Happ 的桌面版本发布在 GitHub 上 Happ-proxy 仓库的 Releases 页面。对于大多数发行版，通用的 AppImage 格式更方便，它无需安装即可从任意文件夹运行。针对 Debian 和 Ubuntu 系列，另有独立的 .deb 安装包。

下载与你的架构对应的最新文件（通常是 x86_64），先为 AppImage 添加可执行权限再运行：`chmod +x Happ-x86_64.AppImage` 与 `./Happ-x86_64.AppImage`。对于 .deb，使用 `sudo apt install ./happ_amd64.deb`，包管理器会自动拉取依赖。

如果 AppImage 无法启动，多半是缺少 FUSE 库。使用命令 `sudo apt install libfuse2`（Debian/Ubuntu）或你所用发行版的等价命令安装它。作为替代方案，可以将 AppImage 解压后直接运行：`./Happ-x86_64.AppImage --appimage-extract`，然后执行 `./squashfs-root/AppRun`。

导入订阅与配置

服务的 Telegram 机器人负责发放服务器访问权限：你可以在其中激活试用、付费或官方密钥，并获得形如 https://…/sub/… 的订阅链接。该链接包含最新的服务器列表和 Xray 参数，无需手动录入配置。

在应用中打开添加配置，粘贴订阅链接并保存。Happ 会以一个列表的形式加载所有可用服务器，之后也会通过同一链接更新它们。若服务器发生变化或新增了节点，只需点击更新订阅即可，无需重新安装。

如有需要，也可以添加单条配置：从机器人处复制 vless:// 或 ss:// 字符串，再通过从剪贴板导入的方式粘贴进去。同一个密钥可在所有设备上使用，因此 Linux、Windows 和移动端客户端的订阅是一致的。

在 Xray 内核上启动代理模式

导入后，从列表中选择一台服务器并开启连接。Happ 会在 Xray 内核上启动本地代理（SOCKS 和 HTTP），并通过它转发流量。在系统模式下，客户端会把代理写入桌面环境的设置，因此浏览器和大多数应用无需额外配置便可通过隧道工作。

本地代理端口可以在应用设置中手动指定——当你只想让某个特定程序走 Happ 时，这很方便。在浏览器的代理设置或环境变量中填入地址 127.0.0.1 和指定端口（例如 `export https_proxy=http://127.0.0.1:PORT`），其余流量则保持直连。

如需精细地分流流量，Happ 提供了基于列表的路由和 split tunneling——决定哪些域名和应用走代理、哪些绕过。关于规则和 utility 的详细讲解放在网站的单独章节，以免把基础安装与路由的精细设置混在一起。

让 Happ 随系统启动

要让代理自动启动，请把客户端加入桌面环境的自启动。创建文件 `~/.config/autostart/happ.desktop`，写入 `[Desktop Entry]`、`Type=Application`、`Exec=/完整/路径/Happ-x86_64.AppImage` 和 `X-GNOME-Autostart-enabled=true` 等行。GNOME、KDE 及大多数环境会在下次登录时加载它。

对于 .deb 安装，自启动可以直接在应用设置中开启，或通过你所用环境的自启动菜单设置——可执行文件的路径会自动填入。登录后 Happ 会缩小到系统托盘，可从时钟旁的图标访问。

如果你运行的是没有图形界面的 Linux，请把启动配置为 systemd 用户服务：把 unit 放到 `~/.config/systemd/user/`，在 `ExecStart` 中指定 AppImage 路径，并用命令 `systemctl --user enable --now happ.service` 激活自启动。

连接检查与故障排查

连接后，检查流量是否经由服务器：打开任意 IP 查询服务——地址和国家应与所选节点一致。如果 IP 没有变化，请确认系统代理已开启，且应用读取的是正确的本地端口。

遇到断线或速度慢时，在订阅列表里更换服务器——相邻节点往往能提供更稳定的路由。随后更新订阅以获取最新的 Xray 参数，并重启连接。有时本地防火墙会造成干扰：在 ufw 或 firewalld 中允许 Happ 的出站连接。

如果更新客户端后服务器列表无法加载，请检查 Telegram 机器人中密钥的有效期以及订阅链接是否正确。连接日志可在应用内查看，有助于区分是密钥问题还是网络封锁。