本文适合已准备在 Linux 桌面安装 Shadowrocket 的用户。先确认发行版与处理器架构，再从下载页选择 deb、rpm 或 AppImage；随后用包管理器安装，或为 AppImage 添加执行权限。最后区分安装失败、桌面启动失败与连接配置问题，避免把三类问题混在一起处理。
先确认发行版、架构与安装包格式
Shadowrocket（小火箭）的 Linux 安装包从本站下载页获取。格式由发行版决定，架构则由设备和系统环境决定。文件扩展名相同，不代表包内程序适用于当前处理器；AppImage 也不等于任意架构通用。
在桌面终端执行下面两条命令。第一条显示发行版标识，重点查看 ID、ID_LIKE 与 PRETTY_NAME；第二条显示内核报告的机器架构。常见的 x86_64 与 aarch64 属于不同架构，选择时以下载页实际列出的支持范围为准。
cat /etc/os-release
uname -m| 系统环境 | 优先检查的格式 | 处理方式 |
|---|---|---|
| Debian、Ubuntu 及兼容环境 | deb | 用 apt 安装本地包，并处理软件源中可用的依赖。 |
| Fedora 及使用 dnf 的兼容环境 | rpm | 用 dnf 安装本地包，核对事务中的依赖变化。 |
| 其他桌面发行版 | AppImage | 先确认架构与运行环境，再添加执行权限。 |
deb 安装：使用 apt 处理本地包与依赖
在 Debian 或 Ubuntu 桌面上，优先让 apt 接管 deb 安装。双击 deb 后打开的软件安装器也可处理本地包，但终端会保留完整错误信息，更便于区分缺少依赖、架构不符或权限不足。
-
确认系统
执行
cat /etc/os-release与uname -m。确认当前环境使用 apt，并记录架构。 -
获取安装包
打开下载页的 Linux 区域，选择适用的 deb。保留下载后的实际文件名，不手工改扩展名。
-
复制路径
在文件管理器查看文件位置，复制完整路径。运行下方命令后，在终端提示处粘贴路径；不要在输入内容两侧另加引号。
-
执行安装
核对 apt 列出的安装和依赖事务，确认后继续。安装成功再从桌面应用列表启动 Shadowrocket，不用 sudo 启动图形应用。
read -r -p '粘贴 deb 文件的完整路径：' pkg
pkg=$(realpath -- "$pkg")
sudo apt install "$pkg"这里的 pkg 是终端变量，保存你输入的实际文件路径；命令中的双引号用于保护路径中的空格。realpath 将路径转换成绝对路径，避免 apt 把一个裸文件名误当成软件源中的包名。执行前确认输入指向实际存在的 deb 文件。
- 提示依赖无法满足：查看缺少的具体依赖及所需条件，核对当前发行版是否受支持。
sudo apt update只能刷新已配置软件源的索引，不会让不兼容的包变得兼容。 - 提示架构不匹配：重新核对
uname -m与下载页的架构说明，不要用强制参数绕过检查。 - 此前使用其他方式留下未完成的依赖事务：先阅读
sudo apt --fix-broken install提出的变更，确认不会误删所需软件后再继续。
rpm 安装：使用 dnf 检查安装事务
在使用 dnf 的系统中，用 dnf 安装本地 rpm，通常比直接调用底层 rpm 安装命令更便于处理依赖。rpm 是包格式，不是兼容性保证：不同发行版的软件源、系统库与打包约定可能不同。
read -r -p '粘贴 rpm 文件的完整路径：' pkg
pkg=$(realpath -- "$pkg")
sudo dnf install "$pkg"命令会把本地包交给 dnf，再由当前系统的软件源提供可用依赖。出现事务摘要时，逐项查看新安装、升级或删除的软件。若出现大量与安装目标无关的替换或删除，取消事务并重新核对包的适用环境。
deb 路径检查
- 安装工具
apt install- 输入对象
- 本地 deb 的绝对路径
- 依赖来源
- 当前配置的软件源
- 成功依据
- 安装事务结束且没有错误
安装器报错时先处理包与依赖，不进入连接排查。
rpm 路径检查
- 安装工具
dnf install- 输入对象
- 本地 rpm 的绝对路径
- 依赖来源
- 当前启用的仓库
- 停止条件
- 架构错误或依赖无法满足
不要用跳过依赖检查的方式把失败事务变成表面成功。
如果终端提示 dnf: command not found，先确认系统实际使用的包管理器。并非所有接受 rpm 的发行版都使用 dnf，不要仅为照抄命令而安装另一套包管理器。应回到发行版说明与下载页支持范围，选择匹配的处理方式。
AppImage 运行：添加执行权限并查看启动输出
AppImage 通常以单个可执行文件运行，不通过 apt 或 dnf 注册为普通系统包。先把文件放到当前用户拥有的固定目录，再添加执行权限。首次运行建议在桌面会话的终端中执行，保留错误输出；不要通过 sudo 运行整个图形程序。
read -r -p '粘贴 AppImage 文件的完整路径：' app
app=$(realpath -- "$app")
chmod u+x -- "$app"
"$app"chmod u+x 给文件所有者添加执行权限；常见写法 chmod +x 也用于添加执行权限，但这里明确只修改所有者的执行位。变量引用中的双引号使带空格的路径仍作为一个参数传入。执行权限不会改变架构，也不会补齐系统运行库。
- 出现
Permission denied：用ls -l -- "$app"查看执行位，并检查文件是否位于禁止执行的挂载点。即使执行位已设置，noexec挂载选项仍可阻止运行。 - 出现
Exec format error：检查架构与文件格式。不要继续反复修改权限；权限不是这类错误的主要原因。 - 提示 FUSE 相关库缺失：按当前发行版文档安装兼容组件。不同发行版的包名可能不同，不要把其他系统的包名直接套用。
- 提示无法连接显示服务：确认是在已登录的图形桌面会话中运行。普通 SSH 终端或无显示服务的环境不能直接等同于桌面启动环境。
首次打开后：区分安装成功与连接成功
能打开 Shadowrocket 窗口，说明程序已进入桌面启动阶段，不代表用户已有的服务已导入，也不代表系统流量已按预期处理。安装器日志负责解释安装问题；应用内的配置与连接状态负责解释联网问题，两者应分别检查。
在 Home（首页）检查当前服务配置，按已有服务资料核对地址、端口、协议与认证字段。不要根据协议名称猜端口：例如资料写明端口为 443，就填写该值，不能因为更换协议而自行改成另一个端口。导入含访问凭据的链接时，不要把完整链接写进公开日志或截图。
Config（配置）
推荐Global Routing（全局路由）按当前配置文件匹配规则。先在 Config（配置）确认文件已选中；未被前序规则匹配的连接由 FINAL 指定策略处理，并非固定直连。
适合：已有经过核对的配置文件，需要按目标分流。
Proxy（代理）
在客户端接管的连接范围内采用代理姿态，可用于判断规则分流是否与问题有关。它不意味着操作系统中所有进程、所有协议都已被接管。
适合：已有可用服务，临时缩小规则相关故障的排查范围。
Direct（直连）
采用直接连接目标的姿态。若当前目标需要经过用户已有的代理服务，保持 Direct 不能验证该代理服务是否可用。
适合：检查基础网络与直连访问表现。
Global Routing 中的 Scene（场景）应结合已设置的场景使用，不作为首次安装排错的默认选择。Settings（设置）中的 On Demand（按需连接）用于按条件触发连接，也不负责修复依赖或授予文件执行权限。先手动确认连接，再设置自动化条件；不同平台的可见选项以实际界面为准。
安装报错问答与后续更新
下载了 deb，系统却提示不支持，改成 rpm 后缀行吗？
不行。扩展名不决定内部包结构。执行 cat /etc/os-release 确认系统，再回下载页选择对应格式。不要靠改名或绕过包管理器检查来安装。
AppImage 已经 chmod +x，为什么双击还打不开？
在图形桌面的终端中直接运行文件，读取第一条错误。若是权限错误，查执行位与挂载选项；若是架构或缺库错误，按对应类别处理。双击没有窗口不足以判断原因。
安装成功后，应用菜单里怎么还找不到？
先关闭并重新打开桌面应用搜索。deb、rpm 的菜单入口取决于包是否提供桌面启动文件；AppImage 不一定自动注册入口。不要猜测可执行命令名，也不要因此重复安装多种格式。
以后更新需要把旧文件全删掉吗？
先保存已有配置。deb、rpm 在包身份和升级关系兼容时可交给对应包管理器更新；若提示冲突，先停止并阅读原因。AppImage 应退出程序后替换文件，再核对执行权限与快捷方式路径。
结束排查时，保留发行版名称、架构、安装格式、执行命令与完整错误文本。这些信息比“打不开”更能定位问题。分享日志前删除订阅访问凭据、密码及其他敏感字段；若应用已正常打开而网络不通，转入连接与配置检查，不再重复执行安装命令。