Big refactor/rewrite: dynamic proxies, kill/revive proxies, all internal state stored in redis

This commit is contained in:
2019-11-19 19:00:10 -05:00
parent c735f3cc87
commit ce41aee843
17 changed files with 1938 additions and 747 deletions

126
README.md
View File

@@ -11,7 +11,9 @@ and error handling. Built for automated web scraping.
* Seamless exponential backoff retries on timeout or error HTTP codes
* Requires no additional configuration for integration into existing programs
* Configurable per-host behavior
* Proxy routing (Requests can be forced to use a specific proxy with header param)
* Monitoring with InfluxDB
![grafana](grafana.png)
### Typical use case
![user_case](use_case.png)
@@ -19,19 +21,30 @@ and error handling. Built for automated web scraping.
### Usage
```bash
wget https://simon987.net/data/architeuthis/17_architeuthis.tar.gz
tar -xzf 17_architeuthis.tar.gz
wget https://simon987.net/data/architeuthis/16_architeuthis.tar.gz
tar -xzf 16_architeuthis.tar.gz
vim config.json # Configure settings here
./architeuthis
```
You can add proxies using the `/add_proxy` API:
```bash
curl http://localhost:5050?url=<url>&name=<name>
```
Or automatically using Proxybroker:
```bash
python3 import_from_broker.py
```
### Example usage with wget
```bash
export http_proxy="http://localhost:5050"
# --no-check-certificates is necessary for https mitm
# You don't need to specify user-agent if it's already in your config.json
wget -m -np -c --no-check-certificate -R index.html* http://ca.releases.ubuntu.com/
wget -m -np -c --no-check-certificate -R index.html* http http://ca.releases.ubuntu.com/
```
With `"every": "500ms"` and a single proxy, you should see
@@ -49,89 +62,6 @@ level=trace msg=Sleeping wait=433.394361ms
...
```
### Proxy routing
To use routing, enable the `routing` parameter in the configuration file.
**Explicitly choose proxy**
You can force a request to go through a specific proxy by using the `X-Architeuthis-Proxy` header.
When specified and `routing` is
enabled in the config file, the request will use the proxy with the
matching name.
Example:
in `config.json`:
```
...
routing: true,
"proxies": [
{
"name": "p0",
"url": ""
},
{
"name": "p1",
"url": ""
},
...
],
```
This request will *always* be routed through the **p0** proxy:
```bash
curl https://google.ca/ -k -H "X-Architeuthis-Proxy: p0"
```
Invalid/blank values are silently ignored; the request will be routed
according to the usual load balancer rules.
**Hashed routing**
You can also use the `X-Architeuthis-Hash` header to specify an abitrary string.
The string will be hashed and uniformly routed to its corresponding proxy. Unless the number
proxy changes, requests with the same hash value will always be routed to the same proxy.
Example:
`X-Architeuthis-Hash: userOne` is guaranteed to always be routed to the same proxy.
`X-Architeuthis-Hash: userTwo` is also guaranteed to always be routed to the same proxy,
but **not necessarily a proxy different than userOne**.
**Unique string routing**
You can use the `X-Architeuthis-Unique` header to specify a unique string that
will be dynamically associated to a single proxy.
The first time such a request is received, the unique string is bound to a proxy and
will *always* be routed to this proxy. Any other non-empty value for this header will
be routed to another proxy and bound to it.
This means that you cannot use more unique strings than proxies,
doing so will cause the request to drop and will show the message
`No blank proxies to route this request!`.
Reloading the configuration or restarting the `architeuthis` instance will clear the
proxy binds.
Example with configured proxies p0-p3:
```
msg=Listening addr="localhost:5050"
msg="Bound unique param user1 to p3"
msg="Routing request" conns=0 proxy=p3 url="https://google.ca:443/"
msg="Bound unique param user2 to p2"
msg="Routing request" conns=0 proxy=p2 url="https://google.ca:443/"
msg="Bound unique param user3 to p1"
msg="Routing request" conns=0 proxy=p1 url="https://google.ca:443/"
msg="Bound unique param user4 to p0"
msg="Routing request" conns=0 proxy=p0 url="https://google.ca:443/"
msg="No blank proxies to route this request!" unique param=user5
```
The `X-Architeuthis-*` header *will not* be sent to the remote host.
### Hot config reload
```bash
@@ -178,8 +108,6 @@ Actions
| should_retry | Override default retry behavior for http errors (by default it retries on 403,408,429,444,499,>500)
| force_retry | Always retry (Up to retries_hard times)
| dont_retry | Immediately stop retrying
| multiply_every | Multiply the current limiter's 'every' value by `arg` | `1.5`(float)
| set_every | Set the current limiter's 'every' value to `arg` | `10s`(duration)
In the event of a temporary network error, `should_retry` is ignored (it will always retry unless `dont_retry` is set)
@@ -195,18 +123,6 @@ Note that having too many rules for one host might negatively impact performance
"wait": "4s",
"multiplier": 2.5,
"retries": 3,
"retries_hard": 6,
"routing": true,
"proxies": [
{
"name": "squid_P0",
"url": "http://user:pass@p0.exemple.com:8080"
},
{
"name": "privoxy_P1",
"url": "http://p1.exemple.com:8080"
}
],
"hosts": [
{
"host": "*",
@@ -232,14 +148,6 @@ Note that having too many rules for one host might negatively impact performance
"rules": [
{"condition": "status=403", "action": "dont_retry"}
]
},
{
"host": ".www.instagram.com",
"every": "4500ms",
"burst": 3,
"rules": [
{"condition": "body=*please try again in a few minutes*", "action": "multiply_every", "arg": "2"}
]
}
]
}