ShellCrash安装教程：官网下载、面板与Docker配置

ShellCrash 的正确安装顺序是：装脚本 → 选内核 → 导入订阅或配置 → 启动服务 → 打开面板。 它不是自带节点的机场客户端，也不是一个装上就能接管全网的网页插件。现在已经有官方 Docker 镜像，NAS 用户无需因为旧教程而默认选择第三方镜像。

ShellCrash官网、GitHub与下载，先认清三种版本

截至 2026年10月16日，Release 最新正式版是 1.9.4（2月15日发布），而 master 的版本文件已经是 1.9.5beta3。update 分支另行分发内核、规则和 dashboard。“master下载”“最新正式版”“最新内核”不是同一个东西，不要只看文件都叫 ShellCrash.tar.gz 就互相覆盖。

本站下载分为正式包、master快照、update资源和Docker离线包，均保留上游来源；脚本与更新资源固定到具体提交，避免同名文件悄悄变动。它们是下载镜像，项目的官方网站仍是上面的官方入口。

脚本安装包下载

脚本包不等于完整离线环境。 还需要对应CPU的内核，某些模式还需规则数据和面板；install.sh 本身是联网安装引导，下载到本地并不代表它后续不再联网。正式包 SHA256：

4f946031a0483ed528e266143d459075489cce6c3f8f2f4681f39ca6d7448681

内核、Web面板和全部资源

本次同步官方 update 分支的完整 bin 文件目录，包括各架构内核、六种面板、规则数据及历史兼容资源。新安装优先让脚本选择内核；手工安装时，下面的 meta 是 mihomo，singboxr 是项目分发的 sing-box 分支构建，并非所有文件都等同于 SagerNet 原版。

面板下载：Zashboard · MetaCubeXD · Yacd-meta · Meta Dashboard · Yacd · Clash Dashboard。

完整113文件下载目录 · JSON来源清单 · SHA256校验清单

.tar.gz、.gz 和 .upx 不是可以随意改扩展名互换的文件：前者是归档包，单独的 .gz 需解压，.upx 是压缩过的可执行文件。老设备的字节序、浮点ABI也会影响能否运行，MIPS、MIPSLE、softfloat、hardfloat不能只看名字相近就混装。目录中的旧 Clash、HFS 和特定 tun.ko 是历史兼容资源，不是新装必备；尤其不能把一个旧内核模块装进任意固件。

完整文件清单提供每个文件的原始下载地址、本站下载地址、字节数和SHA256。对应仓库源码快照也随清单提供，许可证保留在源码内。面板与内核按各自上游许可分发。官方更新目录

ShellCrash安装教程：OpenWrt、ImmortalWrt与Linux

先确认安装条件

需要设备可以SSH登录、有root权限，并能使用 curl 或 wget。透明代理还依赖固件的 iptables / nftables 和相应内核能力；缺少这些时，脚本可能只能用纯净模式，不能凭空补齐固件功能。官方支持范围与依赖

uname -m
df -h
command -v curl
command -v wget
command -v nft
command -v iptables

ImmortalWrt 是可考虑的OpenWrt衍生环境，但ShellCrash不是LuCI的IPK/APK插件。 它通过SSH安装和管理。先确认固件有匹配的防火墙与TUN/TPROXY支持，不要为了安装脚本混用其他固件的软件源。路由器上若已有OpenClash、PassWall或HomeProxy接管流量，先停止其中的透明代理服务，避免同时争抢DNS端口和防火墙规则。

在线安装：跟随官方master

以下会安装官方master当前提供的版本，不锁定1.9.4正式版。先把脚本下载成文件，检查后再运行；命令在目标路由器或Linux的SSH终端中执行。

export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master'
curl -fL "$url/install.sh" -o /tmp/install.sh

下载成功后，路由器通常使用：

sh /tmp/install.sh
. /etc/profile
crash

标准Linux按官方说明以root运行 bash /tmp/install.sh，随后重新载入 /etc/profile。如果无法连接GitHub，可改用官方说明中的 CDN 根地址 https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master。遇到证书错误，先校准设备时间、检查CA证书，不要把关闭证书校验当成必做步骤。

按照提示选择有足够空间、重启后仍保留的安装目录；/tmp 只用于中转下载。安装后默认命令是小写 crash，也可按安装提示选择别名。命令找不到时先重新连接SSH，不要照着旧文章一直输入大写 Crash。

本地安装：固定使用下载的脚本包

把所选版本的原始 ShellCrash.tar.gz 上传到目标设备 /tmp，无需先在电脑上解压。路由器的本地安装方式为：

