Shadowrocket Linux 版安装:deb、rpm、AppImage 怎么选与 apt/dnf 命令

一、先确认发行版、架构与安装格式

不要只看文件扩展名就开始安装。发行版决定使用哪一类包管理器，处理器架构决定文件能否在当前设备执行。先在终端运行下面两条命令，记录发行版的 ID、ID_LIKE 和架构输出，再进入下载指南的 Linux 区域选择实际提供的选项。

cat /etc/os-release
uname -m

x86_64 通常对应下载页上的 x64 或 amd64 标识；aarch64 通常对应 ARM64。它们是架构名称的不同写法，不表示可以混装。下载页没有匹配架构时，不要把另一架构的包强行装入系统，也不要仅凭电脑品牌推断处理器类型。

其他使用 rpm 的发行版未必采用 dnf，应使用该系统的原生包管理方式。AppImage 也不是任何 Linux 都能运行的通用保证：桌面会话、系统库和运行时能力仍需满足实际要求。本文命令面向桌面安装，不把纯命令行服务器视为已经具备图形运行条件。

二、从下载到启动：先完成这五步

Linux 安装包从本站下载页获取，不需要在文章中寻找固定文件直链。为避免把下载文件名误当成永久名称，下文统一使用用户自行重命名后的本地文件名；这些名称只是命令示例，不代表下载包的原始命名。

1. 识别系统

   运行 cat /etc/os-release 和 uname -m，确认发行版与处理器架构。不要用文件扩展名代替架构核对。

2. 选择安装包

   打开下载指南，在 Linux 区域选择适合当前系统的 deb、rpm 或 AppImage。只下载本次要使用的格式即可。

3. 整理本地文件

   在文件管理器中，把所选文件分别重命名为 shadowrocket-local.deb、shadowrocket-local.rpm 或 Shadowrocket-local.AppImage，保留对应扩展名。

4. 打开终端

   在文件所在文件夹使用桌面提供的终端入口，运行 pwd 和 ls -l 确认位置。终端初始目录不一定是浏览器的下载目录。

5. 安装并启动

   按下文对应命令处理一种格式。deb、rpm 安装完成后查看应用菜单；AppImage 在当前目录直接运行。首次启动先确认窗口能够正常打开，再处理连接配置。

三、deb 与 rpm：用包管理器安装本地文件

Debian、Ubuntu：apt 安装 deb

在保存 deb 文件的目录执行下面的命令。./ 表示当前目录中的文件，它能明确告诉 apt：这里要安装的是本地包，而不是按名称到软件源搜索。apt update 更新软件源索引，不等于升级整套系统。

sudo apt update
sudo apt install ./shadowrocket-local.deb

先阅读 apt 列出的安装计划，再确认执行。若依赖无法满足，记录报错中具体的包名和版本约束，检查当前发行版的软件源是否正常、所选包是否适合当前系统。不要通过忽略依赖来把失败的安装变成表面成功，也不要为了一个安装提示随意混入其他发行版的软件源。

Fedora 等 dnf 环境：安装 rpm

sudo dnf install ./shadowrocket-local.rpm

dnf 同样会读取本地包信息，并尝试从已配置的软件源解析依赖。出现软件包签名或来源相关提示时，先核对文件是否来自本站下载页，再查看提示涉及的是安装文件还是仓库设置；不要直接添加跳过验证的参数。安装成功说明包管理流程完成，不代表桌面会话和网络配置也已完成。

四、AppImage：添加执行权限后启动

AppImage 的基本操作是给文件添加执行权限，再从当前目录运行。它通常不经过 apt 或 dnf 的安装登记。以下命令使用前面约定的本地文件名，普通用户即可执行，不要因为双击没有反应就改用 sudo 启动图形程序。

chmod u+x ./Shadowrocket-local.AppImage
./Shadowrocket-local.AppImage

chmod u+x 只为文件所有者增加执行权限，不会安装缺失的系统组件，也不会解除文件系统的 noexec 限制。若文件保存在外接存储、共享目录或受限挂载点，建议先移到个人主目录中允许执行的普通目录，再按需运行。复制后可以用 ls -l 查看权限，但不要为了启动一个文件递归修改整个主目录的权限。

• 看到 Permission denied：先检查执行位、上级目录访问权限，以及所在挂载点是否禁止执行。
• 看到 Exec format error：优先核对 uname -m 与下载包架构，再确认下载是否完整结束。
• 看到 FUSE 或 libfuse.so.2 相关错误：按当前发行版查询所需兼容组件；不同发行版的软件包名称可能不同，不要照搬另一系统的安装命令。
• 看到动态库或桌面显示相关错误：保留终端完整输出，区分系统库问题与图形会话问题，不把它们归入执行权限错误。

AppImage 是否需要特定 FUSE 组件取决于其打包方式和运行环境，并非每次启动都必然缺少它。先读错误再处理，能避免安装无关组件。桌面文件管理器对可执行文件的双击行为也可能不同，首次排查用终端启动更容易看见错误原因。

五、deb、rpm 与 AppImage 的维护方式

选择格式不仅影响第一次启动，还影响后续更新与移除。通过本地 deb 或 rpm 安装，不等于系统已经添加了自动更新的软件源；是否存在更新源应以实际安装结果为准。需要更新时先退出客户端，再从下载页选择适合当前系统的文件，并阅读包管理器给出的变更计划。

无论使用哪种格式，删除程序文件与删除个人配置都是两件事。更换安装方式前先保留当前配置；不要在不了解用途时清空整个用户配置目录。若应用菜单和手动启动出现不同表现，先退出所有副本，确认实际启动的文件路径，再进行下一步排查。

六、安装完成后：区分启动、配置与连接问题

能打开窗口是安装阶段的检查结果，不是线路可用性的证明。后续操作以用户已有自己的服务商与订阅为前提。本站不提供、不销售、不推荐节点、订阅或连接服务；客户端获取与用户已有的连接服务应分别处理。

• 程序未启动：先定位架构、依赖、执行权限和图形会话问题，暂不修改订阅或规则。
• 程序已启动但没有配置：按使用教程导入用户已有配置，核对链接是否完整；不要把客户端安装成功当作已自动获得连接参数。
• 导入后无法连接：核对服务器地址、端口、协议与凭据是否与已有配置一致，再查网络错误；反复重装通常不会修正这些字段。
• 连接后访问异常：继续按排查手册区分路由、规则和 DNS 问题，不要同时改动多项设置后再判断原因。

在使用相应界面的设备上，Home 用于查看连接与配置入口，Config 用于管理规则配置，Settings 用于设置；这些操作与 Linux 包管理器安装依赖不属于同一层。跨平台核对时，以当前设备实际显示的入口为准，不把某个平台的系统 VPN 授权路径机械套用到 Linux。

七、Linux 安装常见问题