Appearance
ShellCrash 快速配置与详细使用指南
ShellCrash 在开源网络代理界拥有极为显赫的地位。与您平时见到的那种带有精美图形界面的 Windows/Mac 客户端不同，ShellCrash 是一款纯粹基于 Shell 脚本编写的硬核代理项目。
它最大的优势在于其极低的资源占用和极其恐怖的环境适应性。无论您是运行 OpenWrt 的家庭硬路由、Padavan (老毛子) 固件，还是 Ubuntu/Debian 的 Linux 极客服务器，哪怕是没有图形界面的“黑框框”，只要设备支持 Shell 运行环境，ShellCrash 都能强行植入，将您的设备变成一台强大的透明代理网关。
1. 软件下载与安装准备
由于这是一个脚本类工具，您不需要下载 .exe 或 .dmg 文件。您需要准备一个 SSH 客户端（如 PuTTY、FinalShell 或 macOS/Linux 自带的终端），连接到您的路由器或 Linux 服务器。
第一步：获取一键安装脚本
在您的终端 SSH 界面中，复制并粘贴官方提供的一键安装脚本并回车：
bash
# 官方 GitHub 源（需要您的设备当前能访问 GitHub）
export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' && sh -c "$(curl -kfsSl $url/install.sh)" && source /etc/profile &> /dev/null
# 如果在国内无法访问，可以使用作者提供的国内备用镜像源（具体请查阅 ShellCrash 官方文档）第二步：跟随指引安装
脚本运行后，终端会呈现一个交互式的文字菜单。按照屏幕上的中文提示（按键盘的 1、2、3 数字键进行选择）：
- 选择安装目录（通常路由器选
/etc或/tmp，根据固件剩余空间决定）。 - 选择内核版本（推荐下载搭载了最新协议解析能力的 Mihomo / Meta 内核）。
2. 获取机场订阅链接
在 Linux 或路由器上配置 ShellCrash，同样需要喂给它强大的机场节点。
- 登录您的机场服务商后台（如果您还在寻找极其稳定、适合放在路由器上全家共享的节点，欢迎查看本站的 👉 2026 优质稳定机场精选）。
- 找到控制面板中的 “一键订阅” 区域。
- 点击 “复制 Clash 订阅链接” 或 “复制 Clash.Meta 订阅” 以备在终端中输入。
3. 导入节点与开启代理（终端图文流程）
安装完成后，在您的 SSH 终端中输入 crash （或者根据提示输入对应命令）即可唤出配置主菜单。
步骤一：呼出管理菜单
在 SSH 终端输入命令 crash，回车后会看到五颜六色的文字控制台。这里有启动、停止、配置等各个选项的数字序号。
步骤二：进入导入订阅选项
在主菜单中按下键盘数字 6 (导入配置文件)，接着选择 1 (在线获取完整的配置文件)。
步骤三：粘贴订阅链接并下载
根据终端屏幕的提示，将您刚刚从机场复制的 URL 粘贴到终端中并回车。ShellCrash 会调用 curl 命令从云端为您拉取几百条节点，并自动解析生成 YAML 文件。
步骤四：启动代理服务
订阅拉取成功后，一路按 0 退回主菜单。按下键盘数字 1 (启动/重启服务)。此时终端会提示内核启动成功，您的路由器或服务器流量已经被接管。
步骤五：进入 Web 网页控制面板 (Dashboard)
在主菜单中可以安装面板（如 Yacd 或 Razord）。安装后，在电脑浏览器中输入路由器的 IP 地址加面板端口（例如 http://192.168.1.1:9999/ui），即可在极其美观的网页里点击测速并自由切换节点。
4. 进阶玩法：透明代理与路由分流
ShellCrash 的王牌功能就是利用 Linux 的 iptables 或 nftables 防火墙实现透明代理。
- 工作原理：当安装在路由器上时，它可以强制接管所有连接到路由器 Wi-Fi 的设备的流量（包括手机、电脑、智能电视、游戏主机）。您不需要在手机和电脑上再装任何翻墙软件，连上 Wi-Fi 就能直接看 YouTube。
- 局域网设备控制：在
crash的管理菜单中，您可以进入高级设置，利用 Mac 地址白名单/黑名单功能，指定家里的哪些设备走代理，哪些设备（例如某些国产智能家居设备）强行直连不翻墙，避免网络冲突。
5. 常见问题排查与 FAQ
无论在何种高端的 Linux 环境下，排障的底层逻辑都不会变。以下是玩转 ShellCrash 必看的 5 个问题：
1. 为什么在终端粘贴订阅链接后，一直提示 curl 下载失败或 Timeout？
这是因为您的路由器或服务器当前没有魔法环境，无法解析被 DNS 污染的机场订阅域名。 解决办法：向机场客服索要一个国内可直连的“备用防污染订阅链接”再次尝试。如果还是不行，可以在电脑上先下载好 YAML 配置文件，再通过 SCP 或 WinSCP 工具传到路由器的对应目录。
2. ShellCrash 启动成功了，但局域网设备依然打不开外网？
通常是因为路由器的防火墙 (iptables) 转发规则没有正确建立。 解决办法：在 crash 菜单中检查代理模式，尝试在“Tproxy 模式”和“Redir 模式”之间切换。某些老旧固件不支持 Tproxy，切换到 Redir 并重启服务即可解决。
3. 为什么在网页面板 (Web UI) 里点击测速，所有节点都显示 Timeout？
这说明底层内核无法与境外服务器握手。
- 请登录机场官网检查套餐是否欠费过期。
- 节点 IP 可能已被封锁，请在主菜单重新执行“导入配置文件”，拉取机场最新的抗封锁 IP 列表。
4. 为什么装在路由器上之后，家里打王者荣耀、和平精英变卡了？
虽然内核会自动分流，但游戏的数据包非常敏感，如果被误判送到海外转一圈就会卡顿。 解决办法：在 crash 控制台中开启 UDP 转发功能，并在网页 UI (Yacd) 里将分流模式强制设定为“规则 (Rule)”，切勿使用全局代理模式。
5. 如何彻底卸载并清理环境？
如果您不想用了，在 SSH 终端输入 crash 进入主菜单，寻找并按下对应的“卸载 ShellCrash”数字选项，脚本会自动清理所有的 iptables 防火墙劫持规则，恢复您设备最纯净的网络环境。