ShellCrash is a shell script tool for deploying and managing mihomo and sing-box proxy kernels in Linux environments.
The tool addresses the need to run proxy clients on resource-constrained or headless devices where traditional GUI applications are impractical. It wraps the mihomo and sing-box cores with shell scripting to provide deployment automation, configuration management, and operational control through a command-line interface. The approach centers on making kernel installation, updates, and switching straightforward through automated scripts while supporting online subscription imports and rule management.
ShellCrash suits users running Linux-based routers, servers, or embedded devices who need transparent proxy functionality without graphical interfaces. It works across OpenWrt derivatives, standard Linux distributions, Padavan, and Docker environments. The tool distinguishes itself through multi-kernel support allowing users to switch between mihomo and sing-box, scheduled task automation for configuration updates, web dashboard integration for traffic visualization, and multiple forwarding modes including Router and Local modes. Installation requires SSH access and root privileges, with the project providing multiple mirror sources to handle connectivity constraints in different regions.
Development activity shows consistent engagement with user-reported issues and device compatibility requests, with the maintainer actively soliciting feedback through issue tracking and community channels for expanding device support. The project maintains multiple installation mirrors and sources to accommodate different network environments and connectivity scenarios. Regular updates are delivered through built-in online update functionality, keeping both the script and its features current without requiring manual reinstallation.
