MetaCubeX/ClashX.MetaFork
ClashX.Meta
ClashX.Meta is a macOS desktop application that provides a graphical interface for managing the Clash proxy engine. It enables rule-based traffic routing using domain, IP, and GeoIP rules, and allows users to manage proxy configurations and toggle system proxy settings directly from the menu bar. The application serves as a full-featured client for controlling the core proxy daemon on macOS.
The project includes a YAML-based configuration manager with built-in schema validation, ensuring proxy profiles are valid before activation. It also provides a TUN virtual network stack that captures all device traffic and processes packets in user space, along with process-level traffic attribution that logs which applications generate network connections. The system proxy hook modifies macOS network preferences programmatically to enable or disable proxying.
Users can import remote proxy configuration files, switch between routing modes (global, direct, or rule-based), configure applications to bypass the proxy, and view process-level logs for troubleshooting. The project also supports building from source, running tests, and verifying binary authenticity. ClashX.Meta is open-source and can be built using the standard Go toolchain.
Features
- Clash Clients - A macOS desktop application that controls the Clash proxy engine with a graphical interface.
- Configuration File Validators - Validates YAML proxy configuration files against a JSON schema before activating them.
- Configuration File Loading - Loads proxy configuration files and supports hot reloading to apply changes without restart.
- Configuration Profiles - Manages and switches between multiple proxy configuration profiles stored as YAML files.
- System Proxy Configurators - Enables or disables the system-wide proxy and configures applications to bypass proxying.
- Traffic Routing Proxies - Routes network traffic through HTTP, SOCKS, and other proxies with GeoIP-based rules.
- Geographic Traffic Routing Rules - Routes network traffic through proxies based on GeoIP rules and custom rule sets.
- Clash Configuration Managers - Manages Clash proxy configuration files, imports remote config URLs, and switches between profiles.
- Mode Switchers - Switches between global, direct, and rule-based proxy modes to control how traffic is routed.
- Proxy Configurations - Switches between custom proxy configuration files and imports remote configs by URL.
- Routing Rule Engines - Matches traffic against domain, IP, and GeoIP rules to determine whether to use a proxy chain or direct connection.
- Rule-Based - Provides rule-based traffic routing using domain, IP, and GeoIP rules to direct packets through proxy chains or direct connections.
- Virtual Network Interfaces - Captures all device traffic through a virtual network interface and processes it in user space for proxy routing.
- System Proxy Hooks - Modifies macOS network preferences programmatically to enable or disable system-wide proxy routing.
- Proxy Configuration Managers - Validates and loads YAML proxy profiles into the core for rule-based routing, supporting config switching and remote imports.
- Rule-Based Routing Systems - Routes network traffic through proxies or direct connections based on domain, IP, and GeoIP rules.
- Traffic Routing Modes - Switches between global, direct, and rule-based proxy routing modes to control traffic behavior.
- Unix Domain Socket IPC - Communicates with the Go proxy daemon via JSON commands over a local Unix socket.
- Bypass Configurations - Allows users to specify applications that should bypass the proxy and connect directly.
- System Capability Toggles - Enables or disables the system proxy with a single toggle to control internet traffic routing.
- Remote Subscription Imports - Imports proxy configuration files from remote URLs and switches between multiple custom configurations.
- Process-Level Traffic Logs - Enables logging that identifies which application processes send traffic through the proxy.
- JSON-Based IPC Controllers - Exchanges commands between the graphical interface and the proxy daemon via JSON over a local socket.
- Proxy Clients - Feature-rich proxy client for macOS with core support.
