README.md

Miracle Proxy

Miracle Proxy is a config-based, composable, multi-protocol proxy.

Usage

Getting the binaries

Releases

Build from source

bazel build -c opt net/tools:miracle-proxy

The output binary is located at

bazel-bin/net/tools/miracle-proxy

Run with config

miracle-proxy --config miracle.conf

Config examples

Socks 5 server

handlers {
    "" {
        listen 127.0.0.1:1080
        type socks
    }
}

Shadowsocks server

handlers {
    "" {
        listen [::]:8388
        type shadowsocks
        method 2022-blake3-aes-128-gcm
        password AAAAAAAAAAAAAAAAAAAAAA
    }
}

Socks 5 server, shadowsocks client (ss-local)

handlers {
    "" {
        listen 127.0.0.1:1080
        type socks
        connector proxy
    }
}
connectors {
    proxy {
        type shadowsocks
        server 1.2.3.4:8388
        method 2022-blake3-aes-128-gcm
        password AAAAAAAAAAAAAAAAAAAAAA
    }
}

Use with OpenSSH ProxyCommand

ProxyCommand miracle-proxy --config=miracle.conf --tcp_connect_target="%h:%p" --tcp_connect_with=proxy