Shadowrocket Linux 版安装:deb、rpm、AppImage 怎么选,apt / dnf 与 chmod +x 步骤

按发行版选择安装包格式:Debian/Ubuntu 用 apt 安装 deb,Fedora 用 dnf 安装 rpm,其他发行版给 AppImage 加执行权限后直接运行。

本文速览

Debian、Ubuntu 和 Fedora 优先使用各自的原生包;没有适用原生包时,再核对 AppImage 的运行条件。本文适合首次在 Linux 桌面安装 Shadowrocket 的用户,涵盖系统和架构识别、本地包安装、AppImage 启动,以及依赖缺失和权限错误的排查方法。

先确认发行版和 CPU 架构

在准备运行 Shadowrocket 的 Linux 桌面上打开终端,执行下面两条命令。第一条显示发行版标识和发行版版本;第二条显示当前内核报告的机器架构。若是在虚拟机里使用客户端,就在虚拟机内部查询,不要用宿主机的信息选包。

grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
  1. 确认系统

    ID=debian 或 ID=ubuntu 对应 deb,ID=fedora 对应 rpm。衍生发行版可以参考 ID_LIKE,但它只说明发行版的关系,不保证某个安装包的依赖都能满足;下载前还要看页面标注的适用系统。

  2. 核对架构

    x86_64 与 deb 常用的 amd64 指同一类架构,aarch64 与常见的 arm64 也如此。Debian 或 Ubuntu 还可运行 dpkg --print-architecture 核对包管理器使用的架构名称。没有匹配构建时,不要靠改后缀或强制安装来处理。

  3. 获取文件

    打开客户端下载页,在 Linux 区选择适用格式和架构。下载完成后,在桌面文件管理器中打开浏览器实际使用的保存目录,核对完整文件名,尤其要区分扩展名与浏览器可能添加的重名编号。

  4. 进入目录

    在文件管理器中使用当前目录的终端入口(若桌面环境提供),也可以在终端用 cd 切换到实际保存目录。执行 pwd 和 ls -l 确认位置与文件。下文用 local.deb、local.rpm 和 local.AppImage 作为示例文件名,运行前换成下载所得的完整名称;有空格时保留引号。

Debian 和 Ubuntu:用 apt 安装 deb

在安装包所在目录运行以下命令。./ 告诉 apt 要处理当前目录中的文件,而不是在软件源里搜索一个同名的软件包。apt 会读取本地包的依赖,并尝试从已配置的软件源补齐缺失项。

dpkg-deb -f "./local.deb" Package Architecture Depends
sudo apt install "./local.deb"

第一条只读取包信息,可用来核对包名、架构和依赖;第二条才安装。确认前查看终端列出的新增、升级和移除项目。如果出现大批无关软件包将被移除,先取消此次操作,重新核对发行版兼容性和软件源配置。

Fedora:用 dnf 安装 rpm

在 Fedora 上用 dnf 安装本地 rpm。它会解析安装事务,并尝试从已启用的仓库取得依赖。下面的 rpm -qp 只查询文件中的元数据,不会把软件装进系统。

rpm -qp --queryformat '%{NAME} %{ARCH}\n' "./local.rpm"
sudo dnf install "./local.rpm"

两种原生包都由各自的包管理器登记。需要确认是否装好或计划卸载时,用前面查询得到的包名,而不是下载文件名。

deb 安装记录

包信息
dpkg-deb -f "./local.deb" Package Architecture
查询已安装状态
dpkg-query -s 实际包名
卸载命令
sudo apt remove 实际包名

把命令中的「实际包名」换成 Package 字段的值。

rpm 安装记录

包信息
rpm -qpi "./local.rpm"
查询已安装状态
rpm -q 实际包名
卸载命令
sudo dnf remove 实际包名

把命令中的「实际包名」换成 rpm -qp 查询到的 NAME。

如果 dnf 报告某个依赖无法满足,先读清报错中缺的是哪个包或库,再用 dnf repolist --enabled 核对仓库是否启用。若提示冲突,不要用强制忽略依赖的方式安装;安装事务未完成与应用安装成功但打不开,是两个不同的问题。

AppImage:赋予执行权限后启动

没有适用的 deb 或 rpm 时,可在确认架构和运行条件匹配后尝试 AppImage。建议把文件放在当前用户可写且允许执行程序的位置,并保留在固定目录中。下面用 u+x 将执行权限只加给文件所有者,是 chmod +x 的限定写法;用普通桌面用户执行这两条命令。

chmod u+x "./local.AppImage"
"./local.AppImage"

AppImage 可直接从终端运行,不会因设置了执行权限就登记为系统软件包,也不一定自动出现在应用菜单中。下面比较的是 Shadowrocket 的两种部署设置;推荐项以下载页有适用的原生包为前提。

由包管理器登记

推荐

通过 apt 或 dnf 安装,之后可以按包名查询状态或卸载。本地安装过的包若没有对应的软件源更新,仍需下载新版文件并再次用同一包管理器安装。

适合:有适用 deb 或 rpm,希望用系统工具管理安装记录

以用户身份独立运行

从文件所在位置直接启动 AppImage。换包前先退出正在运行的应用,再为新文件设置执行权限;若自行建立了启动快捷方式,还需保证它指向新文件所在位置。

适合:没有适用的原生包,希望在用户目录保留可执行文件

安装后打不开:按报错定位

先区分故障发生在哪一步:包管理器未完成安装,就处理安装事务中的第一条具体错误;安装状态正常但窗口未出现,就从当前桌面会话复现启动问题。AppImage 可直接在终端启动,方便读取双击时看不到的报错。

已经 chmod 了,怎么还是 Permission denied?

先用 ls -l "./local.AppImage" 确认文件所有者的权限位出现 x,再用 findmnt -T "./local.AppImage" -o TARGET,OPTIONS 查看挂载选项。若显示 noexec,修改文件权限也无法在该位置执行;把文件移到允许执行的用户目录后再试,不必修改系统挂载设置。

终端说找不到 libfuse.so.2,怎么处理?

这表示当前 AppImage 的运行时找不到 FUSE 2 兼容库。先查看发行版的软件仓库中提供的是 libfuse2、libfuse2t64 还是其他对应包,再按本发行版的包名安装兼容库;不要删除系统现有的 FUSE 3 组件。若本机策略不允许使用所需的 FUSE 功能,优先检查是否有匹配的原生包。

出现 Exec format error,是权限不够吗?

通常应先查文件格式和架构,而不是重复执行 chmod。有 file 命令时,运行 file "./local.AppImage" 并与 uname -m 对照。若识别为另一种 CPU 架构,回下载页重新选择;若识别为 HTML 文档,说明保存下来的不是可执行包,应重新完成下载。

包已经装好,为什么应用菜单里找不到?

先在当前登录的桌面会话中搜索 Shadowrocket。仍找不到时,用 dpkg-query -L 实际包名 或 rpm -ql 实际包名 检查包是否提供 .desktop 启动项。若运行环境只是远程终端或没有桌面会话,安装记录正常也不代表能显示图形窗口。AppImage 没有菜单入口时,先使用上一节的终端命令启动。

下载 Shadowrocket