ShellCrash README

The project's README from github.com/juewuy/ShellCrash. As one markdown file: README.md.

ShellCrash

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

简体中文 | English

:rocket: Core Features

:computer: Device Support

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

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)

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)

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)

export url='https://raw.githubusercontent.com/juewuy/ShellCrash/dev' \
  && sh -c "$(curl -kfsSl $url/install_en.sh)" \
  && . /etc/profile &> /dev/null

Or jsDelivr CDN source

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

Or Author's private source

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

Installation via wget:

GitHub Source (Recommended for overseas environments or environments with proxy access)

export url='https://raw.githubusercontent.com/juewuy/ShellCrash/dev' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install_en.sh \
  && sh /tmp/install.sh \
  && . /etc/profile &> /dev/null

Or jsDelivr CDN source

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

:pager: Installation for Legacy Devices with Older wget Versions

Author's private HTTP beta source

export url='http://t.jwsc.eu.org' \
  && wget -q -O /tmp/install.sh $url/install_en.sh \
  && sh /tmp/install.sh \
  && . /etc/profile &> /dev/null

:cloud: Virtual Machines

# Install necessary dependencies
apk add --no-cache wget openrc ca-certificates tzdata nftables iproute2 dcron
# Execute installation command
export url='https://testingcf.jsdelivr.net/gh/juewuy/ShellCrash@dev' \
  && wget -q --no-check-certificate -O /tmp/install.sh $url/install_en.sh \
  && sh /tmp/install.sh \
  && . /etc/profile &> /dev/null

:whale: Docker

Please visit the official Docker image:

:package: Local Installation

If online installation is not possible, please follow the guide for local installation:

:book: Usage Instructions

After installation, enter the following commands in the terminal to launch the management interface:

crash        # Launch the interactive script menu
crash -h     # View the list of command help

Running Dependencies

Component Necessity Description
curl / wget Mandatory Required for node saving, online installation, and update operations.
iptables / nftables Critical Without these, the script can only run in Pure Mode.
crontab Low Required for scheduled tasks; otherwise, they will not function.
net-tools Very Low Used for automatic port occupancy detection.
ubus / iproute-doc Very Low Used for automatically obtaining the local Host address.

:scroll: License

This project is licensed under the GNU General Public License v3.0.

ShellCrash (juewuy/ShellCrash)

Searching Database…

13.6K ·GitHub
ShellCrash
Что это такое?ShellCrash — это Shell-скрипт для развёртывания и управления прокси-ядрами mihomo/sing-box на устройствах с Linux — роутерах, серверах, Docker — через интерфейс управления в терминале.
Так ShellCrash — это сам прокси или менеджер для него?Это менеджер, а не сам прокси-движок: скрипт устанавливает, переключает и обслуживает ядро mihomo или sing-box, которое непосредственно занимается перенаправлением трафика.
Как установить его на свой роутер или сервер?Зайдите по SSH под root и выполните однострочный установщик: wget с jsDelivr CDN или curl с источника автора; на роутерах можно тянуть с GitHub, jsDelivr или приватного зеркала автора.
Что должно быть заранее установлено на моём устройстве?Обязательны curl или wget, а iptables или nftables критически важны — без них скрипт сможет работать только в режиме Pure Mode. net-tools и ubus — необязательные приятные дополнения.
На чём обычно спотыкаются при установке?Ошибки соединения или SSL при установке — настолько обычное дело, что в README прямо сказано сменить зеркало; на устройствах с очень старыми версиями wget нужно использовать вместо этого приватный HTTP beta-источник автора.
На каких устройствах он работает — только на роутерах?На любом устройстве с ядром Linux: роутерах в духе OpenWrt (Xiaomi, Netgear), серверах с Debian/CentOS/Armbian/Ubuntu, прошивках Padavan, Pandora и ASUS/Merlin, системах на busybox или в Docker на NAS вроде Synology.
Как управлять им в повседневной работе?После установки одна команда в терминале открывает интерфейс управления. Также можно установить локальную веб-панель, которая наглядно показывает встроенные правила и трафик.
Он сам будет обновлять мои конфиги подписок?Да — по расписанию можно автоматически обновлять файлы конфигурации и правила (нужен crontab), а сам скрипт имеет встроенное онлайн-самообновление.
Можно ли установить его на устройство без доступа в интернет?Да — если онлайн-установка невозможна, в блоге автора есть отдельная инструкция по локальной установке вручную.
Какие режимы перенаправления трафика он поддерживает?Несколько переключаемых, в том числе режим Router (трафик проходит через устройство, например роутер, обслуживающий сеть) и режим Local (только само устройство).
What are similar projects?smartdns, 3X-UI_KIT, TikTokDownloader, brook, acme.sh, reinstall, haoel.github.io, vk-turn-proxy
Which topics is it in?alpine-linux, openwrt, webui, shell, proxy, utility, gplv3, networking, free, terminal, chinese, automation
Creator
juewuy
Size
5.1 GB
Stars
13.6K
Updated
CommitAug 27Release1.9.4Feb 15
Age
6y
Commits · 90 Days