# juewuy/shellcrash

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/juewuy-shellcrash).**

12,934 stars · 1,825 forks · Shell · GPL-3.0

## Links

- GitHub: https://github.com/juewuy/ShellCrash
- awesome-repositories: https://awesome-repositories.com/repository/juewuy-shellcrash.md

## Description

ShellCrash is a shell-based network proxy manager and DNS and routing controller. It functions as a transparent proxy gateway that intercepts local traffic and DNS requests to route data through a proxy server.

The system manages the deployment and upgrading of proxy binaries, such as sing-box and mihomo, within a shell environment. It includes a web-based management interface and traffic dashboard for visualizing network activity and modifying routing rules.

The project provides capabilities for network traffic routing, including UDP proxy support, local traffic bypasses for domestic IP addresses, and side-gateway configuration to serve other devices on a local network. It also features automated configuration updates via subscription links and scheduled background tasks for refreshing network rules and recovering firewall settings.

## Tags

### Networking & Communication

- [Transparent Proxying](https://awesome-repositories.com/f/networking-communication/transparent-proxying.md) — Intercepts and redirects system-level network traffic and DNS requests through a proxy kernel without client-side configuration.
- [Domestic Traffic Classifiers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/domestic-traffic-classifiers.md) — Includes a routing mechanism to identify and bypass domestic IP traffic to reduce network latency. ([source](https://juewuy.github.io/chang-jian-wen-ti/))
- [Geo-IP Routing Configurations](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/network-routing-traffic-management/network-traffic-management/domestic-traffic-classifiers/geo-ip-routing-configurations.md) — Routes domestic traffic directly and foreign traffic through proxies using Geo-IP based routing configurations.
- [Network Proxy Management](https://awesome-repositories.com/f/networking-communication/network-proxy-management.md) — Offers a command-line deployment system for configuring and controlling internet traffic routing through proxy servers.
- [Proxy Installers](https://awesome-repositories.com/f/networking-communication/proxy-installers.md) — Provides mechanisms for deploying and upgrading network proxy binaries via manual uploads or automated scripts. ([source](https://juewuy.github.io/bdaz))
- [Proxy Managers](https://awesome-repositories.com/f/networking-communication/proxy-managers.md) — Manages the installation and operation of network proxy kernels directly through a shell-based management interface. ([source](https://github.com/juewuy/shellcrash#readme))
- [Binary Lifecycle Management](https://awesome-repositories.com/f/networking-communication/proxy-servers/sing-box-configurations/binary-lifecycle-management.md) — Installs and manages sing-box and mihomo binaries in a shell environment to control network tunnels.
- [Traffic Routing Rules](https://awesome-repositories.com/f/networking-communication/traffic-routing-rules.md) — Defines routing rules to determine which traffic is accessed directly and which is proxied to optimize latency.
- [Transparent Network Proxies](https://awesome-repositories.com/f/networking-communication/transparent-network-proxies.md) — Functions as a network tool that intercepts local traffic and DNS requests at the layer level to route them via a proxy.
- [Gateway Configuration](https://awesome-repositories.com/f/networking-communication/gateway-configuration.md) — Allows the device to be configured as a network gateway and DNS server for other local devices. ([source](https://juewuy.github.io/chang-jian-wen-ti/))
- [Local Proxy Gateways](https://awesome-repositories.com/f/networking-communication/local-proxy-gateways.md) — Configures the device as a local proxy gateway and DNS server to provide proxy services to other network devices.
- [Traffic Routing Dashboards](https://awesome-repositories.com/f/networking-communication/network-traffic-routing/traffic-routing-dashboards.md) — Provides a web-based dashboard for visualizing network traffic flows and managing proxy routing configurations. ([source](https://github.com/juewuy/shellcrash#readme))
- [Management Interfaces](https://awesome-repositories.com/f/networking-communication/proxy-servers/sing-box-configurations/management-interfaces.md) — Provides a web-based graphical interface for controlling proxy engine settings and routing behavior for sing-box.
- [Proxy Subscription Updates](https://awesome-repositories.com/f/networking-communication/proxy-subscription-updates.md) — Automatically synchronizes and refreshes proxy server lists from remote subscription URLs on a schedule.
- [Proxy Mode Switches](https://awesome-repositories.com/f/networking-communication/traffic-proxying/proxy-traffic-management/proxy-mode-switches.md) — Provides controls to switch between network-wide transparent proxying and device-specific proxy configurations. ([source](https://github.com/juewuy/shellcrash#readme))
- [UDP Proxies](https://awesome-repositories.com/f/networking-communication/udp-proxies.md) — Supports the proxying of User Datagram Protocol traffic to enable gaming and other UDP-based application connectivity. ([source](https://juewuy.github.io/chang-jian-wen-ti/))

### DevOps & Infrastructure

- [Kernel Deployment Tools](https://awesome-repositories.com/f/devops-infrastructure/deployment-management-strategies/execution-platforms-and-targets/deployment-infrastructure/kernel-deployment-tools.md) — Provides tools to load specialized proxy kernel binaries onto target hardware to enable smart routing policies. ([source](https://juewuy.github.io/chang-jian-wen-ti/))
- [Scripted Binary Deployments](https://awesome-repositories.com/f/devops-infrastructure/deployment-targets/scripted-binary-deployments.md) — Deploys and manages network proxy kernels via automated shell scripts across diverse devices.

### Operating Systems & Systems Programming

- [Proxy Kernels](https://awesome-repositories.com/f/operating-systems-systems-programming/proxy-kernels.md) — Provides the ability to replace system binaries with specialized proxy kernels for advanced routing.

### System Administration & Monitoring

- [Traffic Routing Controllers](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/linux-system-administration/networking/proxy-management-systems/traffic-routing-controllers.md) — Provides a control plane for managing network-wide proxying, UDP traffic, and geographic routing rules.
- [Web-Based Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/web-based-dashboards.md) — Ships a web-based dashboard for visualizing real-time network traffic and modifying proxy routing rules.

### Development Tools & Productivity

- [Background Task Schedulers](https://awesome-repositories.com/f/development-tools-productivity/background-task-schedulers.md) — Utilizes a background task scheduler to refresh network configuration files and routing rules on a fixed timetable. ([source](https://github.com/juewuy/shellcrash#readme))

### Software Engineering & Architecture

- [Subscription Link Imports](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-formats-and-schemas/yaml-configuration-schemas/proxy-configuration-managers/subscription-link-imports.md) — Automates rule setup by importing proxy server configurations from online subscription links. ([source](https://github.com/juewuy/shellcrash#readme))
