proxy-twister 1.0.1

A flexible HTTP proxy switcher that routes traffic through different proxies (SOCKS5 or HTTP) based on target host patterns.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143

# Proxy Twister

A flexible HTTP proxy switcher that intelligently routes traffic through different proxies (SOCKS5 or HTTP) based on target host patterns.

## Features

- Route traffic through different proxies based on domain/IP patterns
- Support for both SOCKS5 and HTTP proxies
- Direct connection option for local or trusted networks
- Pattern matching with wildcards for flexible routing rules
- Handles both HTTP and HTTPS (via CONNECT) connections

## Installation

### From Source

1. Ensure you have Rust and Cargo installed (<https://rustup.rs/>)
2. Clone this repository:

   ```shell
   git clone https://github.com/mlesin/proxy-twister.git
   cd proxy-twister
   ```

3. Build the project:

   ```shell
   cargo build --release
   ```

4. The binary will be available at `target/release/proxy-twister`

## Configuration

Create a configuration file in JSON format. Here's an example:

```json
{
    "switch": {
        "default": "regular",
        "rules": [
            {
                "pattern": "10.*",
                "profile": "direct"
            },
            {
                "pattern": "127.0.0.1",
                "profile": "direct"
            },
            {
                "pattern": "*.discord.gg",
                "profile": "tor"
            },
            {
                "pattern": "*.discord.com",
                "profile": "tor"
            },
            {
                "pattern": "*.medium.com",
                "profile": "monkey"
            }
        ]
    },
    "profiles": {
        "direct": {
            "scheme": "direct"
        },
        "regular": {
            "scheme": "http",
            "port": 1080,
            "host": "localhost"
        },
        "tor": {
            "scheme": "socks5",
            "host": "localhost",
            "port": 9150
        },
        "monkey": {
            "scheme": "socks5",
            "host": "localhost",
            "port": 8884
        }
    }
}
```

### Configuration Explanation

- **switch**: Contains the routing rules
  - **default**: The default profile to use when no pattern matches
  - **rules**: List of pattern-matching rules to determine which proxy to use
    - **pattern**: A domain/IP pattern (supports wildcards)
    - **profile**: The profile to use when the pattern matches

- **profiles**: Defines the available proxy configurations
  - Each profile has a unique name and configuration:
    - **direct**: No proxy, direct connection
    - **http**: HTTP proxy with host and port
    - **socks5**: SOCKS5 proxy with host and port

## Usage

Run the program with:

```shell
proxy-twister --config config.json [--address 127.0.0.1] [--port 1080]
```

Options:

- `--config`: Path to the configuration file (required)
- `--address`: Address to listen on (default: 127.0.0.1)
- `--port`: Port to listen on (default: 1080)

Then configure your applications to use the proxy at the address and port you specified.

## Pattern Matching

The pattern matching supports:

- Exact matches: `example.com`
- Wildcard at beginning: `*.example.com` (matches `sub.example.com`, `example.com`)
- IP prefix matching: `192.168.*` (matches any IP starting with 192.168)

## Examples

### Route specific sites through Tor

```json
{
    "pattern": "*.onion",
    "profile": "tor"
}
```

### Use direct connection for local networks

```json
{
    "pattern": "192.168.*",
    "profile": "direct"
}
```