Shadowrocket Linux 版安装:deb、rpm、AppImage 怎么选

先确认发行版、架构与桌面环境

安装格式由发行版的包管理体系决定，不由桌面主题决定。同样使用 GNOME 的 Ubuntu 与 Fedora，通常分别选择 deb 与 rpm。AppImage 可以作为其他发行版的候选，但仍受 CPU 架构、系统运行库与桌面环境限制，不能理解为在所有 Linux 系统上均可直接运行。

cat /etc/os-release
uname -m

第一条命令查看 ID、ID_LIKE 与 PRETTY_NAME，第二条查看机器架构。常见的 x86_64 对应 x64，aarch64 对应 ARM64；下载时以页面实际提供的架构为准。更换 deb、rpm、AppImage 后缀不能改变文件格式，也不能解决架构不匹配。

• Debian / Ubuntu：选择 deb，用 apt 安装本地文件并处理可用软件源中的依赖。
• Fedora：选择 rpm，用 dnf 安装；openSUSE 同属 rpm 体系，但使用 zypper。
• 其他桌面发行版：先查看是否有适配的 AppImage，再核对运行条件。
• 纯命令行服务器：本文说明桌面应用安装，不将图形程序等同于后台服务；没有图形会话时，不应只因窗口未出现就判断安装损坏。

下载后按四步完成准备

下面命令中的文件名只是便于输入的本地名称，不是本站安装包的固定命名。请先在文件管理器中把下载完成的文件重命名为对应名称，再执行命令；保留原名时，也可将文件拖入终端取得完整路径。不要把浏览器尚未完成下载的临时文件当作安装包。

1. 确认系统

   运行 cat /etc/os-release 和 uname -m，记录发行版、架构；Debian 系还可用 dpkg --print-architecture 查看包管理器使用的架构名称。

2. 获取文件

   打开Linux 下载分区，按页面实际提供的格式与架构下载，不通过修改扩展名转换安装包。

3. 整理路径

   将文件放进 ~/Downloads，按格式重命名为 Shadowrocket.deb、Shadowrocket.rpm 或 Shadowrocket.AppImage。如果系统下载目录名称不同，使用实际路径。

4. 安装并启动

   只执行下文与所选格式对应的一组命令。deb、rpm 安装后从应用菜单启动；AppImage 直接运行文件。首次排查时保留终端输出。

deb 与 rpm：使用系统包管理器安装

本地包路径前的 ./ 有实际作用：它告诉包管理器读取当前目录中的文件，而不是只按包名查询软件源。安装操作使用 sudo 提权，日常启动图形程序则使用普通用户，不要把整次桌面运行都放到 root 身份下。

Debian / Ubuntu 操作

cd ~/Downloads
dpkg-deb -f ./Shadowrocket.deb Package Architecture Depends
sudo apt install ./Shadowrocket.deb

dpkg-deb -f 用于读取包内元数据，不会安装程序。若 apt 提示软件源索引过旧，可先运行 sudo apt update 再重试；若提示架构错误，应重新选择正确架构，而不是增加强制安装选项。遇到无法满足的依赖，记录具体依赖名和系统版本，不要直接移除系统核心库。

Fedora / openSUSE 操作

cd ~/Downloads
rpm -qp --queryformat '%{NAME} %{ARCH}\n' ./Shadowrocket.rpm

# Fedora
sudo dnf install ./Shadowrocket.rpm

# openSUSE：使用这一条，不执行上面的 dnf 命令
sudo zypper install ./Shadowrocket.rpm

rpm 是封装格式，不代表所有使用 rpm 的发行版具有相同运行环境。如果包管理器明确报出依赖不可用，先核对下载页适用条件；不要使用忽略依赖的方式把错误留到启动阶段。安装完成只说明文件和登记信息已写入系统，不代表配置与网络连接已经验证。

AppImage：加执行权限后从终端启动

AppImage 通常不按 deb、rpm 的方式登记到系统包数据库。它作为一个文件保存，首次使用要增加执行权限；移动或删除该文件会影响原有快捷方式。建议放入固定目录，而不是长期留在会被自动清理的下载目录。

mkdir -p "$HOME/Applications"
mv "$HOME/Downloads/Shadowrocket.AppImage" "$HOME/Applications/"
cd "$HOME/Applications"
chmod u+x ./Shadowrocket.AppImage
./Shadowrocket.AppImage

如果 chmod 已成功，但运行仍提示权限不足，可用 findmnt -T ./Shadowrocket.AppImage 查看所在文件系统的挂载信息。可移动磁盘或受限目录可能使用 noexec；优先将文件移到允许执行的用户目录，不必为了单个应用放宽整块磁盘的限制。若提示 FUSE 相关错误，不要照搬其他发行版的库名，也不要先执行大范围系统升级。

首次启动：先导入，再检查 Global Routing

能看到窗口后，安装阶段基本完成。接下来按用户已有配置操作：Home 管理服务器与订阅，Config 管理规则配置，Settings 调整客户端设置。安装包格式不会替代这些配置，也不会自动提供可连接的服务。

1. 在 Home 点击「+」，将 Type 设为 Subscribe，填写自己已有的订阅地址并保存；导入后刷新订阅，确认列表出现预期条目。订阅地址通常包含访问凭据，不要放进公开截图。
2. 在 Home 选择已有条目，运行 Connectivity Test。测试失败先检查地址、端口、认证与当前网络，不能仅凭安装成功判定远端可达。
3. 在 Config 导入并选用自己的规则配置，再检查 Global Routing。首次验证连接时先手动操作，自动连接需求可在 Settings → On Demand 中另行设置；该设置不替代协议参数和路由规则。

如果当前界面提供 Scene，应检查已选场景的条件与策略，不把它当作 Config 的同义词。修改姿态后重新发起请求，避免用浏览器仍保持的旧连接判断新设置。需要检查规则语法或 DNS 时，继续使用排查手册。

安装、升级与启动的常见问题