Shadowrocket Linux 版安装:deb、rpm 与 AppImage 该下哪个

先确认发行版与架构

Shadowrocket（小火箭）的 Linux 安装不能只看文件扩展名。deb、rpm 是不同软件包管理体系的格式，AppImage 则是可执行应用文件；三者都需要匹配当前 CPU 架构和运行环境。先在终端运行下面的只读命令，不会修改系统设置。

cat /etc/os-release
uname -m

/etc/os-release 中的 ID 与 ID_LIKE 用于辨认发行版及其家族。uname -m 输出 x86_64 表示常见的 64 位 Intel / AMD 架构，输出 aarch64 通常表示 ARM64。安装包必须同时满足“格式正确”和“架构匹配”；AppImage 也不能跨 CPU 架构直接运行。

“使用 rpm”不等于“所有 rpm 发行版都可直接安装同一个文件”。例如，系统使用的包管理器不一定是 dnf，基础库版本也可能不同。遇到未满足的依赖时应读取具体错误，而不是把扩展名改成 deb，或强行忽略依赖。

获取安装包与检查信息

从本站获取应用页面进入 Linux 区域，按当前提供的格式和架构选择文件。实际安装包由下载页解析到本站 /dl/shadowrocket/ 路径。不要根据示例拼接文件名，也不要因为浏览器下载列表里出现多个旧文件就随意选一个。

1. 确认系统

   运行 cat /etc/os-release 和 uname -m，记录发行版家族与 CPU 架构。

2. 选择格式

   在获取应用页面选择 Linux 的 deb、rpm 或 AppImage；下载页未列出的架构不要用其他架构文件替代。

3. 记录文件位置

   在文件管理器确认下载完成，记录完整路径。以下命令使用交互输入读取真实路径，不依赖固定安装包名称。

4. 检查包信息

   deb 使用 dpkg-deb -f，rpm 使用 rpm -qpi 查看信息；AppImage 可先用 file 辨认文件类型与架构。

deb 使用 apt 安装

在 Ubuntu、Debian 上，优先让 apt 安装本地 deb。与单独解包相比，apt 会同时检查软件包依赖，并尝试从当前系统已经配置的软件源获取所需组件。系统软件源不可用时，客户端安装也可能停在依赖下载阶段。

read -r -p '输入 deb 文件完整路径：' pkg
dpkg-deb -f "$pkg" Package Version Architecture
dpkg --print-architecture
sudo apt install "$pkg"

前两项架构信息应当相容，例如系统架构为 amd64 时选择对应的 x86-64 安装包。确认 apt 展示的安装计划后再继续。输入 sudo 密码时终端通常不显示字符，这是正常行为，不代表键盘失效。

• 出现“文件不存在”：确认输入的是实际下载文件的完整路径，不是下载目录，也不是浏览器里的网页地址。
• 出现“依赖无法满足”：保留完整的依赖名称与版本约束，先检查系统发行版是否符合该包要求。
• 出现软件源索引过期：可先运行 sudo apt update，成功后重试安装；它更新索引，不等于升级所有系统软件。
• 系统此前已有未完成的包操作：先阅读 apt 提示处理包管理状态，不要反复启动多个安装进程。

安装完成后，从桌面应用菜单打开 Shadowrocket。不要为了绕过普通启动问题而用 sudo 运行整个图形客户端；需要系统网络权限时，按实际出现的授权流程处理。

rpm 使用 dnf 安装

在 Fedora 等使用 dnf 的系统上，用 dnf 安装下载到本地的 rpm。该方式会检查依赖关系并显示事务计划。下面的查询操作只读取包信息，真正修改系统的是最后一条安装命令。

read -r -p '输入 rpm 文件完整路径：' pkg
rpm -qpi "$pkg"
rpm --eval '%{_arch}'
sudo dnf install "$pkg"

检查 rpm 信息中的 Architecture 是否与本机相符。如果输出出现依赖冲突或基础库版本不足，先判断是不是选错了发行版适用范围；不要使用跳过依赖检查的参数把文件强行写进系统。

AppImage 先加权限

AppImage 不需要像 deb、rpm 那样先注册到系统包数据库，但“免安装”不等于“没有运行条件”。文件需要执行权限，存放位置必须允许执行，其运行时也可能需要 FUSE 支持。建议先将文件保存在用户自己的本地目录，再从终端运行以查看报错。

read -r -p '输入 AppImage 文件完整路径：' app
file "$app"
chmod u+x "$app"
"$app"

chmod u+x 只给文件所有者增加执行权限，不需要把文件权限扩大到所有人可写。最后一行直接运行用户输入的文件。若终端提示 Exec format error，优先检查架构和文件类型；反复增加执行权限不能解决架构不匹配。

• Permission denied：用 ls -l "$app" 检查所有者与执行位；若执行位已有，再检查文件所在分区是否使用了 noexec 挂载选项。
• libfuse.so.2 缺失：说明当前 AppImage 运行时需要 FUSE 2 兼容库。不同发行版的包名可能是 libfuse2 或 libfuse2t64，应查询本机软件源后安装相应库。
• 双击只打开文件选择对话框：先完成执行权限设置，并在终端运行一次；文件管理器的双击行为不能代替错误日志。
• 提示 GLIBC 版本不足：这是基础运行库兼容问题，不要手工覆盖系统 libc；选择符合运行要求的系统环境。

首次启动后检查

窗口能打开，只说明程序成功启动，不代表已有可用连接。以下操作以用户已经持有自己的服务商与订阅为前提。本站不提供、不销售、不推荐节点或订阅；安装包本身不会生成服务凭据。

1. 进入 Home，使用添加入口；订阅类型选择 Subscribe，粘贴自己已有的订阅地址并保存。不要把订阅地址填进单个服务器的地址栏。
2. 在 Home 更新该订阅，检查是否出现预期的配置项目。更新结果为空时，先确认订阅有效期、返回内容与访问状态，不要立刻重装应用。
3. 需要规则分流时进入 Config，确认已经导入并启用相应配置，再将 Global Routing 设为 Config。
4. 选择已有的可用项目，开启连接，按实际提示完成必要的网络授权，然后测试一个已知可访问的网站。

排查时先区分“订阅更新失败”和“开启连接后访问失败”。前者发生在获取配置阶段，后者还涉及服务状态、DNS 与路由规则。不要一边更换安装包，一边修改多项配置，否则很难确认是哪一步改变了结果。

初次测试保持手动连接即可。若此前设置过自动连接，再检查 Settings → On Demand 的当前状态，避免测试过程中被已有条件改变连接状态；不同平台应以实际提供的选项为准。

常见报错怎么分辨

记录错误时保留命令、完整报错与系统架构即可。订阅 URL、访问令牌和服务器密码不应出现在公开日志中。以下问题按“安装前、启动时、联网后”区分，避免把依赖问题误判成订阅问题。