{"id":49901445,"url":"https://github.com/ahaoboy/crash","last_synced_at":"2026-05-16T06:36:36.598Z","repository":{"id":318900306,"uuid":"1076889113","full_name":"ahaoboy/crash","owner":"ahaoboy","description":"A Rust-based proxy core management tool supporting Clash/Mihomo/SingBox and other proxy cores. This is a Rust port of ShellCrash.","archived":false,"fork":false,"pushed_at":"2026-04-10T02:32:10.000Z","size":263,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-10T04:25:15.982Z","etag":null,"topics":["clash","mihomo","openwrt","rust","shellclash","singbox"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahaoboy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-15T13:37:19.000Z","updated_at":"2026-04-10T02:32:14.000Z","dependencies_parsed_at":null,"dependency_job_id":"a6b7a021-8fe5-4889-8f6f-e5b90d6b0ac4","html_url":"https://github.com/ahaoboy/crash","commit_stats":null,"previous_names":["ahaoboy/crash"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ahaoboy/crash","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaoboy%2Fcrash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaoboy%2Fcrash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaoboy%2Fcrash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaoboy%2Fcrash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahaoboy","download_url":"https://codeload.github.com/ahaoboy/crash/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahaoboy%2Fcrash/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33092721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clash","mihomo","openwrt","rust","shellclash","singbox"],"created_at":"2026-05-16T06:36:35.245Z","updated_at":"2026-05-16T06:36:36.591Z","avatar_url":"https://github.com/ahaoboy.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Crash\n\nA Rust-based proxy core management tool supporting Clash/Mihomo/SingBox and other proxy cores. This is a Rust port of [ShellCrash](https://github.com/juewuy/ShellCrash).\n\n## Features\n\n- 🚀 Cross-platform support (Linux, macOS, Windows, Android)\n- 📦 Automatic download and installation of proxy cores\n- 🔄 Automatic configuration and GeoIP database updates\n- 🌐 Multiple Web UI support (Metacubexd, Yacd)\n- ⏰ Scheduled task support (automatic config and database updates)\n- 🔧 Flexible configuration management\n- 🪞 Multiple GitHub mirror support for accelerated downloads\n\n\u003cdiv style=\"display: flex;\"\u003e\n  \u003cimg src=\"./assets/crash.svg\" alt=\"crash\"/\u003e\n\u003c/div\u003e\n\n## Installation\n\n### Quick Install\n\nInstall with a single command using the installation script:\n\n```bash\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ahaoboy/crash/main/install.sh)\n```\n\n### Using Proxy for Faster Downloads\n\nIf GitHub access is slow, use a mirror:\n\n```bash\n# Using gh-proxy mirror\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ahaoboy/crash/main/install.sh) --proxy gh-proxy\n\ncurl -fsSL https://gh-proxy.com/https://github.com/ahaoboy/crash/blob/main/install.sh | sh -s -- --proxy gh-proxy\ncurl -fsSL https://xget.xi-xu.me/gh/ahaoboy/crash/raw/refs/heads/main/install.sh | sh -s -- --proxy xget\n\n# Using xget mirror\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ahaoboy/crash/main/install.sh) --proxy xget\n\n# Using jsdelivr CDN\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ahaoboy/crash/main/install.sh) --proxy jsdelivr\n```\n\n### crash-assets\n\nhttps://github.com/ahaoboy/crash-assets\n\n\n```bash\ncurl -fsSL https://cdn.jsdelivr.net/gh/ahaoboy/crash-assets@main/install.sh | sh -s -- --proxy jsdelivr\n\ncurl -fsSL https://gh-proxy.com/https://github.com/ahaoboy/crash-assets/blob/main/install.sh | sh -s -- --proxy gh-proxy\n\ncurl -fsSL https://cdn.statically.io/gh/ahaoboy/crash-assets/main/install.sh  | sh -s -- --proxy statically\n\ncurl -fsSL https://xget.xi-xu.me/gh/ahaoboy/crash-assets/raw/refs/heads/main/install.sh  | sh -s -- --proxy xget\n```\n\n### asusrouter\n\n\n```bash\n\ncurl -fsSL https://gh-proxy.com/https://github.com/ahaoboy/crash-assets/blob/main/install.sh | sh -s -- --proxy gh-proxy --dir /jffs\n\n```\n\n### Custom Installation Directory\n\n```bash\nexport EI_DIR=~/.local/bin\nbash \u003c(curl -fsSL https://raw.githubusercontent.com/ahaoboy/crash/main/install.sh)\n```\n\n### Build from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/ahaoboy/crash.git\ncd crash\n\n# Build\ncargo build --release\n\n# Install\ncargo install --path .\n```\n\n## Usage\n\n### Initialize and Install\n\n```bash\n# Install all components (core, ui, geo, task)\ncrash install\n\n# Force reinstallation of all\ncrash install -f\n\n# Install specific components\ncrash install core        # Install proxy core only\ncrash install ui          # Install web UI only\ncrash install geo         # Install GeoIP databases only\ncrash install task        # Install scheduled tasks only\n\n# Force install specific component\ncrash install -f core\n```\n\n### Service Control\n\n```bash\n# Start proxy service\ncrash start\n\n# Stop proxy service\ncrash stop\n\n# Check service status\ncrash status\n```\n\n### Configuration Management (config subcommand)\n\nAll configuration options are now unified under the `config` subcommand:\n\n```bash\n# View all configuration as JSON\ncrash config\n\n# Configuration URL\ncrash config url                # Show current URL\ncrash config url \u003cconfig-url\u003e   # Set configuration URL (support URL or local path)\n\n# GitHub download proxy\ncrash config proxy              # Show current proxy\ncrash config proxy gh-proxy     # Set proxy (direct, gh-proxy, xget, jsdelivr, etc.)\n\n# Web UI type\ncrash config ui                 # Show current UI\ncrash config ui metacubexd      # Set UI (metacubexd, yacd)\n# Web controller host\ncrash config host               # Show current host\ncrash config host :9090         # Set host\n\n# Web controller secret\ncrash config secret             # Show current secret\ncrash config secret \u003csecret\u003e    # Set secret\n\n# Target platform\ncrash config target             # Show current target\ncrash config target x86_64-unknown-linux-musl  # Set target\n\n# Other common targets\ncrash config target aarch64-unknown-linux-musl    # ARM64 Linux (musl)\ncrash config target x86_64-unknown-linux-gnu      # x86_64 Linux (gnu)\ncrash config target aarch64-unknown-linux-gnu     # ARM64 Linux (gnu)\ncrash config target x86_64-pc-windows-msvc        # Windows x64\ncrash config target aarch64-apple-darwin          # macOS Apple Silicon\ncrash config target x86_64-apple-darwin           # macOS Intel\n\n# Maximum runtime (hours, 0 = disabled)\ncrash config max-runtime        # Show current max-runtime\ncrash config max-runtime 24     # Set max-runtime to 24 hours\ncrash config max-runtime 0      # Disable automatic restart\n```\n\n### Scheduled Tasks\n\n```bash\n# Install scheduled tasks (via install subcommand)\ncrash install task\n\n# Manually run scheduled task\ncrash run-task\n\n# Remove scheduled tasks\ncrash remove-task\n```\n\n### Self-Upgrade\n\n```bash\ncrash upgrade\n```\n\n### Shell Completions\n\nGenerate shell completion scripts for auto-completion:\n\n```bash\n# Bash - Add to your shell profile\ncrash completions bash \u003e ~/.local/share/bash-completion/completions/crash\n# Or source directly\nsource \u003c(crash completions bash)\n\n# Fish - Install to fish completions directory\ncrash completions fish \u003e ~/.config/fish/completions/crash.fish\n\n# Zsh\ncrash completions zsh \u003e \"${fpath[1]}/_crash\"\n\n# PowerShell\ncrash completions powershell \u003e\u003e $PROFILE\n\n# Elvish\ncrash completions elvish \u003e ~/.config/elvish/lib/crash.elv\n```\n\n### ei\n\n```bash\n\ncrash ei ahaoboy/coreutils-build --name mktemp\n\ncrash ei ilai-deutel/kibi --proxy gh-proxy\n\n```\n\n## Configuration File\n\nConfiguration file location:\n- Linux/macOS: `~/.crash/config.json`\n- Windows: `%USERPROFILE%\\.crash\\config.json`\n\nExample configuration:\n\n```json\n{\n  \"url\": \"https://example.com/config.yaml\",\n  \"proxy\": \"Direct\",\n  \"web\": {\n    \"ui\": \"Metacubexd\",\n    \"host\": \":9090\",\n    \"secret\": \"your-secret\"\n  }\n}\n```\n\n## Supported Platforms\n\n- Linux (x86_64, aarch64, armv7, i686) - musl/gnu\n- macOS (x86_64, aarch64/Apple Silicon)\n- Windows (x86_64, i686, aarch64)\n- Android (aarch64, armv7, x86_64, i686)\n\n## Scheduled Tasks\n\nAfter installing scheduled tasks, the system will automatically:\n\n- **Every Wednesday at 3:00 AM**: Update configuration files and GeoIP databases\n- **Every 10 minutes**: Check and start proxy service (if not running)\n\n### Linux/macOS (crontab)\n\n```cron\n0 3 * * 3 ~/.crash/crash run-task\n*/10 * * * * ~/.crash/crash start\n```\n\n### Windows (Task Scheduler)\n\n- `CrashRunTask`: Runs every Wednesday at 03:00\n- `CrashStart`: Runs every 10 minutes\n\n## Logging\n\nLog files location:\n- Linux/macOS: `~/.crash/logs/`\n- Windows: `%USERPROFILE%\\.crash\\logs\\`\n\nLogs are automatically rotated, keeping the last 5 files with a maximum size of 10MB each.\n\n## Development\n\n### Building\n\n```bash\n# Development build\ncargo build\n\n# Release build\ncargo build --release\n\n# Run tests\ncargo test\n```\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details\n\n## Acknowledgments\n\n- [ShellCrash](https://github.com/juewuy/ShellCrash) - Original project\n- [Clash](https://github.com/Dreamacro/clash) - Proxy core\n- [Mihomo](https://github.com/MetaCubeX/mihomo) - Clash fork\n- [SingBox](https://github.com/SagerNet/sing-box) - Universal proxy platform\n\n## Contributing\n\nIssues and Pull Requests are welcome!\n\n## Links\n\n- [GitHub Repository](https://github.com/ahaoboy/crash)\n- [Issue Tracker](https://github.com/ahaoboy/crash/issues)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahaoboy%2Fcrash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahaoboy%2Fcrash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahaoboy%2Fcrash/lists"}