本文适用于准备在 Linux 桌面安装 Shadowrocket(小火箭)、且已有自己服务商与订阅的用户。先确认发行版和 CPU 架构,再选择 deb、rpm 或 AppImage;完成安装后,分别验证应用启动、订阅导入和请求连接,避免把安装问题与配置问题混在一起。
一、先确认发行版、架构与安装包格式
deb、rpm 与 AppImage 是不同的 Linux 软件分发形式,不是不同的代理协议。选择时先看发行版使用的包管理器,再核对下载页列出的架构与运行要求。把文件后缀从 .rpm 改成 .deb 不会转换包格式,也不能解决架构不匹配。
打开终端执行以下命令。/etc/os-release 用于辨认发行版,uname -m 用于确认架构;两项信息应分别核对,不能仅凭桌面外观判断。
cat /etc/os-release
uname -m
| 安装格式 | 常见适用环境 | 处理方式 | 需要注意 |
|---|---|---|---|
| deb | Debian、Ubuntu 及使用 apt 的衍生发行版 | 用 apt 安装本地文件 | 由包管理器登记,依赖从已配置的软件源解析。 |
| rpm | Fedora 及使用 dnf 的发行版 | 用 dnf 安装本地文件 | 使用 rpm 格式不等于所有发行版都使用 dnf。 |
| AppImage | 符合该文件运行要求的 Linux 桌面 | 添加执行权限后运行 | 仍受 CPU 架构、系统库、FUSE 与挂载选项影响。 |
例如,x86_64 常对应下载页中的 x64 或 amd64,aarch64 常对应 arm64。它们表示架构命名关系,不表示本站一定提供每一种组合;实际可用文件以全平台下载页为准。不要在架构不匹配时反复添加执行权限。
二、获取文件并记录安装前信息
在下载页选择 Linux,再按发行版选择格式。本文所有获取操作都从本站下载页开始,不需要自行拼接安装包地址。记录下载文件所在目录与完整文件名,后续安装、排错和查询包信息都会用到。
-
检查系统
打开终端,运行上一节两条命令,记录发行版名称及架构。远程终端里的系统不一定是当前桌面所在的系统,应确认操作对象。
-
选择格式
进入全平台下载页的 Linux 区域。使用 apt 的系统选择 deb,使用 dnf 的系统选择 rpm;考虑 AppImage 时先阅读对应运行要求。
-
记录路径
在文件管理器中查看文件属性,复制实际绝对路径。下文终端提示要求输入路径时,不要额外添加引号,也不要用未展开的波浪号代替主目录。
-
检查来源
确认文件由本站下载页取得,并已下载完成。若仍显示浏览器的临时下载后缀,应等待完成后再安装,不要手动去掉后缀强行执行。
三、分别安装 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"
chmod u+x只为文件所有者增加执行权限,不需要给所有用户开放写权限。- 日常启动使用普通用户。不要因为窗口没有出现,就把整个图形应用改为使用
sudo运行。 - 执行成功后保留该文件;若自行创建桌面快捷方式,其目标必须指向实际存放路径。
- AppImage 可以集中携带应用文件,但不能据此推断所有数据也写在同一目录,或所有系统依赖都已包含。
四、首次打开后,分开检查配置与连接
能够打开窗口只说明应用已经启动,不代表订阅、服务端和分流策略都已配置。首次检查以 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 则在关闭应用后替换为新文件,并重新核对执行权限和快捷方式路径。不要假设把文件放进下载目录就会自动生效。
- 更新前备份自己编辑过的 Config 文件,并记录当前启用的配置及 Global Routing 状态。
- 保留服务商提供的原始配置资料;备份中的订阅链接、密码与密钥应按敏感信息保存。
- 移除 deb 或 rpm 时,先查询实际包名,再使用 apt 或 dnf 的移除命令,阅读确认列表后执行。
- 移除 AppImage 文件不等于清除用户配置。需要清理数据时先确认实际存储位置,不要按猜测路径批量删除目录。
- 更新后按“启动应用 → 检查 Home → 确认 Config → 测试请求”的顺序复查,便于定位变化发生在哪一层。
选择格式的核心是让应用符合当前系统的管理方式:apt 环境优先使用对应的 deb,dnf 环境使用对应的 rpm;选择 AppImage 时承担文件位置、权限与运行依赖的检查。安装完成后,再按已有服务商资料完成订阅和连接配置。