本文速览

在运行 Linux 桌面的电脑上,先核对发行版和处理器架构。Debian、Ubuntu 优先选适配本系统的 deb,Fedora 优先选适配本系统的 rpm;不需要包管理器登记、且系统满足运行条件时,可选 AppImage。下面分别说明如何安装或启动,以及如何区分依赖错误、执行权限问题和连接问题。

选择安装包:先查发行版,再查架构

在要运行 Shadowrocket 的那台电脑上打开终端。如果使用虚拟机,就在虚拟机内执行,不要拿宿主机的信息选包。第一条命令列出系统名称及发行版标识,第二条命令显示当前系统报告的机器架构。

grep -E '^(PRETTY_NAME|ID|ID_LIKE)=' /etc/os-release
uname -m
系统或需求先看哪种格式安装前核对
Debian、Ubuntudeb包适配当前发行版,且所需依赖能从当前软件源取得
Fedora 等使用 DNF 的发行版rpm包明确适配当前系统;扩展名相同不代表不同发行版之间可以混装
不希望把程序登记到系统包管理器AppImage包的架构匹配,存放位置允许执行,系统满足运行条件

x86_64 在 deb 的架构标注中通常写作 amd64;aarch64 通常对应 arm64。这些是架构名称的对应关系,不代表下载页一定提供每种架构的构建。请选择 Linux 下载分区实际列出、且与你的系统匹配的安装包。若只有另一种架构,不要靠改文件名或强制安装解决。ID_LIKE 只提示发行版家族,不能代替兼容性说明。

安装 deb、rpm 或启动 AppImage

下面的命令以 Bash 为例。先在文件管理器中定位下载完成的文件,再运行相应代码块。终端出现提示时,粘贴以 / 开头的完整文件路径,不必手动加引号。三个格式只选一个,不需要依次执行。

  1. 定位安装包

    打开浏览器的下载列表,从该条记录打开文件所在目录。确认下载已完成,并区分实际安装包和临时下载文件。使用文件管理器提供的复制路径功能,避免漏掉扩展名或误选另一个架构的同名文件。

  2. 用 APT 装 deb

    apt install 接收本地 deb 路径,并尝试从已配置的软件源补齐依赖。确认事务摘要中的新增、升级和移除项目后再继续;若出现与安装目的无关的大量移除,先取消。

    read -r -p '输入 deb 文件的完整路径:' pkg
    sudo apt install -- "$pkg"
  3. 用 DNF 装 rpm

    dnf install 会读取本地 rpm,并在已启用的仓库中解析依赖。不要添加自动确认参数;先检查 DNF 拟执行的事务。若遇到冲突,记录错误中列出的包名,不要改用跳过依赖检查的方式安装。

    read -r -p '输入 rpm 文件的完整路径:' pkg
    sudo dnf install -- "$pkg"
  4. 运行 AppImage

    将文件放在自己拥有且允许执行程序的目录,用普通用户权限添加执行位并启动。AppImage 本身就是启动文件;终端返回错误时,先保留输出,不要用 sudo 重试。

    read -r -p '输入 AppImage 文件的完整路径:' pkg
    chmod +x -- "$pkg" && "$pkg"
  5. 确认窗口打开

    deb 或 rpm 安装成功后,在桌面应用列表中搜索 Shadowrocket;AppImage 从保存位置运行,不一定会自动添加菜单项。窗口能打开,只说明安装或启动这一步已经完成。节点与订阅从你的服务商处获取;网络测试留到配置完成以后。

安装后的启动、更新与移除

安装格式决定后续由谁管理程序文件。排查之前,先弄清当前启动的是包管理器安装的程序,还是单独保存的 AppImage。若两种方式都试过,先关闭正在运行的窗口,再从明确的入口启动,避免误把旧文件的行为当成新包的问题。

deb / rpm

安装记录
由系统包管理器登记
读取包名
对本地文件用 dpkg-deb -f "$pkg" Package 或 rpm -qp --queryformat '%{NAME}\n' "$pkg"
更新方式
本地安装不等于已配置更新仓库;需要手动更新时,使用适配当前系统的新包
移除方式
用 sudo apt remove 或 sudo dnf remove,后接读出的包名,确认事务后执行

移除用包名,不用下载文件名;删掉下载包也不会卸载已经安装的程序。

AppImage

启动入口
已设置执行权限的 AppImage 文件
文件位置
保留在允许执行的个人目录,不要长期放在会被清理的临时目录
更新方式
关闭旧程序,给新文件加执行权限,确认能打开后再清理旧文件
移除方式
关闭程序后移除 AppImage 文件;如果手动建过快捷方式,同时移除旧入口

删除启动文件不等于删除个人配置。换包排错时先保留配置,避免同时改变两个条件。

常见安装报错:按终端提示定位

APT 提示无法处理这个文件,先查什么?

先核对输入的是文件完整路径,不是浏览器里的下载地址。保持 pkg 为刚输入的路径,用 file -- "$pkg" 查看文件类型。若结果显示为 HTML 文档,说明拿到的是网页内容,不是 deb;返回下载页重新获取,改扩展名不能解决。

提示架构不匹配或 Exec format error,怎么办?

重跑 uname -m,核对下载项的架构标注。对 deb 可用 dpkg-deb -f "$pkg" Architecture 查看包头,对 rpm 可用 rpm -qp --queryformat '%{ARCH}\n' "$pkg" 查看。选错架构就换包;如果架构一致,继续检查文件类型以及下载是否完成。

提示依赖缺失,是不是要换软件源?

先记下报错中第一个无法满足的依赖名和约束,确认安装包适配当前发行版。Debian 或 Ubuntu 可先运行 sudo apt update 刷新软件源索引;DNF 可用 dnf repolist --enabled 确认启用的仓库。若当前发行版的正常软件源仍无法满足依赖,不要混入其他发行版的软件源。

AppImage 加过执行权限,为什么还是 Permission denied?

用 ls -l -- "$pkg" 确认文件对当前用户可执行,再用 findmnt -no OPTIONS --target "$pkg" 查看所在文件系统的挂载选项。若出现 noexec,把文件移到允许执行的个人目录,更新路径后再试。不要为单个应用改动整块磁盘的挂载策略。

AppImage 提示缺少 libfuse.so.2,系统已有 FUSE 怎么办?

这条错误指向 FUSE 2 的用户空间库;已安装 FUSE 3 并不表示系统也有 libfuse.so.2。在当前发行版的软件源中查找提供该库的兼容包,确认安装事务不会移除系统已有组件。如果没有适配的兼容包,优先改用下载页列出的、适配当前系统的 deb 或 rpm。

窗口已打开但网页不通:区分路由与安装问题

窗口能正常打开后,不要通过重装来验证网络。先确认使用普通网络连接时,同一个测试网页能否打开,再核对当前客户端中的 Global Routing。以下对照适用于界面提供这些选项的情况;切换时保持测试网页和其他设置不变。

Config

推荐

按当前配置的规则选择策略。测试时选一个已知会匹配代理规则的地址,再选一个预期直连的地址。仅凭直连地址能打开,不能判断代理线路是否可用。

适合:配置完成后分别验证代理和直连规则。

Direct

让客户端处理的流量直接连接,不经过代理线路。若同一地址在 Direct 下能打开、在 Config 下失败,下一步应检查匹配规则和所选策略,而不是更换安装包格式。测试结束后恢复原路由选项。

适合:为同一测试地址建立直连对照。