在 Debian、Ubuntu 上优先选 deb,在使用 dnf 的 Fedora 上优先选 rpm;如果希望把程序留在个人目录、按文件启动,可以在确认架构和运行环境兼容后选 AppImage。以下步骤适用于首次安装或从一种格式换到另一种格式的用户,覆盖下载前核对、安装命令和首次启动报错。
先按发行版和处理器架构选格式
包格式与处理器架构是两项独立的条件。Ubuntu 和 Fedora 即使运行在同一种处理器上,通常也分别使用 deb 和 rpm。反过来,两份文件即使都以 .deb 结尾,也可能面向不同的架构。先确认系统,再按下载页标注核对文件;不要靠改扩展名把一种包变成另一种。
cat /etc/os-release
uname -m
第一条命令查看发行版,重点看 ID,衍生发行版也可参考 ID_LIKE;第二条命令查看当前内核架构。常见输出 x86_64 对应下载标注中的 x86-64,deb 包通常称 amd64;aarch64 对应 64 位 ARM,deb 包通常称 arm64。如果系统使用的用户空间架构与内核不同,以包管理器能处理的架构为准;在 Debian 或 Ubuntu 上可用 dpkg --print-architecture 核对。名称对应关系不代表每种格式都有所有架构的构建。
包管理器安装
推荐使用发行版对应的 deb 或 rpm。apt 或 dnf 会登记已安装的软件包,并尝试从已启用的软件源解析依赖。安装本地文件本身不等于添加了更新源。
适合:发行版有对应包,且希望用系统包管理器查看或卸载 Shadowrocket。
AppImage 文件启动
将文件保存在个人目录,加执行权限后直接启动,不需要先把它注册到 apt 或 dnf。仍需满足该文件的架构及运行环境要求。
适合:希望手动管理程序文件,或系统没有适用的 deb、rpm,但能运行该 AppImage。
下载后确认位置与文件名
打开下载页
进入下载页的 Linux 区,按上一步核对的包格式和架构选择文件。只需选一种安装方式;重复下载三种格式不会补齐任何依赖。
定位下载文件
在浏览器的下载记录中找到刚下载的文件,打开所在文件夹,确认下载已经结束。不要把临时下载文件当成安装包,也不要默认文件一定保存在名称为
Downloads的目录。打开文件目录
在终端用
cd进入文件所在目录;路径含空格时用双引号包住。运行pwd核对当前目录,再用ls -l核对文件名。后面的命令都从这个目录执行。核对命令参数
命令中的
Shadowrocket.deb、Shadowrocket.rpm和Shadowrocket.AppImage是示例文件名。执行时使用实际文件名,保留前面的./,并注意 Linux 文件名区分大小写。文件名含空格时,把整个./文件名放在双引号中。
用 apt 安装 deb、用 dnf 安装 rpm
下面两条命令只执行与你下载的格式对应的一条。./ 明确告诉包管理器,这是当前目录中的本地文件,不是要从软件源按名称搜索的包。命令会显示计划安装、升级或移除的包;确认清单后再继续,尤其不要忽略意外出现的移除项。
deb 安装
- 适用系统
- Debian、Ubuntu 等使用 apt 的发行版
- 安装命令
sudo apt install "./Shadowrocket.deb"- 架构核对
dpkg --print-architecture- 读取包名
dpkg-deb -f "./Shadowrocket.deb" Package
如果提示缺少依赖,先看报错中的包名与版本要求,再检查当前发行版的软件源。
rpm 安装
- 适用系统
- Fedora 等使用 dnf 的发行版
- 安装命令
sudo dnf install "./Shadowrocket.rpm"- 读取包架构
rpm -qp --qf '%{ARCH}\n' "./Shadowrocket.rpm"- 读取包名
rpm -qp --qf '%{NAME}\n' "./Shadowrocket.rpm"
rpm 是包格式,不代表所有使用 rpm 的发行版都使用 dnf,也不代表它们可以互换安装包。
命令完成后,可用卡片里的查询命令读出包内部名称。deb 用户再用 dpkg -s 加该包名查看状态,看到 Status: install ok installed 即已登记为安装完成;rpm 用户用 rpm -q 加该包名查询。查询时不要把下载文件名当成内部包名。确认已安装后,再在桌面应用菜单中搜索 Shadowrocket。
给 AppImage 加执行权限并启动
如果打算长期使用 AppImage,先将它移到个人主目录下便于管理的位置,再从该目录执行以下命令。第一条只给文件所有者增加执行权限,第二条以当前用户身份启动。两条命令都不需要 sudo。
chmod u+x "./Shadowrocket.AppImage"
"./Shadowrocket.AppImage"
- 保留终端窗口:如果双击文件没有反应,从终端启动可直接看到错误输出。先看第一条具体错误,再判断是权限、架构还是运行环境问题。
- 区分文件与菜单:直接运行 AppImage 不等于注册桌面应用菜单项。即使菜单搜索不到,也可以回到文件所在目录执行同一条启动命令。
- 区分程序与配置:更换 AppImage 时,先退出正在运行的程序,再下载新文件、加执行权限并启动确认。删除旧的 AppImage 只会删除程序文件,不等于清除用户目录中的应用设置。
常见安装和启动报错
文件明明下载了,为什么找不到?
先运行 pwd 和 ls -l,确认终端确实处于浏览器显示的下载位置。重复下载后文件名可能多出编号,大小写也必须与磁盘上的名称一致。在终端键入 ./ 和文件名前几个字符,再按 Tab 补全,可减少手输错误。
apt 或 dnf 提示依赖装不上怎么办?
先记下缺少的依赖名称、版本要求和当前发行版。apt 若提示索引过期或无法定位依赖,可先运行 sudo apt update;dnf 可用 dnf repolist 查看启用的软件源。若更新索引后仍没有所需版本,回到下载页核对包与系统是否匹配,不要强制跳过依赖。
加了执行权限,为什么还是 Permission denied?
先用 ls -l 确认所有者权限中有 x,再用 findmnt -T . -o TARGET,OPTIONS 检查当前目录所在挂载点。如果选项里有 noexec,给文件加权限也不能直接执行;将文件移到允许执行的个人目录,再重新核对权限并启动。
AppImage 提示缺少 FUSE 或 libfuse.so.2 怎么办?
先核对错误是否明确指向 libfuse.so.2。若是,按当前发行版的软件源查找提供该库的兼容包;仅装有 FUSE 3 不代表系统也提供 FUSE 2 的库。若环境不允许 AppImage 所需的挂载操作,且下载页有兼容的 deb 或 rpm,可改用对应的包管理器安装。