README

ShellCrash


  
    
  
  
    
  



  一款在 Shell 环境下便捷部署与管理 mihomo/sing-box 内核的脚本工具



  简体中文 | English


---

 :rocket: 核心特性

- 多内核支持：在 Shell 环境下便捷管理及切换 mihomo 与 sing-box 内核。
- 灵活配置管理：支持在线导入订阅连结及配置文件，简化配置流程。
- 自动化任务：支持配置定时任务，实现配置文件与规则的自动定时更新。
- 图形化面板：支持在线安装并使用本地 Web 面板（Dashboard），直观管理内置规则与流量。
- 多模式运行：支持路由模式、本机模式等多种流量转发模式切换。
- 一键维护：内置脚本在线更新功能，保持版本与功能的及时更迭。

 :computer: 设备支持

ShellCrash 旨在兼容绝大多数基于 Linux 内核的网络设备：

 路由器设备：支持各种基于 OpenWrt 或其二次开发固件（如 小米路由、网件路由等设备）。
 Linux 服务器：支持运行标准 Linux/GNU发行版（如 Debian、CentOS、Armbian、Ubuntu 等）的设备。
 第三方固件：兼容 Padavan（保守模式）、潘多拉固件以及华硕/梅林固件。
 其他设备：兼容各种基于Linux/GNU或者Linux/busybox开发的设备。
 Docker：部分可能不兼容的设备（如群辉、PVE），支持docker环境运行。

 更多设备支持，请提交 Issue 或前往 Telegram 群组 反馈（请附上设备型号及 uname -a 命令的输出信息）。

---

 :hammer_and_wrench: 安装指南

 [!TIP]
 若遇到连接失败或SSL相关问题，请尝试切换至其他安装镜像站。

 前置条件
1. 确保设备已开启 SSH 并获得 Root 权限（带图形介面的 Linux 系统可直接使用终端）。
2. 使用 SSH 工具（如 Putty、JuiceSSH、或系统自带终端）连接至设备。

 :penguin: 标准 Linux 设备安装

 [!IMPORTANT]
 请以 root 用户进行安装。

 使用 wget 安装（jsDelivr CDN 源）
sh
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \
  && bash /tmp/install.sh \
  && . /etc/profile & /dev/null


 或使用 curl 安装（作者私人源）

sh
export url='https://gh.jwsc.eu.org/master' \
  && bash -c "$(curl -kfsSl $url/install.sh)" \
  && . /etc/profile & /dev/null


 :satellite: 路由器设备安装

使用 curl 安装：
 GitHub 源（推荐海外环境或具备代理环境使用）
sh
export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' \
  && sh -c "$(curl -kfsSl $url/install.sh)" \
  && . /etc/profile & /dev/null


 或 jsDelivr CDN 源

sh
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \
  && sh -c "$(curl -kfsSl $url/install.sh)" \
  && . /etc/profile & /dev/null


 或作者私人源
sh
export url='https://gh.jwsc.eu.org/master' \
  && sh -c "$(curl -kfsSl $url/install.sh)" \
  && . /etc/profile & /dev/null


使用 wget 安装：
 GitHub 源（推荐海外环境或具备代理环境使用）
sh
export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \
  && sh /tmp/install.sh \
  && . /etc/profile & /dev/null


 或 jsDelivr CDN 源
sh
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \
  && sh /tmp/install.sh \
  && . /etc/profile & /dev/null


 :pager: 老旧设备使用低版本 wget 安装

 作者私人 http 内测源
sh
export url='http://t.jwsc.eu.org' \
  && wget -q -O /tmp/install.sh $url/install.sh \
  && sh /tmp/install.sh \
  && . /etc/profile & /dev/null



 :cloud: 虚拟机
- Alpine Linux 虚拟机：强烈建议使用 Alpine 镜像以获得最佳兼容性
sh
 安装必要依赖
apk add --no-cache wget openrc ca-certificates tzdata nftables iproute2 dcron

 执行安装命令
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@master' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh \
  && sh /tmp/install.sh \
  && . /etc/profile & /dev/null


  :whale: Docker 

 请访问官方 Docker 镜像：

- ShellCrash on Docker Hub


 :package: 本地安装

若无

Top issues

Latest release

🌟 新增功能
新增访问与控制菜单： 
~新增tg控制机器人，支持管理内核服务、查看日志、下载上传配置文件、备份还原脚本设置、上传内核等功能
~新增自定义公网vmess及ss入站功能，支持一键生成秘钥，一键生成分享链接
~新增自定义内网穿透功能，支持快速配置Tailscale/Wireguard内网穿透服务
增加upx压缩版内核和内核版本分支选择菜单，现在支持精简版、标准版和开发版三个版本mihomo及singboxr内核下载
增加单独指定dns劫持端口的功能(用于搭配第三方DNS服务)
增加ecs优化功能
增加自启检测，修复反复自启导致死机循环的bug

⚡ 优化改进
优化了大量界面层级及内容，将原有的局域网过滤、quic过滤等功能整合到2-3流量过滤菜单
优化为统一使用ON/OFF来表示功能开启关闭状态
全面重构代码，优化代码结构，优化脚本运行效率。
重写保守模式启动脚本及守护进程。
重写常用端口过滤功能
优化小米路由自启脚本，现在自启脚本单独存放为/data/shellcrash_init.sh，且在卸载脚本时会保留改脚本并保留软固化功能
优化定时任务
优化版本回退功能，现在支持回退到近期tags

🛠 BUG修复
~修复ddns工具的一些bug
~修复docker相关bug
~修复部分小米设备Tproxy自启失效的bug
~修复