mkdir -p /tmp/SC_tmp
tar -zxf /tmp/ShellCrash.tar.gz -C /tmp/SC_tmp
. /tmp/SC_tmp/init.sh

标准Linux改用 bash /tmp/SC_tmp/init.sh，完成后重新加载环境。随后按脚本提示导入匹配架构的内核与配置；不要把脚本包直接当作内核上传。作者本地安装教程

ShellCrash配置教程：订阅导入后怎么使用？

1. 执行 crash，先按引导选择运行环境和内核。普通Clash格式订阅可先考虑mihomo；已有sing-box配置则选择相匹配的内核。
2. 从机场后台复制对应的订阅链接或完整配置下载链接，进入配置导入菜单。官网登录页、付款页不是订阅地址；不要把含令牌的链接贴到公开评论区。
3. 按提示区分“完整配置下载”和“订阅转换”。转换服务会接触你的订阅内容，优先使用服务商提供的兼容格式或自己信任的转换服务。
4. 下载成功后启动内核，查看脚本状态和日志。确认规则模式、策略组与节点已出现，再安装面板。
5. 先让一台设备验证连通与分流，再扩大到全网。使用HTTP/SOCKS代理和让路由器透明接管，是两种不同的使用方式。

菜单编号可能随版本调整，按“配置文件”“导入”“启动”等菜单名称操作。crash -h 可查看本机版本实际支持的命令。控制节点延迟有响应，不代表浏览器一定走了代理；需要同时检查策略组选择和面板里的实际连接。

ShellCrash配置文件放在哪里？

安装目录由你安装时选择，脚本通常以 CRASHDIR 指代；容器内为 /etc/ShellCrash。不要把某篇教程中的目录机械套到所有路由器上。

切换内核前先备份这些目录。Clash YAML与sing-box JSON不能只改后缀来转换，旧配置也可能不支持新内核的字段。

ShellCrash面板与dashboard：能选节点，不代替SSH管理

脚本菜单负责安装、更新、服务和网络设置；Web面板负责选择策略、查看连接与流量。进入脚本的更新/面板管理功能安装本地面板后，按脚本输出的网址访问。默认端口通常是 9999，常见地址如下，IP需替换为你的设备地址：

http://192.168.1.1:9999/ui/

Zashboard、MetaCubeXD、Yacd等是不同界面，不是额外的机场账号。面板要求填写后端地址或密钥时，使用当前内核的管理地址与 secret；不要把机场订阅链接填到后端地址栏。官方面板安装实现

管理端口只供可信局域网使用。容器里的防火墙功能不能代替宿主机对暴露端口的访问控制。

ShellCrash自定义规则：别直接改运行时配置

优先在脚本的配置覆写 → 自定义规则中添加。mihomo也可编辑安装目录的 yamls/rules.yaml，脚本会把这些规则放在原有规则之前；例如下面只让示例域名直连：

- DOMAIN-SUFFIX,example.com,DIRECT

这是 rules.yaml 的规则条目，不要再包一层 rules:。如果把 DIRECT 换成某个代理策略组，名字必须与配置中的组名完全一致。改动后重启并看日志、面板连接匹配到了哪条规则。

高级设置使用 yamls/user.yaml 等覆写文件；自行写入完整 dns: 段会影响脚本的DNS生成逻辑。sing-box则使用JSON体系，不要照抄上述YAML。脚本对合成配置会做校验，校验失败可能回退到基础配置继续启动，所以“服务在运行”并不能证明你的自定义规则已生效。官方配置合并与校验代码

ShellCrash DNS与IPv6怎么设置？

先保留引导生成的可用配置，再处理具体问题，不要同时改DNS模式、上游DNS、代理模式和IPv6四处开关。

更改模式后需要重启服务。已使用AdGuard Home、SmartDNS等服务时，要明确谁监听53端口、谁向谁转发，以及哪些请求进入代理DNS。官方DNS菜单与说明

“返回IPv6地址”和“代理IPv6流量”是两个设置。 DNS可以给设备返回AAAA记录，但如果IPv6透明路由没有接管，设备仍可能绕过IPv4代理直连。脚本有独立的IPv6透明路由和IPv6 DNS解析选项，需要固件、内核和实际网络同时支持。

尤其是下面的Docker IPv4旁路由方案：仅把IPv4网关改成容器地址，不会改变设备通过主路由取得的IPv6出口。官方示例要求禁用下游IPv6或主路由IPv6以避免绕过；如果你需要保留IPv6，应另行完成IPv6网关和代理接管，而不是只打开一个DNS开关。官方IPv6设置代码

