本文适合已经准备在 Linux 桌面使用 Shadowrocket 的用户。先核对发行版与处理器架构,再从本站下载页选择 deb、rpm 或 AppImage,按实际文件路径安装;最后区分程序启动、订阅导入和流量接管三个检查阶段。命令不依赖固定安装包文件名,也不预设本机代理端口。
一、先确认发行版、架构与安装格式
deb、rpm 与 AppImage 是程序的分发形式,不是三种代理协议。选择格式时先看系统的包管理工具,再看下载页列出的架构。Debian、Ubuntu 通常选择 deb,Fedora 选择 rpm;其他发行版可以检查 AppImage 是否满足本机运行条件。某个系统能够解压文件,不代表它适合安装另一套包管理体系的软件包。
在终端运行下面两条命令。第一条查看发行版标识,第二条查看机器架构。不要仅根据桌面外观判断系统:使用相同桌面环境的两台电脑,底层发行版和软件包格式仍可能不同。
cat /etc/os-release
uname -m
系统信息
- NAME / ID
- 在 /etc/os-release 中确认发行版。
- ID_LIKE
- 作为发行版家族的辅助信息,不能代替兼容性说明。
- uname -m
- x86_64 与 aarch64 对应不同处理器架构。
格式与架构都要匹配,不能只核对文件扩展名。
获取与运行
- deb
- 交给 apt 安装本地文件并处理依赖。
- rpm
- 在 Fedora 上交给 dnf 安装本地文件。
- AppImage
- 赋予执行权限后,以当前桌面用户运行。
以下载页实际提供的格式和架构为准,不转换安装包格式。
所有安装文件均从下载指南的 Linux 分区获取,安装包由本站 /dl/ 下载机制提供。不要根据本文命令拼接下载地址。Shadowrocket 为闭源商业应用;iPhone / iPad 从 App Store 获取,$2.99 一次性付费,Mac(Apple 芯片与 Intel)、Windows、安卓和 Linux 版免费。
二、Debian / Ubuntu:用 apt 安装本地 deb
下面命令在 Bash 中执行。第一行交互式读取你已下载文件的完整路径,输入时不要额外加引号;后续双引号会保护路径中的空格。先查看软件包元数据,再进行安装。这里读取的是本地文件,不会替你搜索同名软件。
read -r -e -p "输入已下载 deb 文件的完整路径: " pkg
pkg="$(realpath -- "$pkg")"
dpkg-deb --field "$pkg" Package Architecture Depends
dpkg --print-architecture
sudo apt install "$pkg"
Package是软件包内部名称,可能与文件名不同。后续查询、卸载应使用该字段,而不是直接照抄下载文件名。Architecture需要与系统兼容。常见的amd64对应 x86_64,arm64对应 aarch64;命名不同不等于架构不同。Depends列出依赖条件。apt 会尝试从已配置的软件源解析依赖,执行前检查确认清单,尤其留意是否计划删除其他软件。
使用完整路径的原因是让 apt 明确处理本地文件。只写一个不带路径的软件名,含义会变成从软件源查找软件包。相比只执行 dpkg -i,使用 apt 安装本地 deb 更便于在同一事务中处理依赖,但仍要求本机软件源可访问且能够满足依赖条件。
若出现
Unable to locate package,先核对传入的是否为真实文件路径;若出现依赖无法满足,检查发行版兼容性与软件源状态。不要通过强制忽略依赖来跳过错误,也不要把安装事务未完成当成安装成功。
三、Fedora:用 dnf 安装本地 rpm
rpm 包同样先检查架构与包信息。以下操作面向 Fedora 的 dnf 环境;其他使用 rpm 的发行版可能有不同的包管理命令和依赖集合,不能仅凭扩展名相同就认定兼容。
read -r -e -p "输入已下载 rpm 文件的完整路径: " pkg
pkg="$(realpath -- "$pkg")"
rpm -qpi "$pkg"
rpm -qp --requires "$pkg"
uname -m
sudo dnf install "$pkg"
rpm -qpi 查询尚未安装的包文件信息,rpm -qp --requires 列出它需要的能力或依赖。由 dnf 完成安装时,应阅读事务摘要,再确认执行。下载本地包不代表所有依赖已经下载;依赖解析仍可能需要访问本机配置的软件源。
- 提示架构不兼容:回到下载页重新核对架构,不用强制安装参数绕过。
- 提示缺少依赖:记录完整依赖名称,检查软件源和系统支持情况,不从不明来源单独补装动态库。
- 事务已经完成但启动器未出现:先关闭并重新打开桌面应用列表,再检查软件包是否确实安装,区分桌面索引问题与安装失败。
四、AppImage:授权执行不等于系统安装
AppImage 通常保留为一个可执行文件,不通过 apt 或 dnf 登记为普通软件包。应先把文件放到准备长期保留的位置,再添加执行权限。若直接从临时下载目录启动,之后清理该目录会使原来的启动路径失效。
read -r -e -p "输入已下载 AppImage 文件的完整路径: " app
app="$(realpath -- "$app")"
file -- "$app"
chmod u+x -- "$app"
"$app"
chmod u+x 只给文件所有者增加执行权限;最后一行以当前用户启动程序,并在当前终端显示诊断输出。运行桌面程序时不要顺手加上 sudo。安装依赖所需的管理员权限,与应用日常运行身份是两件事。
- 若出现
Permission denied,先用ls -l检查执行位,再检查文件所在分区是否以noexec挂载。执行位不能覆盖挂载限制。 - 若错误中出现 FUSE 或
libfuse.so.2,说明当前 AppImage 的挂载运行条件未满足。按本机发行版的软件包说明安装对应运行依赖,不同发行版的包名可能不同。 - 若出现
Exec format error,优先检查下载架构是否正确;若文件识别结果不是预期的可执行文件,再重新获取安装文件。 - 若窗口没有出现,保留终端原始输出。AppImage 不是通用兼容层,图形会话、系统库和安全策略仍可能影响启动。
不要把关闭安全机制作为通用修复方式,也不要假定 AppImage 必然自动创建桌面图标或加入开机启动。是否存在这些集成,应以实际界面和安装结果为准。
五、首次打开:把安装、订阅与连接分开检查
出现窗口只能说明程序已经启动,不能证明订阅可用或应用流量已经进入代理。以下步骤以用户已有自己的服务商与订阅为前提。本站不提供、不销售、不推荐节点或订阅;客户端安装与线路服务是两个独立环节。
-
检查启动
从桌面启动器打开 Shadowrocket;若使用 AppImage,先从终端运行。确认能够进入 Home,再处理连接设置,避免把程序退出与网络超时混为一谈。
-
导入订阅
在 Home 右上角「+」中将 Type 设为 Subscribe,填入自己已有的订阅链接并保存。示例
https://example.com/sub?token=xxxx是假值,不能用于实际连接。 -
核对配置
在 Home 确认更新后出现条目;在 Config 确认当前使用的配置,再检查 Global Routing。导入节点列表与启用规则配置不是同一个操作。
-
验证流量
打开连接后,用同一应用访问同一地址进行对照,记录是否超时、是否出现解析错误。若只有浏览器可用而终端工具不可用,继续检查各程序的代理设置与环境变量。
Linux 桌面应用对系统代理的遵循方式并不一致。配置 HTTP 或 SOCKS 代理时,必须读取本机实际监听地址与端口,不要照搬网上的固定数字。只有在应用明确提供并启用相应流量接管方式时,才按该方式排查;不能把“连接开关已开”解释成所有进程的流量都会被接管。
六、Global Routing:用姿态区分规则与连接问题
安装包格式不会改变 Global Routing 的含义。排查时固定测试目标和使用的连接条目,每次只调整一个设置。以下对比针对进入 Shadowrocket 处理路径的流量,不意味着能自动覆盖系统中所有程序。
Config
推荐按当前配置中的规则决定策略。检查 DOMAIN-SUFFIX、IP-CIDR、GEOIP 等规则的先后顺序,并确认 FINAL 的兜底策略;Config 不等于所有未命中流量必然直连。
适合:已有规则配置的日常使用。
Proxy
将进入处理路径的流量交给所选代理策略,而不是按 Config 中的域名或地址规则分流。若它与 Config 的结果不同,应继续检查规则命中与策略选择。
适合:临时区分代理连接问题与规则问题。
Direct
让进入处理路径的流量使用直连策略。它不会替你关闭其他程序单独配置的代理,也不能证明当前网络一定能够访问测试目标。
适合:对照直连状态,检查目标本身是否可达。
配置含 DOMAIN-SUFFIX,example.com,DIRECT 时,应使用对应域名测试;换成直接访问 IP 地址,可能不会命中该域名规则。若使用 Scene,则按所配置的场景条件与对应策略检查,不将其当作固定的全局代理姿态。诊断完成后恢复原来的日常设置,避免临时测试影响后续判断。
七、更新、卸载与常见安装问题
deb 与 rpm 交由包管理器记录安装状态,但手动安装本地文件,不代表已经添加能够自动更新 Shadowrocket 的软件源。更新时回到本站下载页获取适配当前系统的包,再由同一包管理器处理。AppImage 的更新通常需要替换所运行的文件,同时检查旧桌面快捷方式是否还指向旧路径。
装了 deb,为什么没有自动更新?
先确认系统是否配置了对应更新来源。本地 deb 安装本身不能证明存在更新源;需要手动更新时,从下载页重新获取文件,用 sudo apt install 加实际完整路径安装,并阅读事务摘要。
卸载时该输入哪个软件包名称?
deb 用 dpkg-deb --field "$pkg" Package 查看名称,rpm 用 rpm -qp --queryformat '%{NAME}\n' "$pkg" 查看名称。将输出的真实名称交给 apt remove 或 dnf remove,不根据文件名猜测。
删除 AppImage 后,设置也会消失吗?
不一定。程序文件与用户配置通常分开存放,删除 AppImage 不等于删除配置。需要清理时先使用应用提供的配置管理功能,并备份自己的配置;不要按猜测路径批量删除用户目录。
程序能打开,订阅却一直为空?
先确认在 Home 中保存的是 Subscribe 类型,检查链接是否完整、是否带有意外空格,以及更新是否返回错误。向已有服务商核实链接状态时,避免在公开截图中暴露 token;更换 deb 或 rpm 不能修复失效的订阅链接。
提交问题记录时,保留发行版名称、uname -m 输出、所用格式、失败阶段和终端原始报错即可。订阅地址、密码、PrivateKey 等属于敏感信息,应在发送日志前移除。能够定位到“包管理器安装失败”“AppImage 启动失败”或“启动后连接失败”,比只描述“Linux 不能用”更便于继续排查。