1
2
mirror of https://github.com/vimagick/dockerfiles synced 2024-06-28 17:51:24 +00:00
dockerfiles/fteproxy/README.md
2016-07-11 13:59:26 +08:00

86 lines
2.1 KiB
Markdown

fteproxy
========
[fteproxy][1] provides transport-layer protection to resist keyword filtering,
censorship and discriminatory routing policies.
Its job is to relay datastreams, such as web browsing traffic,
by encoding streams as messages that match a user-specified regular expression.
fteproxy is fast, free, open source, and cross platform.
It works very well with [vimagick/openvpn][2](TCP mode).
In the following example, I will setup a server/client pair to connect www.google.com:80.
## Internet Censorship
### The problem
![before](https://fteproxy.org/images/withoutfte.png)
### The solution
![after](https://fteproxy.org/images/withfte.png)
## Create a docker-compose.yml
```yaml
server:
image: vimagick/fteproxy
ports:
- "80"
environment:
- "MODE=server"
- "SERVER_IP=0.0.0.0"
- "SERVER_PORT=80"
- "PROXY_IP=www.google.com"
- "PROXY_PORT=80"
- "KEY=CB2FBA2BC70490526E749E01BB050F6B555964290DFF58CF24785B4A093F7B18"
client:
image: vimagick/fteproxy
ports:
- "9009:80"
links:
- server
environment:
- "MODE=client"
- "SERVER_IP=server"
- "SERVER_PORT=80"
- "CLIENT_IP=0.0.0.0"
- "CLIENT_PORT=80"
- "KEY=CB2FBA2BC70490526E749E01BB050F6B555964290DFF58CF24785B4A093F7B18"
```
> To generate random key:
> `xxd -u -p -c32 /dev/urandom | head -n1`
## Run fteproxy server/client
```bash
$ docker-compose up -d
Creating fteproxy_server_1...
Creating fteproxy_client_1...
$ docker-compose ps
Name Command State Ports
----------------------------------------------------------------------------------
fteproxy_client_1 /bin/sh -c /fteproxy/ftepr ... Up 0.0.0.0:9009->80/tcp
fteproxy_server_1 /bin/sh -c /fteproxy/ftepr ... Up 0.0.0.0:32768->80/tcp
```
## Test with curl
```html
$ curl http://localhost:9009/
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>302 Moved</TITLE></HEAD><BODY>
<H1>302 Moved</H1>
The document has moved
<A HREF="http://www.google.com/">here</A>.
</BODY></HTML>
```
[1]: https://fteproxy.org/
[2]: https://hub.docker.com/r/vimagick/openvpn/