Skip to content
Snippets Groups Projects
README.md 2.92 KiB
Newer Older
Mystical-C's avatar
Mystical-C committed
## Clash Fork Project

Forked from Dreamacro/clash project

Mystical-C's avatar
Mystical-C committed
<h1 align="center">
Mystical-C's avatar
Mystical-C committed
  <img src="https://github.com/MysticalDevil/clash/raw/master/docs/logo.png" alt="Clash" width="200">
Mystical-C's avatar
Mystical-C committed
  <br>Clash<br>
</h1>

<h4 align="center">A rule-based tunnel in Go.</h4>

<p align="center">
Mystical-C's avatar
Mystical-C committed
  <a href="https://github.com/MysticalDevil/clash/actions">
Mystical-C's avatar
Mystical-C committed
    <img src="https://img.shields.io/github/workflow/status/Dreamacro/clash/Go?style=flat-square" alt="Github Actions">
  </a>
Mystical-C's avatar
Mystical-C committed
  <a href="https://goreportcard.com/report/github.com/MysticalDevil/clash">
    <img src="https://goreportcard.com/badge/github.com/MysticalDevil/clash?style=flat-square">
Mystical-C's avatar
Mystical-C committed
  </a>
  <img src="https://img.shields.io/github/go-mod/go-version/Dreamacro/clash?style=flat-square">
Mystical-C's avatar
Mystical-C committed
  <a href="https://github.com/MysticalDevil/clash/releases">
Mystical-C's avatar
Mystical-C committed
    <img src="https://img.shields.io/github/release/Dreamacro/clash/all.svg?style=flat-square">
  </a>
Mystical-C's avatar
Mystical-C committed
  <a href="https://github.com/MysticalDevil/clash/releases/tag/premium">
Mystical-C's avatar
Mystical-C committed
    <img src="https://img.shields.io/badge/release-Premium-00b4f0?style=flat-square">
  </a>
</p>

## Features

- Local HTTP/HTTPS/SOCKS server with authentication support
- VMess, Shadowsocks, Trojan, Snell protocol support for remote connections
- Built-in DNS server that aims to minimize DNS pollution attack impact, supports DoH/DoT upstream and fake IP.
- Rules based off domains, GEOIP, IPCIDR or Process to forward packets to different nodes
- Remote groups allow users to implement powerful rules. Supports automatic fallback, load balancing or auto select node based off latency
- Remote providers, allowing users to get node lists remotely instead of hardcoding in config
- Netfilter TCP redirecting. Deploy Clash on your Internet gateway with `iptables`.
- Comprehensive HTTP RESTful API controller

## Premium Features

Mystical-C's avatar
Mystical-C committed
- TUN mode on macOS, Linux and Windows. [Doc](https://github.com/MysticalDevil/clash/wiki/premium-core-features#tun-device)
- Match your tunnel by [Script](https://github.com/MysticalDevil/clash/wiki/premium-core-features#script)
- [Rule Provider](https://github.com/MysticalDevil/clash/wiki/premium-core-features#rule-providers)
Mystical-C's avatar
Mystical-C committed

## Getting Started
Mystical-C's avatar
Mystical-C committed
Documentations are now moved to [GitHub Wiki](https://github.com/MysticalDevil/clash/wiki).
Mystical-C's avatar
Mystical-C committed

## Premium Release
Mystical-C's avatar
Mystical-C committed
[Release](https://github.com/MysticalDevil/clash/releases/tag/premium)
Mystical-C's avatar
Mystical-C committed

## Development
Mystical-C's avatar
Mystical-C committed
If you want to build an application that uses clash as a library, check out the the [GitHub Wiki](https://github.com/MysticalDevil/clash/wiki/use-clash-as-a-library)
Mystical-C's avatar
Mystical-C committed

## Credits

* [riobard/go-shadowsocks2](https://github.com/riobard/go-shadowsocks2)
* [v2ray/v2ray-core](https://github.com/v2ray/v2ray-core)
* [WireGuard/wireguard-go](https://github.com/WireGuard/wireguard-go)

## License

This software is released under the GPL-3.0 license.

[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FDreamacro%2Fclash.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FDreamacro%2Fclash?ref=badge_large)