juewuy /ShellCrash

Run sing-box/mihomo as client in shell

★ 13,685⑂ 1,885👁 66⑃ 372● 999▤ 29
ShellGPL-3.0Created 2020-07-08
Download: 1.9.4-release1.9.4-release ↓1.9.42026-02-15
+2
Daily
+20
Weekly
13,685
stars
1,885
forks
66
watchers
372
prs
999
issues
29
releases

README

ShellCrash


  
    
  
  
    
  



  A powerful script tool for the convenient deployment and management of mihomo/sing-box kernels in Shell environments.



  简体中文 | English


---

 :rocket: Core Features

- Multi-Kernel Support: Easily manage and switch between mihomo and sing-box kernels directly within the Shell environment.
- Flexible Configuration Management: Supports online import of subscription links and configuration files to simplify the setup process.
- Automated Tasks: Configure scheduled tasks for automatic updates of configuration files and rules.
- Graphical Dashboard: Support for online installation and use of local Web Dashboards to intuitively manage built-in rules and traffic.
- Multiple Operation Modes: Supports switching between various traffic forwarding modes, including Router mode and Local mode.
- One-Click Maintenance: Built-in online update functionality to keep the script and features up to date.

 :computer: Device Support

ShellCrash is designed to be compatible with the vast majority of network devices based on the Linux kernel:

 Router Devices: Supports various firmwares based on OpenWrt or its derivatives (e.g., Xiaomi, Netgear etc.).
 Linux Servers: Supports devices running standard Linux/GNU distributions (e.g., Debian, CentOS, Armbian, Ubuntu, etc.).
 Third-Party Firmware: Compatible with Padavan (Conservative Mode), Pandora, and ASUS/Merlin firmware.
 Other Devices: Compatible with other devices based on Linux/GNU or Linux/busybox.
 Docker:Compatible with Docker environments (e.g., Synology, PVE, etc.).

 For additional device support, please submit an Issue or provide feedback in the Telegram Group (please include the device model and the output of the uname -a command).

---

 :hammer_and_wrench: Installation Guide

 [!TIP]
 If you encounter connection failures or SSL-related issues, please try switching to an alternative installation mirror.

 Prerequisites
1. Ensure the device has SSH enabled and Root privileges obtained (Linux systems with a GUI can use the terminal directly).
2. Connect to the device using an SSH tool (such as PuTTY, JuiceSSH, or the system's built-in terminal).

 :penguin: Standard Linux Device Installation

 [!IMPORTANT]
 Please perform the installation as the root user.

 Install via wget (jsDelivr CDN source)
sh
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@dev' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install_en.sh \
  && bash /tmp/install.sh \
  && . /etc/profile & /dev/null


 Or install via curl (Author's private source)

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


 :satellite: Router Device Installation

Installation via curl:
 GitHub Source (Recommended for overseas environments or environments with proxy access)
sh
export url='https://raw.githubusercontent.com/juewuy/ShellCrash/dev' \
  && sh -c "$(curl -kfsSl $url/install_en.sh)" \
  && . /etc/profile & /d

Top issues

Latest release

1.9.4-release 1.9.4 2026-02-15
🌟 新增功能
新增访问与控制菜单: 
~新增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
~修复

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON