Skip to content
Get packs

clashctl

A Linux shell tool that installs and manages the mihomo/Clash proxy core from the terminal.

GitHub Download clash
Stars
15.1k
Forks
1.7k
Licence
MIT
Language
Shell
Last update
9 days ago
Type
CLI

What it is

clashctl is a set of shell scripts for Linux that installs the mihomo (Clash) proxy core and a web dashboard, then lets you turn the proxy on or off for your current terminal with simple commands. It also handles subscription links, node switching, TUN mode, and config overrides. People use it to avoid manually setting up and maintaining Clash on servers or desktop Linux.

  • Turn the proxy on for the current terminal with clashctl on and test connectivity with curl
  • Add a subscription link and switch between nodes
  • Check core and proxy status and view logs with clashctl status and clashctl log
  • Enable TUN mode or apply Mixin configuration overrides
  • Upgrade the mihomo core or update clashctl itself

Great for

  • Linux users comfortable with the terminal who want a command-driven Clash setup
  • Users managing multiple subscription links and switching nodes from the shell
  • Server or container users who need a proxy for command-line tools
  • People who want a web dashboard without manual core configuration

Not ideal for

  • Windows or macOS users, since the README lists Linux as the platform
  • Users who prefer a graphical desktop client
  • Beginners with no shell experience, because setup runs a remote install script and uses the command line throughout
  • Users who need a proxy service provided by the project itself; the README only mentions third-party providers as options
Step-by-step guide: how to use clashctlInstall, first run, examples, tips and FAQs
clashctl vs mihomo

How to get it

  1. 1

    See the README

    You'll need: Linux with a shell (Bash, Zsh, or Fish) · curl

    Install clashctl (README one-liner, uses a download accelerator proxy)

    GH_PROXY=https://gh-proxy.org/ curl -fsSL "${GH_PROXY}https://raw.githubusercontent.com/nelvko/clashctl/HEAD/install.sh" | \ bash -s -- --gh-proxy "$GH_PROXY"
  2. 2

    Run it

    • Install using the one-liner from the README
    • Optionally add a subscription with clashctl sub add --use "<subscription link>"
    • Run clashctl on to start the core and enable the proxy in the current terminal
    • Test with curl -I https://www.google.com
  3. 3

    Get the most out of it

    • Use clashctl status to see the core state and proxy addresses
    • Use the web dashboard address from clashctl ui to manage the core
    • Apply Mixin configuration to customize the generated config
    • Enable TUN mode with clashctl tun for system-wide traffic, per the feature list
    • Keep the core current with clashctl upgrade and clashctl update

Downloads

Source code (.zip)master branch · straight from GitHubRelease clash4 files incl. clash-linux-amd64-2023.08.17.gz

Strengths

  • Installs the core, dashboard, and dependencies in one command according to the README
  • Supports systemd and OpenRC and offers Bash, Zsh, and Fish integration
  • Includes a clear command list and uninstall instructions that keep backups

Trade-offs

  • Linux only, and the README gives little detail on which distributions were tested
  • Relies on third-party download proxies and a README that includes promotional sponsor links, so review before trusting
  • Detailed usage is kept in an external wiki, so the README alone is limited

How it compares

ProjectStarsTypeLevelUpdatedBest for
clashctl (this)15.1kCLIintermediate9 days agoLinux users comfortable with the terminal who want a command-driven Clash setup
mihomo35.4kLibraryintermediate7 days agoDevelopers building Honkai: Star Rail fan tools or dashboards
sherlock95.4kCLIintermediate4 days agoSecurity researchers doing authorized open-source intelligence work
OpenClash28kAppadvanced4 days agoPeople who already run OpenWrt on a router and want rule-based proxy routing for the whole network
hackingtool81.6kDev toolintermediate6 days agoPenetration testers who want a single launcher for many common tools
PowerShell56kCLIbeginner4 days agoDevelopers who script or automate tasks across Windows, Linux, and macOS

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.