ShellCrash Docker镜像下载与部署教程

官方镜像是 juewuy/shellcrash。本次 latest 的四个平台为 linux/amd64、linux/arm64、linux/arm/v7 和 linux/386；镜像创建于2026年8月2日，因此镜像内置内核不应直接当作10月update分支的版本。

这些离线包由本站从官方Docker Registry的镜像层导出为Docker load格式，没有重编译镜像或修改配置、文件层；它们不是作者在Releases上传的tar附件。已校验平台清单、配置摘要和每层内容摘要，当前工作环境未进行容器运行测试。要获取官方原始镜像，可直接：

docker pull juewuy/shellcrash:latest

若要固定本文核实的镜像，使用以下摘要；将来要更新再重新检查官方标签：

docker pull juewuy/shellcrash@sha256:702d1c291e8aeae321b6ce028f1d36fa35592215b0b8b045fa1a26ab21ec0c18

离线安装则下载与你的Docker宿主机架构一致的包，例如amd64：

docker load -i shellcrash-linux-amd64.tar.gz

先跑HTTP/SOCKS代理，完成容器初始化

下面示例仅绑定宿主机回环地址，适合先在本机验证，并挂载三个命名卷保留配置。需要局域网设备访问时，将 127.0.0.1 改为宿主机实际的局域网IP，同时限制访问来源。

docker run -d --name shellcrash \
  -p 127.0.0.1:7890:7890 \
  -p 127.0.0.1:9999:9999 \
  -v shellcrash_configs:/etc/ShellCrash/configs \
  -v shellcrash_yamls:/etc/ShellCrash/yamls \
  -v shellcrash_jsons:/etc/ShellCrash/jsons \
  --restart unless-stopped \
  juewuy/shellcrash:latest

docker exec -it shellcrash sh -l

进入后按引导或输入 crash，导入配置、允许开机启动、启动内核。HTTP/SOCKS混合端口为7890，面板端口为9999。这个部署不会自动改变家中其他设备的默认网关；需要在客户端配置代理地址才会使用它。

NAS旁路由：官方推荐macvlan，先改网络参数

从上方下载官方Compose模板，编辑网卡、网段、网关与容器IP。模板里的 eth0、192.168.31.0/24、192.168.31.1、192.168.31.222 都是示例，不能原样照抄到不同局域网。

确认宿主机提供 /dev/net/tun，并理解模板中网络管理能力的用途后，在模板所在目录执行：

docker compose up -d
docker exec -it shellcrash sh -l

完成容器内配置，再把测试设备的IPv4网关和DNS都指向容器IP。先测试一台设备，并按前面的IPv6说明处理绕过问题。macvlan下不要把“NAS宿主机打不开容器IP”直接判断为镜像损坏；先从同网段另一台设备访问。官方Docker部署说明

更新、卸载与常见故障

更新前备份 configs、yamls、jsons，通过脚本菜单分别更新脚本、内核和规则。当前工作正常时，不要为了追一个“最新版”同时切换测试脚本和不同内核分支。

脚本安装的卸载入口：

crash -u

先备份，再按卸载提示操作；不要只删安装目录留下防火墙规则和启动项。Docker安装可先停止并删除容器：

docker stop shellcrash
docker rm shellcrash

这两条命令保留上述命名卷。Compose部署用 docker compose down；加 -v 或另外删除卷会清空持久化配置。作为旁路由使用时，卸载之前先恢复下游设备的网关与DNS，否则删完服务会造成断网。

订阅怎么选，有哪些可配合使用的机场？

ShellCrash需要的是内核支持的协议和可导入的配置。机场只提供封闭客户端、不允许导出订阅时，即使宣传用了同一种协议，也不应默认能接入ShellCrash。已经有订阅的用户先试现有服务，无需因为换脚本就重新买套餐。

需要另选时，可以先看 帕克云 和 Fancy Network 的站内评测：前者提供Clash/ClashMeta等第三方导入入口，且限制中国大陆地区使用；后者使用Shadowsocks，适合已有兼容订阅、愿意自行导入的用户，但新疆及海外用户应先看购买限制。两家均应先确认可获取mihomo支持的配置，再按短周期试用；这里只判断协议和配置方向，未实测它们在ShellCrash上的速度或解锁效果。

如果你更希望全程在路由器网页中操作，也可对照 HomeProxy配置教程；只想了解代理内核本身，则看 sing-box教程。选择管理方式时，先看设备环境与自己是否愿意维护SSH脚本。