A rule-based tunnel in Go.

Go to file

Dreamacro fcb46e7706 Feature: support vmess tls mode		2018-09-08 19:53:24 +08:00
adapters	Feature: support vmess tls mode	2018-09-08 19:53:24 +08:00
common/vmess	Feature: support vmess tls mode	2018-09-08 19:53:24 +08:00
config	Feature: support vmess tls mode	2018-09-08 19:53:24 +08:00
constant	Feature: ✨ add vmess support	2018-09-06 10:53:29 +08:00
docs	Update: README.md logo and badges	2018-06-23 00:44:28 +08:00
hub	Fix: updateConfig api crash	2018-08-26 22:43:38 +08:00
observable	Improve: delete useless code and code coverage is now 100%	2018-07-12 18:03:02 +08:00
proxy	Improve: HTTP proxy server handler	2018-08-27 00:06:40 +08:00
rules	Improve: lazy load mmdb	2018-08-01 00:18:29 +08:00
tunnel	Fix: close connection when response closed	2018-08-31 21:24:10 +08:00
.gitignore	Init: first commit 🎉	2018-06-10 22:50:03 +08:00
.travis.yml	Update: travis ci with golang 1.11	2018-08-27 00:07:57 +08:00
Dockerfile	Improve: ci config and Dockerfile & update dependencies	2018-06-18 18:24:11 +08:00
Gopkg.lock	Feature: ✨ add vmess support	2018-09-06 10:53:29 +08:00
Gopkg.toml	Feature: ✨ add vmess support	2018-09-06 10:53:29 +08:00
LICENSE	Initial commit	2018-06-10 22:28:14 +08:00
Makefile	Fix: Makefile	2018-08-12 14:06:50 +08:00
README.md	Improve: HTTP proxy server handler	2018-08-27 00:06:40 +08:00
main.go	Update: Initialize the config file outside of the init function	2018-07-31 17:54:16 +08:00

README.md

Clash

A rule based proxy in Go.

Features

HTTP/HTTPS and SOCKS proxy
Surge like configuration
GeoIP rule support
Support for Netfilter TCP redirect

Discussion

Telegram Group

Install

You can build from source:

go get -u -v github.com/Dreamacro/clash

Pre-built binaries are available: release

Requires Go >= 1.10.

Daemon

Unfortunately, there is no native elegant way to implement golang's daemon.

So we can use third-party daemon tools like pm2, supervisor, and so on.

In the case of pm2, we can start the daemon this way:

pm2 start clash

If you have Docker installed, you can run clash directly using docker-compose.

Run clash in docker

Config

Configuration file at $HOME/.config/clash/config.ini

Below is a simple demo configuration file:

[General]
port = 7890
socks-port = 7891

# redir proxy for Linux and macOS
redir-port = 7892

# A RESTful API for clash
external-controller = 127.0.0.1:8080

[Proxy]
# name = ss, server, port, cipher, password
# The types of cipher are consistent with go-shadowsocks2
# support AEAD_AES_128_GCM AEAD_AES_192_GCM AEAD_AES_256_GCM AEAD_CHACHA20_POLY1305 AES-128-CTR AES-192-CTR AES-256-CTR AES-128-CFB AES-192-CFB AES-256-CFB CHACHA20-IETF XCHACHA20
ss1 = ss, server1, port, AEAD_CHACHA20_POLY1305, password
ss2 = ss, server2, port, AEAD_CHACHA20_POLY1305, password

# name = socks5, server, port
socks = socks5, server1, port

[Proxy Group]
# url-test select which proxy will be used by benchmarking speed to a URL.
# name = url-test, [proxies], url, interval(second)
auto = url-test, ss1, ss2, http://www.google.com/generate_204, 300

# select is used for selecting proxy or proxy group
# you can use RESTful API to switch proxy, is recommended for use in GUI.
# name = select, [proxies]
Proxy = select, ss1, ss2, auto

[Rule]
DOMAIN-SUFFIX,google.com,Proxy
DOMAIN-KEYWORD,google,Proxy
DOMAIN-SUFFIX,ad.com,REJECT
GEOIP,CN,DIRECT
FINAL,,Proxy # note: there is two ","