本文适用于带图形桌面的 Linux 设备。先在终端确认发行版和系统架构,再从下载指南选择 Shadowrocket 安装包。deb 和 rpm 由系统包管理器登记,AppImage 则保留为可执行文件。下文分别给出安装命令,以及遇到依赖、权限和首次启动错误时的排查顺序。
安装前:确认发行版和架构
包格式由发行版及其包管理器决定,架构决定包内的程序能否在当前系统上运行。两项都应在准备安装 Shadowrocket 的系统里检查;例如,在虚拟机中安装时,应以虚拟机内的输出为准,而不是看宿主机的设备型号。
-
识别发行版
打开终端,读取
/etc/os-release中的ID和ID_LIKE。ID=debian或ID=ubuntu对应 deb;ID=fedora对应 rpm。衍生版可参考ID_LIKE,但还要核对它实际使用的包管理器和下载页标注的适用范围。 -
确认系统架构
运行
uname -m查看内核架构。x86_64对应 deb 常用的amd64标记;aarch64对应arm64。装 deb 时再运行dpkg --print-architecture,以包管理器报告的系统架构为准。 -
选取安装包
打开Shadowrocket 下载指南,在 Linux 区块核对格式与架构。其他发行版可先检查是否有适配的 AppImage。若页面未提供匹配架构,不要靠改后缀或强行安装来替代。
-
启动并记录
按对应包格式完成下文操作。deb 或 rpm 装好后先从桌面的应用菜单查找 Shadowrocket;AppImage 可直接在终端运行。窗口打开后先确认
Home能正常显示。若窗口未出现,记录终端中的第一条错误,再按后面的问答定位。
grep -E '^(ID|ID_LIKE)=' /etc/os-release
uname -m
Debian / Ubuntu 用 apt,Fedora 用 dnf
两个命令组只执行与你的系统对应的一组。示例在 Bash 中运行:出现提示后,粘贴实际文件的绝对路径并回车,不要在输入内容外加引号。后续命令中的双引号已保留,即使路径含空格也能作为同一个参数传递。先看包信息是否符合预期,再执行安装行。
deb
- 适用发行版
- Debian、Ubuntu
- 安装工具
apt install- 本地包查询
dpkg-deb -f- 卸载工具
apt remove
卸载时使用 Package 字段的值,不用下载文件名。
rpm
- 适用发行版
- Fedora 及使用 dnf 的相应衍生版
- 安装工具
dnf install- 本地包查询
rpm -qpi- 卸载工具
dnf remove
卸载时使用 Name 字段的值,并先阅读事务摘要。
安装 deb
read -r -p '输入 deb 文件的绝对路径: ' pkg
dpkg-deb -f "$pkg" Package Architecture
sudo apt install "$pkg"
apt 会从已配置的仓库解析所需依赖。不带目录的文件名可能被当作仓库中的包名,因此这里传入绝对路径。如果依赖列表来自过期的索引,可先执行 sudo apt update 再重试;若仍报某项依赖无可用候选,不要混用其他发行版的软件源,先核对下载包所要求的系统环境。
安装 rpm
read -r -p '输入 rpm 文件的绝对路径: ' pkg
rpm -qpi "$pkg"
sudo dnf install "$pkg"
rpm -qpi 只读取本地包的信息,不安装软件。dnf 才负责解析当前启用仓库中的依赖并执行安装。若事务摘要要求移除与你本次安装无关的软件,先取消,检查包的适用发行版和仓库配置,不要跳过依赖检查。
AppImage:添加执行权限并从终端启动
AppImage 通常不需要登记到系统包管理器。可以先把文件移动到家目录下长期保留的位置,再给文件所有者添加执行权限。下面同样输入实际文件的绝对路径;运行程序本身不需要 sudo。
read -r -p '输入 AppImage 文件的绝对路径: ' app
file -- "$app"
chmod u+x -- "$app"
"$app"
file显示 HTML 或普通文本:拿到的可能是下载提示页,而非程序文件。回到下载指南重新选择相符的包,修改后缀没有作用。chmod成功仍显示Permission denied:用findmnt -no OPTIONS --target "$app"查看所在文件系统的挂载选项。若包含noexec,将文件移到允许执行的位置,不必更改整块磁盘的挂载策略。- 终端明确提示
libfuse.so.2缺失:查阅当前发行版的仓库说明,找出提供该库的 FUSE 2 兼容包。FUSE 3 已安装不等于存在这个库,也不应为此卸载系统现有的 FUSE 3。
首次打开后:区分安装问题与路由问题
能打开 Home,说明程序已经启动,但不能据此判断连接或规则是否生效。已有配置和连接资料的用户,可在 Config 核对当前文件,再回到 Home 查看 Global Routing。下面两种设置用于区分规则分流与直连对照;模式切换只用于检查应用启动后的行为,不会修复安装依赖。
Config
推荐按当前配置的规则顺序处理请求。用一个已知应命中规则的域名做对照;如果配置末尾有 FINAL,再用一个未命中前序规则的请求检查兜底行为。
适合:已有配置,首次核对规则分流是否符合预期。
Direct
流量走直连,不用这个结果判断规则是否正确。临时切换后,用同一个网络和同一个可直连目标复测;完成对照后恢复原设置。
适合:排查目标在当前网络下是否可以直连。
安装、更新与卸载常见问题
Ubuntu 下载成了 rpm,要转换吗?
不用转换。回到下载指南选择与 dpkg --print-architecture 输出相符的 deb。即使文件后缀能改,包内部的元数据与依赖仍是原来的格式。
双击 AppImage 没反应,怎么知道错在哪?
按上文在终端启动,先看报错是权限问题、缺少运行库,还是 Exec format error。遇到后一种情况,先用 file 和 uname -m 比对文件与系统架构,不要重复执行 chmod。
更新时要先卸载旧包吗?
先退出应用并备份需要保留的配置。相同包名、相同架构的新版 deb 或 rpm 可用原安装命令处理,先看事务摘要是否为升级。本地安装包被包管理器登记,不表示它一定会从系统仓库自动更新。
删掉下载文件就算卸载了吗?
对 deb 或 rpm,删除下载文件不会移除已安装的程序,应通过对应的包管理器卸载。对 AppImage,退出程序后可删除可执行文件,并移除手动创建且仍指向该文件的桌面快捷方式。用户配置和程序文件是两回事,清理配置前先确认是否还要保留。