https://github.com/411a/protixy
🌐 ProtonTinyProxy - A minimal and efficient local proxy setup using Docker, powered by ProtonVPN (via OpenVPN) and Tinyproxy.
https://github.com/411a/protixy
docker openvpn openvpn-server ovpn protonvpn proxy-configuration proxy-server
Last synced: about 2 months ago
JSON representation
🌐 ProtonTinyProxy - A minimal and efficient local proxy setup using Docker, powered by ProtonVPN (via OpenVPN) and Tinyproxy.
- Host: GitHub
- URL: https://github.com/411a/protixy
- Owner: 411A
- License: mit
- Created: 2025-05-10T19:16:15.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-07-21T11:16:05.000Z (3 months ago)
- Last Synced: 2025-07-21T12:29:10.151Z (3 months ago)
- Topics: docker, openvpn, openvpn-server, ovpn, protonvpn, proxy-configuration, proxy-server
- Language: Shell
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🐳 OpenVPN Proxy Setup Guide (Docker + ProtonVPN + Tinyproxy)
## 0. Prerequisites
- Install **Docker** on your machine.
## 1. Download ProtonVPN OpenVPN Configs
1. Visit: [ProtonVPN OpenVPN Downloads](https://account.protonvpn.com/downloads#openvpn-configuration-files)
2. Log in to your ProtonVPN account.
3. Choose a protocol (UDP/TCP) and download the `.ovpn` configuration files.
4. Place all `.ovpn` files into the `ovpn_configs` directory.
⚠️ The `jp-free-1.protonvpn.udp.ovpn` file included is a **sample placeholder** and will **not work** for actual connections. Replace it with a real `.ovpn` file from your ProtonVPN account.
5. Inside the `ovpn_configs` directory, open the existing `proton_openvpn_userpass.txt` file and add your ProtonVPN login credentials, You can obtain your username and password from [ProtonVPN's account page](https://account.protonvpn.com/account-password#openvpn):
```
Username
Password
```
## 2. Deploy to VPS
1. Move the project folder to your VPS.
2. SSH into your VPS and `cd` into the project folder.
3. Run the following command to generate and start 1 proxy container:
```bash
chmod +x generate-compose.sh && ./generate-compose.sh 1 && sudo docker compose up -d --build
````
> 📝 **Note:** If you want multiple proxies (e.g., 3), change `1` to `3`. Proxies will start on ports `6101`, `6102`, `6103`, etc.
> ⚠️ ProtonVPN's Free plan allows only 1 connection.
4. Check the OpenVPN connection and proxy status by viewing container logs:
```bash
docker compose logs -f vpn_proxy_1
```
---
## ✅ Test Your Proxy
### 🔹 With `curl` (requires `jq`):
📝 Make sure the `jq` is installed.
```bash
sudo apt install jq -y
```
```bash
curl -s --proxy http://127.0.0.1:6101 https://ipinfo.io/json | jq -r '"IP: \(.ip) 🔸 City: \(.city) 🔸 Region: \(.region) 🔸 Country: \(.country) 🔸 TimeZone: \(.timezone)"'
```
### 🔹 With Python:
```bash
python3 -c "import requests; info = requests.get('https://ipinfo.io/json', proxies={'http':'http://127.0.0.1:6101','https':'http://127.0.0.1:6101'}).json(); print(f\"IP: {info['ip']} 🔸 City: {info['city']} 🔸 Region: {info['region']} 🔸 Country: {info['country']} 🔸 TimeZone: {info['timezone']}\")"
```