juewuy/shellcrash

★ 12,710ShellAudience · ops devopsComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((shellcrash))
    What It Does
      Manage proxy clients
      Traffic routing rules
      Auto config updates
    Supported Clients
      sing-box
      mihomo
    Supported Devices
      OpenWrt routers
      Debian and Armbian
      Padavan firmware
    Features
      Subscription import
      Scheduled updates
      Web panel access
    Audience
      Home lab users
      Network tinkerers

mindmap root((shellcrash)) What It Does Manage proxy clients Traffic routing rules Auto config updates Supported Clients sing-box mihomo Supported Devices OpenWrt routers Debian and Armbian Padavan firmware Features Subscription import Scheduled updates Web panel access Audience Home lab users Network tinkerers

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Install and manage a proxy client on a home router running OpenWrt to route all network traffic through custom subscription rules.

USE CASE 2

Schedule automatic config file updates on a small Linux device like a single-board computer without a desktop interface.

USE CASE 3

Switch between routing modes and manage rules from a browser-based web panel on Padavan or Pandora firmware routers.

Tech stack

Shellsing-boxmihomoOpenWrt

Getting it running

Difficulty · moderate Time to first run · 30min

Requires a compatible router or Linux device, part of the documentation is written in Chinese.

No license information is described in the explanation, check the repository before use.

In plain English

ShellCrash is a shell script tool for running proxy client programs, specifically sing-box and mihomo, on routers and Linux-based devices. These proxy clients handle network routing and are typically used to redirect traffic through various network rules or tunnels. ShellCrash provides a management layer so you can install, configure, and control those clients from the command line without needing a full desktop environment or graphical interface. The tool supports a range of hardware. It works on routers running OpenWrt firmware, standard Linux machines running distributions like Debian, CentOS, or Armbian, and some specialized router firmware such as Padavan and Pandora. This makes it useful on devices that are not typical computers but still run a Linux-based operating system under the hood, such as home routers or small single-board computers. Features described in the README include importing subscription and configuration links online, scheduling automatic configuration file updates at set intervals, switching between different routing modes and native modes, and managing built-in rules through a local web panel accessible from a browser. The tool also supports online updates to keep itself current without manual reinstallation. The README is short and written partly in Chinese with an English translation. It lists supported features and devices but does not include detailed setup instructions or configuration examples.

Copy-paste prompts

Prompt 1

I have an OpenWrt router and want to install ShellCrash to route traffic through a proxy subscription link. Walk me through the initial install and importing the subscription.

Prompt 2

How do I configure ShellCrash to automatically update its proxy configuration file every 24 hours on my router?

Prompt 3

My device runs Armbian and I want to use ShellCrash to manage mihomo. What are the install steps and how do I switch routing modes?

Prompt 4

How do I access the ShellCrash web panel from my browser to manage routing rules without typing shell commands?

Open on GitHub → Explain another repo

← juewuy on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.