本文说明 Shadowrocket Linux 版的安装包选择、CPU 架构核对、本地安装命令与首次运行检查。deb 和 rpm 交给对应的系统包管理器处理;AppImage 需要执行权限及兼容的运行环境。以下以用户已有自己的服务商与订阅为前提,先完成程序安装,再单独检查配置与网络连接。
一、先核对发行版,再选择安装包
选择安装包时,先看发行版的包管理体系,再看 CPU 架构。桌面外观不能作为判断依据:同样使用 GNOME 或 KDE 的系统,底层可能分别采用 deb 或 rpm。打开终端,执行以下命令,读取当前系统信息。
cat /etc/os-release
uname -m
/etc/os-release 中的 ID 标识当前发行版,ID_LIKE 可辅助判断所属体系;uname -m 输出机器架构。常见的 x86_64 对应 x86 的 64 位架构,下载页有时标为 amd64;aarch64 对应 ARM 的 64 位架构,下载页有时标为 arm64。具体可用架构以下载页实际列出的文件为准,不要仅凭扩展名选择。
| 系统环境 | 选择格式 | 安装或运行方式 | 先检查什么 |
|---|---|---|---|
| Debian、Ubuntu 及相应衍生发行版 | deb | 使用 apt 安装本地文件 | 包架构与依赖是否匹配 |
| Fedora 等使用 dnf 的发行版 | rpm | 使用 dnf 安装本地文件 | 发行版兼容性与依赖来源 |
| 其他兼容的 Linux 桌面环境 | AppImage | 授予执行权限后运行 | CPU 架构、运行库与挂载条件 |
rpm 并不等于所有使用 rpm 格式的系统都能运行同一个文件。例如,使用其他包管理前端的发行版不能直接照抄 dnf 命令。AppImage 也不是完全脱离系统环境的容器;如果底层运行库不满足要求,添加执行权限后仍可能无法启动。
二、从下载页获取文件并记录路径
进入全平台下载页,找到 Linux 安装包,根据前一节的结果选择格式与架构。本文不固定安装包文件名,也不把文件名中的数字当作兼容性依据。后续命令通过交互方式读取你实际下载的文件路径。
-
确认系统
运行
cat /etc/os-release与uname -m,记录发行版和 CPU 架构,不用桌面主题判断系统类型。 -
选择文件
打开全平台下载页的 Linux 区域,选择匹配的 deb、rpm 或 AppImage;确认浏览器已完成下载后再操作。
-
复制路径
在文件管理器的属性中查看文件位置,取得包含文件名的完整绝对路径。输入下文提示时不要额外添加引号。
-
按格式执行
在 Bash 终端中执行对应小节的命令。遇到错误先阅读终端输出,不要连续改用多种格式覆盖安装。
三、Debian 与 Ubuntu:用 apt 安装 deb
对于匹配当前系统的 deb,优先让 apt 处理本地安装。与单纯解包相比,apt 会检查依赖关系,并尝试从当前已配置的软件源取得所需依赖。安装过程中可能需要访问发行版软件源;本地已有安装包不代表整个过程可以离线完成。
read -r -p "请输入 deb 文件的绝对路径:" pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
第一条检查命令读取包内的名称与架构,不安装程序。确认输出与预期一致后,再执行安装。这里使用绝对路径,是为了让 apt 将输入识别为本地文件;如果使用相对路径,则应写成带 ./ 的路径,而不是只写文件名。
- 看到依赖下载失败时,检查网络、软件源地址与索引状态;有需要时运行
sudo apt update后再重试。 - 看到架构不匹配时,重新核对下载页与
uname -m,不要通过强制选项绕过检查。 - 看到依赖没有可安装候选项时,检查当前发行版是否满足包的要求,不要混用其他发行版的软件源。
- 安装成功后从应用菜单启动 Shadowrocket;不要为了启动图形界面而再次使用 sudo。
后续用新的本地 deb 更新时,仍可使用 apt 安装新文件,由包管理器判断升级关系。仅安装一个本地 deb 不代表系统已经配置应用更新源;是否存在更新源,应查看实际的软件源配置,不能从安装成功这一结果推断。
四、Fedora:用 dnf 安装 rpm
在使用 dnf 的系统上,先读取 rpm 的包信息,再安装。dnf 会将本地包与系统已安装内容、启用的软件仓库一起计算依赖关系。扩展名相同但面向不同发行版构建的 rpm,仍可能有不同的运行库要求。
read -r -p "请输入 rpm 文件的绝对路径:" pkg
rpm -qp --queryformat '%{NAME}\n%{ARCH}\n' "$pkg"
sudo dnf install "$pkg"
安装事务开始前,阅读 dnf 列出的新增、升级和移除项目。如果输出包含意料之外的大量系统组件替换,先取消事务,回到下载页核对文件与发行版要求。不要为了完成一次应用安装,直接接受无法解释的系统级变更。
deb 安装核对
- 系统信息
cat /etc/os-release- 包内信息
dpkg-deb -f "$pkg" Package Architecture- 本地安装
sudo apt install "$pkg"
apt 负责处理安装事务与依赖,输入文件必须适用于当前系统。
rpm 安装核对
- 机器架构
uname -m- 包内信息
rpm -qpi "$pkg"- 本地安装
sudo dnf install "$pkg"
此处命令用于 dnf 环境,不能把 rpm 格式视为跨发行版兼容保证。
五、AppImage:赋予执行权限后运行
AppImage 的常见运行流程不经过 apt 或 dnf 安装:将文件放在当前用户可读取的位置,授予执行权限,再直接启动。建议先固定保存位置,避免程序运行后又移动或删除原文件。以下命令只修改当前选中文件,不递归修改目录权限。
read -r -p "请输入 AppImage 文件的绝对路径:" pkg
chmod +x "$pkg"
"$pkg"
如果双击没有可见结果,先在终端执行最后一行,保留错误文本。提示 Permission denied 时,既可能是文件没有执行权限,也可能是文件所在分区带有 noexec 挂载选项;反复执行 chmod 不能改变分区的挂载限制。
- 执行
ls -l "$pkg"查看权限,确认当前用户拥有相应的读取与执行权限。 - 提示
Exec format error时,优先核对 CPU 架构及文件是否下载完整,不要把它当作订阅连接错误。 - 提示 FUSE 相关错误时,根据当前发行版文档确认所需兼容组件。不同发行版的包名不同,不要照搬其他系统的安装命令。
- 提示缺少共享库或运行库符号时,记录完整报错并检查系统兼容要求;执行权限本身不能补齐运行环境。
AppImage 文件通常不会像本地 deb 或 rpm 那样自动成为包管理器中的已安装条目,也不能据此假定应用菜单一定生成了入口。更新前先退出正在运行的程序并保留配置,再按下载页说明替换文件;新文件可能需要重新授予执行权限。
六、首次运行:将安装检查与路由检查分开
能够打开 Shadowrocket,只能证明程序已启动,不代表订阅有效或流量已经进入代理。先确认用户已有的服务信息,再检查 Home 中的服务器选择与连接状态。配置文件在 Config 中管理,Global Routing 决定当前采用哪种路由姿态;排查时一次只更改一个变量。
以下对比的是 Shadowrocket 自身的 Global Routing 设置,不是不同安装包的性能差异。deb、rpm 与 AppImage 是分发形式,不应被当成连接速度的分档依据。
Config
推荐按当前配置的规则决定连接去向。规则可以指定代理、直连或其他已定义策略,并非所有未匹配流量都默认直连;最终结果还取决于兜底规则。
适合:已有可用配置,需要按域名或 IP 规则分流。
Proxy
将进入客户端处理范围的连接交给当前代理策略。它可用于暂时排除分流规则的影响,但不会自动修复错误的服务器参数,也不能保证未被接管的流量经过代理。
适合:短时检查代理连接与规则匹配是否属于同一故障。
Direct
让进入客户端处理范围的连接采用直连。Direct 下网页能够打开,不足以证明代理服务器可用;测试代理能力前需要核对当前路由姿态。
适合:对照检查原始网络是否可访问目标。
例如,下面两行表示 example.com 及其子域名直连,其余连接由 FINAL 交给 PROXY。这里的 PROXY 必须对应当前配置可用的策略;片段仅用于解释规则顺序,不是一份可直接替代现有配置的完整文件。
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXY
如果 Home 中的 Connectivity Test 有结果,但浏览器访问仍不符合预期,继续检查浏览器是否使用单独的代理设置、系统代理是否指向实际监听地址,以及 Global Routing 是否符合当前测试目的。不要直接套用网上常见端口号;本机监听端口必须以实际设置为准。
七、安装与启动常见问题
apt 提示找不到文件,是包坏了吗?
先核对输入的是完整本地路径。使用 ls -l "$pkg" 确认文件存在,且不是浏览器的下载临时文件。相对路径应带 ./,绝对路径应以 / 开头;文件路径不是软件仓库中的包名。
AppImage 已经 chmod,为什么还打不开?
在终端运行该文件并读取报错。先分辨执行权限、noexec 挂载、架构、FUSE 或运行库问题,再处理对应环节。不要用 chmod 777 扩大文件权限,也不要将全部启动错误都归因于网络。
装好 deb 后,还要再装 AppImage 吗?
完成安装并能正常运行后,不需要为了导入订阅再安装另一种格式。多份程序并存会增加启动入口与配置位置的辨认成本。切换格式前,先退出程序、备份配置,并记录原来的安装方式。
程序打开了,订阅更新失败该重装吗?
先核对已有订阅地址、有效状态与当前网络,再检查访问该地址所需的路由条件。订阅属于配置数据,重装程序不改变服务端地址与授权状态。排查时不要公开完整订阅链接,其中可能包含访问令牌。
需要记录问题时,保留发行版名称、uname -m 输出、安装格式、执行命令及完整错误文本。这些信息能区分安装事务失败、运行环境不满足与连接配置错误。分享记录前,去除订阅令牌、服务器密码和其他访问凭据。
下载 Shadowrocket 与继续配置
iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准;Mac(Apple 芯片与 Intel)、Windows、安卓、Linux 版免费。到下载页选择系统对应文件,安装后按教程导入已有订阅并检查路由设置。