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

按发行版选安装包:deb 用 apt 安装,rpm 用 dnf 安装,AppImage 加执行权限后直接运行。附首次启动的常见报错和处理方法。

本文速览

本文适用于准备在 Linux 桌面安装 Shadowrocket(小火箭)、且已有自己服务商与订阅的用户。先确认发行版和 CPU 架构,再选择 deb、rpm 或 AppImage;完成安装后,分别验证应用启动、订阅导入和请求连接,避免把安装问题与配置问题混在一起。

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

deb、rpm 与 AppImage 是不同的 Linux 软件分发形式,不是不同的代理协议。选择时先看发行版使用的包管理器,再核对下载页列出的架构与运行要求。把文件后缀从 .rpm 改成 .deb 不会转换包格式,也不能解决架构不匹配。

打开终端执行以下命令。/etc/os-release 用于辨认发行版,uname -m 用于确认架构;两项信息应分别核对,不能仅凭桌面外观判断。

cat /etc/os-release
uname -m
安装格式常见适用环境处理方式需要注意
debDebian、Ubuntu 及使用 apt 的衍生发行版用 apt 安装本地文件由包管理器登记,依赖从已配置的软件源解析。
rpmFedora 及使用 dnf 的发行版用 dnf 安装本地文件使用 rpm 格式不等于所有发行版都使用 dnf。
AppImage符合该文件运行要求的 Linux 桌面添加执行权限后运行仍受 CPU 架构、系统库、FUSE 与挂载选项影响。

例如,x86_64 常对应下载页中的 x64 或 amd64,aarch64 常对应 arm64。它们表示架构命名关系,不表示本站一定提供每一种组合;实际可用文件以全平台下载页为准。不要在架构不匹配时反复添加执行权限。

二、获取文件并记录安装前信息

在下载页选择 Linux,再按发行版选择格式。本文所有获取操作都从本站下载页开始,不需要自行拼接安装包地址。记录下载文件所在目录与完整文件名,后续安装、排错和查询包信息都会用到。

  1. 检查系统

    打开终端,运行上一节两条命令,记录发行版名称及架构。远程终端里的系统不一定是当前桌面所在的系统,应确认操作对象。

  2. 选择格式

    进入全平台下载页的 Linux 区域。使用 apt 的系统选择 deb,使用 dnf 的系统选择 rpm;考虑 AppImage 时先阅读对应运行要求。

  3. 记录路径

    在文件管理器中查看文件属性,复制实际绝对路径。下文终端提示要求输入路径时,不要额外添加引号,也不要用未展开的波浪号代替主目录。

  4. 检查来源

    确认文件由本站下载页取得,并已下载完成。若仍显示浏览器的临时下载后缀,应等待完成后再安装,不要手动去掉后缀强行执行。

三、分别安装 deb、rpm 与 AppImage

下面的命令在 Bash 中执行,每次只运行与你所选格式对应的一组。命令通过交互读取实际文件路径,不预设安装包文件名;变量外的双引号用于保留路径中的空格。安装前先关闭正在运行的 Shadowrocket。

deb:让 apt 处理本地安装与依赖

在 Debian、Ubuntu 等 apt 环境执行以下命令。输入文件的绝对路径后,先阅读 apt 列出的安装、升级或移除计划,再决定是否确认;不要为了跳过依赖报错而直接使用强制安装选项。

read -r -p "请输入 deb 文件的绝对路径: " pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"

dpkg-deb 输出的是包名与包架构,可用于核对所选文件。若 apt 提示找不到依赖,先检查系统软件源是否可用;需要刷新软件包索引时执行 sudo apt update,然后重新尝试。刷新索引不是升级整个系统,也不会自动解决不兼容的发行版要求。

rpm:在 dnf 环境安装本地文件

Fedora 等使用 dnf 的系统可执行下面这一组。先读取包信息,再由 dnf 解析依赖。其他使用 rpm 格式但不使用 dnf 的系统,应采用本发行版的包管理方式,不要为了照抄命令额外更换包管理器。

read -r -p "请输入 rpm 文件的绝对路径: " pkg
rpm -qp --queryformat '%{NAME} %{ARCH}\n' "$pkg"
sudo dnf install "$pkg"

如果出现 nothing provides,应查看紧随其后的依赖名称,并核对系统支持条件与已启用仓库。不要使用忽略依赖的参数把安装状态强行改为成功;包被登记并不等于程序具备运行所需的库。

AppImage:添加执行权限后直接运行

把文件放到普通用户可访问、不会随意清理的位置,再执行以下命令。AppImage 不通过 apt 或 dnf 登记,因此不会因为首次运行就自动获得包管理器提供的更新与卸载入口。

read -r -p "请输入 AppImage 文件的绝对路径: " pkg
chmod u+x "$pkg"
"$pkg"

四、首次打开后,分开检查配置与连接

能够打开窗口只说明应用已经启动,不代表订阅、服务端和分流策略都已配置。首次检查以 Home、Config、Settings 的职责为顺序:Home 查看连接与服务器,Config 确认使用的配置,Settings 检查相关设置。涉及系统网络授权时,先核对提示内容再确认。

应用内检查

