Shadowrocket Linux 版免费,Mac(Apple 芯片 / Intel)、Windows、安卓版也免费;iPhone / iPad 版在 App Store $2.99 一次性付费,系统要求以 App Store 页面标注为准。本文面向需要安装 Linux 桌面客户端的用户,按系统识别、包格式选择、本地安装、启动排错与连接检查展开;安装文件统一从本站下载页获取,不需要先寻找第三方软件源。
一、先确认发行版与处理器架构
deb、rpm 与 AppImage 是不同的分发格式,不是三种连接协议。选择安装包时先看发行版使用的包管理器,再看处理器架构;文件扩展名相同,不代表一定适合当前设备。Linux 桌面环境、运行库与文件系统权限也会影响启动,不能只凭下载成功判断已经具备运行条件。
在终端执行下面两条命令。第一条读取发行版标识,重点看 ID 与 ID_LIKE;第二条查看当前系统报告的机器架构。它们只读取信息,不安装软件,也不会修改连接设置。
cat /etc/os-release
uname -m
发行版判断
- Debian / Ubuntu
- 优先选择 deb,用 apt 安装本地文件。
- Fedora
- 优先选择 rpm,用 dnf 安装本地文件。
- 其他发行版
- 先看发行版说明,再确认 AppImage 的运行条件。
rpm 扩展名不等于所有 rpm 系统的依赖环境完全相同。
架构与权限
- x86_64
- 通常对应 x64 / amd64 标识的构建。
- aarch64
- 通常对应 ARM64 架构,需下载页有匹配构建。
- 安装权限
- deb / rpm 系统安装通常需要 sudo 授权。
以下载页实际提供的架构为准,不把其他架构的包当作兼容包。
进入下载页的 Linux 区域选择实际提供的包。若没有与处理器匹配的文件,应先停止安装;更换扩展名、反复执行安装命令,都不能把一种机器架构转换成另一种。
二、下载后按同一套顺序准备
下面的步骤先处理文件位置与命名,再执行对应的安装命令。本文使用的 shadowrocket-local.deb、shadowrocket-local.rpm 与 shadowrocket-local.AppImage 都是为了便于输入而设置的本地名称,不是下载站上的实际包名,也不表示版本。
-
选择安装包
打开本站获取应用页 → Linux,按发行版与架构下载一个合适的文件。deb、rpm、AppImage 三者选择一种安装路径即可。
-
准备文件位置
在文件管理器中进入文件所在目录,使用该桌面环境的“在终端打开”操作。不要默认下载目录一定叫 Downloads;本地化名称与浏览器设置可能不同。
-
简化本地名称
只重命名刚下载的那个文件:deb 改为 shadowrocket-local.deb,rpm 改为 shadowrocket-local.rpm,AppImage 改为 shadowrocket-local.AppImage。保留原来的扩展名。
-
执行对应命令
按下一节选择 apt、dnf 或 chmod 路径。安装完成后从应用菜单或文件本身启动,再进入 Home 检查用户已有的连接信息。
三、Debian / Ubuntu:用 apt 安装 deb
对于 Debian / Ubuntu 系统,本地 deb 应优先交给 apt 处理。apt 能在系统已配置的软件源可用时解析依赖;只执行 dpkg -i 则可能留下尚未满足依赖的安装状态。安装前可以读取包的架构字段,与前面的系统架构对照。
dpkg-deb -f ./shadowrocket-local.deb Architecture
sudo apt install ./shadowrocket-local.deb
执行 sudo 时输入的是当前 Linux 用户的授权密码,终端通常不会显示输入字符。apt 列出准备安装或调整的软件包后,先阅读摘要;如果出现大量与本次安装无关的删除项,取消操作并检查系统软件源和依赖状态,不要直接确认。
- 提示依赖无法满足:先核对发行版是否仍受维护、软件源是否可访问,以及软件包架构是否匹配。必要时执行
sudo apt update刷新索引,再重新安装本地文件。 - 提示包管理器锁被占用:等待系统更新或另一项 apt 操作结束。不要直接删除锁文件,以免破坏正在进行的事务。
- 想确认包是否登记:运行
dpkg-deb -f ./shadowrocket-local.deb Package查看实际包名,再到系统软件管理器中按该名称查找。
安装完成后从应用菜单启动 Shadowrocket。图形桌面通常会读取安装包提供的桌面入口;终端里安装成功但没有立即出现图标时,可以先关闭并重新打开应用菜单。不要凭产品显示名猜测终端可执行文件的大小写。
四、Fedora:用 dnf 安装 rpm
Fedora 用户使用 dnf 安装本地 rpm,依赖由当前系统配置的软件源提供。先查看包的名称和架构,再执行安装;查询命令不会运行应用。其他使用 rpm 的发行版,应按其自身包管理文档操作,不应直接照搬 Fedora 的命令和软件源。
rpm -qp --qf '%{NAME}\n%{ARCH}\n' ./shadowrocket-local.rpm
sudo dnf install ./shadowrocket-local.rpm
若 dnf 报告依赖缺失,保留完整错误文字,重点区分“仓库无法访问”“所需依赖不存在”与“架构不匹配”。这三类问题的处理方向不同:网络问题需要恢复仓库访问,依赖问题需要确认系统兼容性,架构问题则需要重新选择文件。
- 不要使用忽略依赖的参数强行完成安装,包已登记不代表程序可以正常启动。
- 不要为了安装一个客户端而添加与当前发行版不匹配的软件仓库。
- 后续更新可继续使用本站下载页提供的匹配 rpm,再由 dnf 处理本地更新事务;手动下载本地包不等于订阅了自动更新仓库。
五、AppImage:执行权限与运行环境分开检查
AppImage 适合希望将应用文件放在用户目录中管理的场景,但“单文件”并不表示适用于所有 Linux 系统。它仍受 CPU 架构、基础运行库、桌面环境以及打包方式影响;部分 AppImage 的挂载运行还依赖 FUSE。没有管理员权限时,也要先确认当前系统已经具备所需条件。
将下载的文件按前文重命名后,在它所在目录执行下面的命令。第一条只给当前用户增加执行权限,第二条从当前目录启动;不需要把整个目录改成可被所有用户写入。
chmod u+x ./shadowrocket-local.AppImage
./shadowrocket-local.AppImage
- Permission denied:用
ls -l ./shadowrocket-local.AppImage检查用户执行位。若已经有执行权限,继续检查文件是否位于以noexec挂载的分区。 - Exec format error:优先检查处理器架构与文件类型,而不是重复执行 chmod。
- 提示 FUSE 或 libfuse:按当前发行版的文档安装兼容的运行组件。不同发行版的包名可能不同,不要直接删除或替换系统已有的 FUSE 组件。
- 提示缺少共享库:记录终端中完整的库名与错误信息,检查发行版兼容性;不要从陌生网页单独下载系统库覆盖原文件。
可以把 AppImage 放入用户主目录下固定的应用文件夹,避免清理下载目录时误删。桌面快捷方式若指向这个文件,移动或重命名后也需要同步修改路径。不要使用 sudo 启动整个图形应用来绕过普通文件权限问题;确实需要系统授权的网络操作,应按应用和系统的授权提示处理。
六、安装成功后,区分启动、配置与网络问题
应用能打开,只能证明安装和基本运行环境通过了第一步检查。使用连接功能还需要用户已有的服务配置。本站不提供、不销售、不推荐节点、订阅或服务商;客户端安装与线路服务是两个独立事项。
在 Home 检查已有服务器或订阅是否已导入,在 Config 确认当前使用的配置,再检查 Global Routing。Shadowsocks、VMess、VLESS、Trojan、Hysteria2、WireGuard 是协议类型,不是安装包类型;服务端给出的协议、端口、认证和传输参数应逐项一致,不能因为换成 Linux 就自行更改。
Config:规则模式
推荐使用当前配置的规则处理连接。先确认配置来源与规则内容符合自己的需求,再把它作为日常使用姿态;并非所有配置都会把未匹配连接设为直连。
适合:已有明确分流规则,需要按域名或 IP 分别处理连接。
Proxy:代理模式
将由客户端接管的连接按代理模式处理,用于暂时排查是否为规则匹配导致的差异。它不意味着任意应用、容器或独立网络空间中的流量都已被接管。
适合:临时检查代理连接本身是否可用,随后恢复所需模式。
Direct:直连模式
将由客户端接管的连接按直连模式处理。若当前处于 Direct,即使已经选中一个服务器,也不能据此认定网页请求正在通过它转发。
适合:检查本机基础网络,区分直连故障与代理连接故障。
例如希望指定域名走代理、其余直连,规则逻辑可以写成下面两行。example.com 仅作语法示例;PROXY 所指向的代理策略仍须在实际配置中可用。规则按顺序匹配,末行 FINAL 用于处理此前未命中的连接。
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
不要把浏览器能上网当成整个系统都已使用相同网络设置。命令行程序可能读取自己的代理参数,后台服务和容器也可能使用独立环境。如果需要手动填写本地代理端口,应读取客户端当前设置中的实际监听端口,不要从教程猜一个固定数字。
七、Linux 安装常见问题
deb 装不上,能改后缀变成 rpm 吗?
不能。重命名只改变文件名,不改变包内元数据、依赖表达与安装脚本。回到本站下载页选择当前发行版适用的文件;本文简化本地名称的操作也要求保留原扩展名。
AppImage 双击没反应,先看哪里?
先在文件所在目录运行 ./shadowrocket-local.AppImage,读取终端错误。权限错误查执行位和挂载参数;FUSE 错误查运行组件;架构错误重新核对 uname -m。不要连续双击来代替错误诊断。
需要把三种包都安装一遍吗?
不需要。选择一条符合系统的安装路径即可。混用系统包和多个 AppImage 副本容易产生多个启动入口,排错时先确认正在运行哪个文件,再保留需要的安装方式。
应用启动了,订阅却更新失败怎么办?
先确认设备时间与基础网络正常,再检查 Home 中已有订阅的地址是否完整、是否仍有效。保留错误提示并向原服务提供方核对访问条件;重装 deb 或 rpm 通常不能修复失效的订阅地址。分享诊断信息时遮盖订阅 token 与认证字段。
排错记录建议包含发行版名称、uname -m 输出、所选包格式、执行过的命令,以及终端完整错误。按“文件匹配 → 安装事务 → 应用启动 → 连接配置”的顺序排查,可以避免把包管理问题误判成规则问题,也避免因连接失败而反复重装客户端。