Debian、Ubuntu 和 Fedora 优先使用各自的原生包;没有适用原生包时,再核对 AppImage 的运行条件。本文适合首次在 Linux 桌面安装 Shadowrocket 的用户,涵盖系统和架构识别、本地包安装、AppImage 启动,以及依赖缺失和权限错误的排查方法。
先确认发行版和 CPU 架构
在准备运行 Shadowrocket 的 Linux 桌面上打开终端,执行下面两条命令。第一条显示发行版标识和发行版版本;第二条显示当前内核报告的机器架构。若是在虚拟机里使用客户端,就在虚拟机内部查询,不要用宿主机的信息选包。
grep -E '^(ID|ID_LIKE|VERSION_ID)=' /etc/os-release
uname -m
确认系统
ID=debian或ID=ubuntu对应 deb,ID=fedora对应 rpm。衍生发行版可以参考ID_LIKE,但它只说明发行版的关系,不保证某个安装包的依赖都能满足;下载前还要看页面标注的适用系统。核对架构
x86_64与 deb 常用的amd64指同一类架构,aarch64与常见的arm64也如此。Debian 或 Ubuntu 还可运行dpkg --print-architecture核对包管理器使用的架构名称。没有匹配构建时,不要靠改后缀或强制安装来处理。获取文件
打开客户端下载页,在 Linux 区选择适用格式和架构。下载完成后,在桌面文件管理器中打开浏览器实际使用的保存目录,核对完整文件名,尤其要区分扩展名与浏览器可能添加的重名编号。
进入目录
在文件管理器中使用当前目录的终端入口(若桌面环境提供),也可以在终端用
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"
第一条只读取包信息,可用来核对包名、架构和依赖;第二条才安装。确认前查看终端列出的新增、升级和移除项目。如果出现大批无关软件包将被移除,先取消此次操作,重新核对发行版兼容性和软件源配置。
- 找不到依赖:若软件源本身配置正确,可先执行
sudo apt update刷新索引,再重试安装。若刷新成功但仍提示某项依赖没有候选版本,记录报错中的包名和版本条件,核对当前发行版是否满足要求。 - 提示架构不匹配:将
dpkg-deb输出的Architecture与dpkg --print-architecture的结果对照。通过换取匹配文件解决,不要为了装一个桌面应用去更改系统的架构配置。
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 没有菜单入口时,先使用上一节的终端命令启动。