ShellCrash

Feature Overview：

--

~ Easily manage Mihomo/Singbox core in a shell environment via script
~ Manage directly in shell environment
~ Support online importing of subscription and configuration links
~ Support scheduled tasks and config auto-update
~ Support online installation and use of a local web UI to manage built-in rules
~ Support multiple modes such as routing mode and local mode
~ Support online update

Device Compatibility：

--

~ Compatible with routers based on OpenWrt or OpenWrt-based firmware
~ Compatible with standard Linux systems (e.g., Debian/CentOS/Armbian, etc.)
~ Compatible with Padavan firmware (safe mode), PandoraBox, ASUS/Merlin firmware
~ Compatible with all kinds of Linux-kernel-based custom devices

——————————
~ For more device support, please open an issue or report in the Telegram group (include device name and uname -a result)

FAQ：

ShellCrash FAQ | Juewuy's Blog

Usage：

~ Ensure SSH is enabled and root access is available (Linux desktop users can use terminal)
~ Use SSH tools (e.g. PuTTY, JuiceSSH, terminal, etc.) to connect to the SSH interface or terminal of your router or Linux device

~ Then execute the installation command corresponding to your device in the SSH session and follow the prompts to complete installation

Online Installation：

(If connection fails or you see SSL errors, try different install sources!)

~ Standard Linux installation：

sudo -i
bash
export url='https://fastly.jsdelivr.net/gh/juewuy/ShellCrash@master' && wget -q --no-check-certificate -O /tmp/install.sh $url/install.sh  && bash /tmp/install.sh && source /etc/profile &> /dev/null

or

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

~ Router installation using curl：

# GitHub source (may require proxy)
export url='https://raw.githubusercontent.com/juewuy/ShellCrash/master' && sh -c "$(curl -kfsSl $url/install.sh)" && source /etc/profile &> /dev/null

or

# jsDelivr CDN source
export url='https://fastly.jsdelivr.net/gh/juewuy/ShellCrash@master' && sh -c "$(curl -kfsSl $url/install.sh)" && source /etc/profile &> /dev/null

or

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

~ Router installation using wget：

# GitHub source (may require proxy)
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 && source /etc/profile &> /dev/null

or

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

~ Legacy devices using older wget versions：

# Private HTTP mirror
export url='http://t.jwsc.eu.org' && wget -q -O /tmp/install.sh $url/install.sh  && sh /tmp/install.sh && source /etc/profile &> /dev/null

~ VM/Docker Installation：

Alpine is recommended in VM or Docker environments

Example using Docker：

# IMPORTANT: Run these commands one by one!
# Start Alpine container
docker run -d --name ShellCrash alpine sleep infinity
# Enter container shell
docker exec -it ShellCrash sh
# Install required dependencies
apk add curl 
apk add nftables
# Run install command
export url='https://fastly.jsdelivr.net/gh/juewuy/ShellCrash@master' && sh -c "$(curl -kfsSl $url/install.sh)" && source /etc/profile &> /dev/null

Offline Installation：

If online install fails, refer to：Offline install tutorial | Juewuy's Blog

Using the Script：

After installation, use the command below：

crash       # Launch interactive shell
crash -h    # Show help

Runtime Dependencies：

Most devices/systems already have these installed. You can ignore this if no issue occurs.

curl/wget           REQUIRED    Cannot install/update online or save nodes without both
iptables/nftables   IMPORTANT   Missing these will only allow clean mode
crontab             LOW         Needed for scheduling tasks
net-tools           VERY LOW    Needed for port detection
ubus/iproute-doc    VERY LOW    Needed for detecting local host address

Changelog：

--

Click to view

If you have questions, visit:

• FAQ
• Getting Started Guide
• Or contact Support Bot

Thanks for your understanding and support 🙏