ShellCrash 路由器导入订阅教程：脚本方案怎么用

官方信息核对（2026-10-21）

下表信息全部来自官方 GitHub 仓库首页、README 与 Releases 页面。

项目	核对结果
官方仓库	https://github.com/juewuy/ShellCrash
官方发布页	https://github.com/juewuy/ShellCrash/releases
最新发布版本	1.9.4（显示为 1.9.4-release，标记为 Latest，非预发布）
发布日期	2026-02-15
适用系统	基于 OpenWrt 的路由器固件、Padavan（保守模式）、潘多拉、华硕梅林、Debian / CentOS / Armbian / Ubuntu 等 Linux、其他 Linux/busybox 设备、Docker 环境
许可证	GPL-3.0
是否归档	否，仓库代码近期仍有提交
内核	mihomo 与 sing-box
与 ShellClash 的关系	未能核实（官方 README 未写明，仅交流群链接使用 ShellClash 名称）
订阅格式	未能核实（README 提到可在线导入订阅链接和配置文件，但没有列出具体格式）

仓库简介是「Run sing-box/mihomo as client in shell」，即在 Shell 环境里把 sing-box 或 mihomo 当作客户端运行。值得注意的是，最新正式发布停留在 2026 年 2 月，但仓库代码在 10 月仍有更新，说明项目在开发中，只是正式发布节奏较慢。

ShellCrash 和 LuCI 插件有什么不一样

OpenClash、PassWall、HomeProxy 都是 LuCI 插件，依赖 OpenWrt 的网页后台。ShellCrash 走的是另一条路：它是一套 Shell 脚本，在终端里用菜单交互，不依赖 LuCI。这样带来两个直接结果：

• 适用设备更广。 只要设备是 Linux 系统、能拿到 root 权限、具备基本工具，就有机会运行。官方 README 列出的环境从小米、网件等厂商机型上的 OpenWrt 类固件，到梅林、Padavan，再到 Linux 服务器和群晖、PVE 上的 Docker，都在范围内。官方还建议在虚拟机里使用 Alpine Linux 以获得较好的兼容性。
• 操作方式更「命令行」。 没有网页按钮，所有设置都在终端菜单里完成。习惯点鼠标的用户需要适应。

所以选择 ShellCrash 的典型场景是：你的设备不是标准 OpenWrt，装不了 LuCI 插件；或者你想在一台 Linux 小主机上做旁路由。如果你已经有一台标准 OpenWrt 路由器，LuCI 插件通常更直观。

动手前：备份与风险

脚本工具同样会修改防火墙规则和 DNS，失误时可能导致整个局域网断网。如果你为了运行它而去刷第三方固件，刷机失败还可能让设备无法启动。请先做好下面这些准备：

1. 备份设备配置。 路由器固件一般在系统管理页面提供备份功能；Linux 主机则建议备份网络和防火墙相关的配置文件，或在虚拟化平台上先做快照。不同固件与版本名称略有差异。
2. 确认能用 SSH 登录且有 root 权限。 官方 README 明确要求以 root 用户安装，并提前开启 SSH。
3. 确认 curl 或 wget 可用。 官方依赖表把两者之一列为必需，节点保存、在线安装和更新都要用到。
4. 保留回退手段。 记住设备的恢复模式进入方法，准备备用网络，旁路由方案要知道如何把主路由的网关改回来。

ShellCrash 安装与进入菜单

官方 README 提供了在线安装与本地安装两类说明，并给出了本地安装教程和常见问题文档的链接。安装命令会随版本和下载源调整，本文不转录具体命令参数，请直接以官方 README 当前内容为准。只从官方仓库及其 README 中列出的渠道获取脚本，不要使用来源不明的转载版本，判断方法见 下载安全指南。

安装完成后，官方说明的用法是在终端输入 crash 进入交互式菜单，加帮助参数可查看命令列表。菜单里通常会有导入订阅、选择内核、设置运行模式、启动与停止服务等入口，具体条目以脚本实际显示为准。

Docker 用户可以使用官方 README 指向的 Docker Hub 镜像，部署方式请以镜像页面说明为准。

ShellCrash 导入订阅

在 crash 菜单中找到导入订阅或配置文件的选项，按提示粘贴机场提供的订阅链接即可。官方 README 只说明可以在线导入订阅链接和配置文件，没有逐项列出支持的订阅格式，所以本页的「对口订阅」暂不标注。

从内核角度推理，ShellCrash 运行的是 mihomo 或 sing-box：

• 选 mihomo 内核时，思路与 Clash 系客户端相同，机场的 Clash 订阅通常是首选，相关知识见 Clash 订阅指南。
• 选 sing-box 内核时，配置结构与 Clash 不同，可以先读 sing-box 介绍 了解差异。

以上是基于内核特性的一般说明，不是官方对订阅格式的承诺。实际能否导入，请以脚本菜单中的提示和官方常见问题文档为准。

订阅链接相当于账号凭证，在终端里粘贴时注意不要被录屏或截图外泄，说明见 订阅链接是什么。更新失败时，先确认设备本身能访问订阅地址，再按 订阅更新失败 排查。

运行模式与资源占用

脚本工具的一个优势是可以在资源有限的设备上运行，但内核本身仍需要内存。官方 README 提到 Padavan 需要使用保守模式，这本身就说明不同固件的兼容程度不一样。建议：

• 在低配路由器上优先选择资源占用较低的运行方式，规则和节点不要堆太多。
• 观察一段时间的内存占用，出现间歇断流时先排查是否内存不足，参考 连接断开怎么办。
• 分流规则从简单开始，比如国内直连、其余代理，稳定后再细化，规则原理见 分流规则指南。

不同环境下的注意事项

ShellCrash 覆盖的环境很多，每类环境要留意的地方不一样：

• OpenWrt 类固件路由器。 这类设备同样可以装 LuCI 插件，两种方案不要同时启用，否则防火墙规则会互相覆盖。厂商定制的 OpenWrt 类固件可能对系统分区有限制，脚本文件放在哪里、重启后是否保留，请参考官方常见问题文档。
• 华硕梅林、Padavan、潘多拉等第三方固件。 这类固件本身就是刷机得来的，系统与标准 OpenWrt 差异较大。官方特别注明 Padavan 需要保守模式，说明兼容性存在差异，开启前先读官方说明。
• Linux 服务器或小主机。 常见用法是做旁路由，让局域网设备把网关指向这台主机。要考虑主机重启、关机时全家断网的问题，主路由最好保留随时改回网关的办法。
• Docker 环境。 在群晖、PVE 等平台使用官方镜像时，网络模式和权限设置会直接影响能否接管流量，部署前请读镜像页面的说明。官方还建议在虚拟机中使用 Alpine Linux 以获得更好的兼容性。

无论哪种环境，首次启用前都建议先在一台测试设备上验证，再让全家的流量经过它。

内核怎么选

ShellCrash 同时支持 mihomo 和 sing-box 两种内核。如果你之前用过 Clash 系客户端，比如 Clash Verge Rev，选 mihomo 能沿用熟悉的规则写法；如果你更看重 sing-box 的协议支持和路由能力，可以选 sing-box。切换内核后，原有配置不一定能直接沿用，切换前先备份当前配置。

关于版本与更新

ShellCrash 的正式发布版本更新间隔较长，而仓库代码更新较频繁。对普通用户来说，建议使用官方正式发布的版本，不要随意切换到开发中的代码，以免遇到尚未修复的问题。脚本菜单里如果提供了更新入口，更新前先备份当前配置，更新后检查服务能否正常启动、订阅能否正常拉取。遇到问题时，可以先查阅官方常见问题文档，再到官方交流渠道搜索是否已有相同反馈。

ShellCrash 出问题时如何回退

• 先在 crash 菜单里停止服务，确认网络是否恢复。
• 如果是旁路由方案，把客户端或主路由的网关改回主路由地址，即可让全家先恢复上网。
• 仍不行时，使用事先备份的配置或虚拟机快照还原。
• 卸载时请使用脚本菜单提供的卸载入口，避免手动删除文件后残留防火墙规则。

适合谁

ShellCrash 适合手里设备不是标准 OpenWrt、又有一定命令行基础的用户，比如梅林固件路由器、Linux 小主机、NAS 上的 Docker。如果你更需要图形界面，可以看同站的 OpenClash、PassWall 或 HomeProxy 页面；如果只是给少数设备翻墙，直接在设备上装客户端最省事，选择方法见 家庭设备使用指南 和 客户端总览。本页信息核对于 2026 年 10 月 21 日，安装前请回到官方仓库确认最新说明。