Home
检查已导入的服务器与当前选择。
Config
确认启用的配置文件及 Rule 段。
Global Routing
确认当前使用 Config、Proxy 还是 Direct。
Connectivity Test
检查所选服务器连接,再验证实际请求。

每次只改变一个设置,保留修改前的状态,便于判断结果。

系统侧检查

CPU 架构
将 uname -m 的输出与下载页标注对应。
系统时间
检查时区与日期;明显错误可能影响 TLS 验证。
网络环境
先确认普通网络及需要登录的网络认证页可用。
服务端端口
按服务商资料填写,不把所有协议都默认设为 443。

系统可联网与代理连接可用是两项检查,不能相互替代。

已有订阅时,在 Home 右上角「+」进入添加界面,Type 选择 Subscribe,填写从你的服务商处获取的订阅链接并保存。随后执行订阅更新,确认 Home 出现服务器条目。订阅更新通常用于刷新服务器资料,不应直接视为已替换 Config 中的全部分流规则。

手动添加时,Shadowsocks、VMess、VLESS、Trojan、Hysteria2 与 WireGuard 的字段不能混用。按服务商给出的协议、地址、端口和认证参数逐项填写;不要把订阅链接直接当成某一种协议的服务器地址。分享排错信息前,隐藏订阅令牌、密码与 Private Key。

五、用 Global Routing 区分安装与分流问题

安装完成后若遇到部分网站能访问、部分不能访问,先检查 Global Routing,而不是立即重装。下面比较的是 Shadowrocket 自身的处理姿态;作用范围仍取决于实际进入客户端处理的流量,不应把 Proxy 理解为任何系统进程都必然被接管。

Config

推荐

按当前配置处理请求。检查 Rule 段的顺序与策略,确认目标域名最终命中哪条规则;适合作为规则配置正确后的日常状态。

适合:按域名与地址进行日常分流。

Proxy

将进入客户端处理的请求按代理姿态处理,可用于暂时排除部分分流规则的影响。如果切换后现象改变,应继续检查配置,而不是据此认定系统安装损坏。

适合:短时间排查规则与策略选择。

Direct

按直连姿态处理请求,不使用代理服务器转发。可用于观察原始网络状态;需要代理的目标在此姿态下失败,不能用来证明服务器不可用。

适合:核对直连网络与代理连接的差别。

在 Config 中,DOMAIN-SUFFIX 用于域名后缀匹配,IP-CIDR 用于地址网段匹配,GEOIP 按地址归属匹配,FINAL 负责最终兜底。规则通常自上而下判断;目标已经被较早的规则匹配时,修改后面的规则不会改变该次匹配结果。修改前备份当前配置,并在验证后恢复临时诊断设置。

六、首次启动常见报错与处理顺序

排错时保留完整报错文字和触发步骤,不只记录“打不开”。下列现象是 Linux 安装与运行中的常见分类,并非所有发行版都会出现。先处理文件执行与依赖问题,再处理应用配置,最后验证具体请求。

AppImage 提示 Permission denied,已经下载完了怎么办?

先对实际文件执行 chmod u+x "$pkg",再从同一个终端运行。若仍失败,执行 findmnt -T "$pkg" -o TARGET,OPTIONS 检查所在文件系统是否有 noexec。存在该选项时,可移到允许执行的用户目录;不要直接修改系统挂载策略。

出现 Exec format error,是权限不够吗?

这通常需要先检查文件格式或架构,而不是增加权限。对比 uname -m、下载页架构标注和 file "$pkg" 的输出。若 file 显示 HTML 文档,说明取得的可能是错误页面,应回下载页重新获取正确文件。

AppImage 提示缺少 libfuse.so.2,该装什么?

先记录完整报错,再通过当前发行版的软件包搜索工具查找提供该文件的 FUSE 兼容运行库。不同发行版及发行版代际的包名可能不同,不要直接删除现有 FUSE 组件。安装匹配依赖后,再以普通用户从终端启动。

点击图标没有窗口,怎样看到原因?

AppImage 可用前面的路径变量在终端直接运行;deb 或 rpm 可先在桌面启动器属性中查看实际启动命令,再在终端执行。记录缺失库、图形会话或权限相关输出,不要猜测可执行文件名称,也不要随意关闭安全机制。

已经安装成功,为什么订阅更新仍然失败?

先确认普通网络可用、系统时间正确、订阅链接没有复制进空格或换行,再核对服务商侧的有效状态。只有某个订阅失败时,应优先检查该链接及网络路径;重新安装应用通常不会修复失效的令牌。

七、更新与移除时保留哪些信息

后续更新仍从本站下载页获取相同架构、合适格式的文件。deb 与 rpm 一般由对应包管理器依据包元数据处理升级;AppImage 则在关闭应用后替换为新文件,并重新核对执行权限和快捷方式路径。不要假设把文件放进下载目录就会自动生效。

选择格式的核心是让应用符合当前系统的管理方式:apt 环境优先使用对应的 deb,dnf 环境使用对应的 rpm;选择 AppImage 时承担文件位置、权限与运行依赖的检查。安装完成后,再按已有服务商资料完成订阅和连接配置。

下载 Shadowrocket