Skip to content

Commit

Permalink
slightly updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
clajiness committed Dec 23, 2024
1 parent 5dfb842 commit c68cfff
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 22 deletions.
24 changes: 12 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,31 +5,31 @@ A tool for keeping ProtonVPN, OPNsense, and qBittorrent forwarded ports in sync.
> This is beta software. I'm not responsible for any issues you may encounter.
## Purpose
This tool helps automate port forwarding from ProtonVPN to qBittorrent via OPNsense. The tool polls ProtonVPN for the given forwarded port, checks the port set in OPNsense and qBittorrent, and updates it if necessary. You can ignore qBittorrent by using the `QBIT_SKIP` environment variable.
This tool helps automate port forwarding from ProtonVPN to qBittorrent via OPNsense. The tool polls ProtonVPN for the given forwarded port, checks the port set in OPNsense and qBittorrent, and updates it if necessary.

Version v0.5 and later allows you to skip qBittorrent and just sync Proton's forwarded port to OPNsense.
You can ignore qBittorrent by using the `QBIT_SKIP` environment variable.

## Installation
I recommend using the provided Docker Compose file to simplify the set up of qbop.

The Docker container is available here: https://github.com/clajiness/qbop/pkgs/container/qbop

#### Requirements
### Requirements
* Docker Engine - https://docs.docker.com/engine/install/
* OPNsense - This is the tutorial I used to set up selective routing to ProtonVPN. https://docs.opnsense.org/manual/how-tos/wireguard-selective-routing.html
* qBittorrent
* ProtonVPN subscription

#### Config
### Config
The given environment variables are required.

1. `LOOP_FREQ:` This value determines how often the script runs. The default value is 45 seconds. This probably shouldn't be changed.
2. `PROTON_GATEWAY:` The IP address of your ProtonVPN gateway. For example, `10.2.0.1`.
3. `OPN_INTERFACE_ADDR:` The IP address of your OPNsense interface. For example, `https://10.1.1.1`.
4. `OPN_API_KEY:` Your OPNsense API key - https://docs.opnsense.org/development/how-tos/api.html
5. `OPN_API_SECRET:` Your OPNsense API secret
2. `PROTON_GATEWAY:` Usually 10.2.0.1. Do not use http(s):// or a trailing slash.
3. `OPN_INTERFACE_ADDR:` OPNsense Interface Address. Requires http(s):// and no trailing slash.
4. `OPN_API_KEY:` OPNsense API Key - https://docs.opnsense.org/development/how-tos/api.html
5. `OPN_API_SECRET:` OPNsense API Secret
6. `OPN_PROTON_ALIAS_NAME:` The firewall alias that you use for ProtonVPN's forwarded port. For example, `proton_vpn_forwarded_port`.
7. `QBIT_SKIP:` [true/false] Skip qBittorrent. If true, subsequent qBit environment variables are not necessary.
8. `QBIT_ADDR:` The IP address of your qBittorrent app. For example, `http://10.1.1.100:8080`.
9. `QBIT_USER:` Your qBittorrent username
10. `QBIT_PASS:` Your qBittorrent password
7. `QBIT_SKIP:` [true/false] Skip qBittorrent. If true, subsequent qBit environment variables are not required.
8. `QBIT_ADDR:` The IP address of your qBittorrent app. Requires http(s):// and no trailing slash.
9. `QBIT_USER:` qBittorrent username
10. `QBIT_PASS:` qBittorrent password
20 changes: 10 additions & 10 deletions docker-compose.yml
Original file line number Diff line number Diff line change
Expand Up @@ -8,25 +8,25 @@ services:
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
environment:
# This value determines how often the script runs. The default value is 45 seconds.
# This value determines how often the script runs. The default value is 45 seconds.
- LOOP_FREQ=
# Usually 10.2.0.1. Do not use http(s):// or a trailing slash.
# Usually 10.2.0.1. Do not use http(s):// or a trailing slash.
- PROTON_GATEWAY=
# OPNsense Interface Address. Requires http(s):// and no trailing slash.
# OPNsense Interface Address. Requires http(s):// and no trailing slash.
- OPN_INTERFACE_ADDR=
# OPNsense API Key
# OPNsense API Key
- OPN_API_KEY=
# OPNsense API Secret
# OPNsense API Secret
- OPN_API_SECRET=
# The firewall alias that you use for ProtonVPN's forwarded port
# The firewall alias that you use for ProtonVPN's forwarded port
- OPN_PROTON_ALIAS_NAME=
# [true/false] Skip qBittorrent. If true, subsequent qBit environment variables are not necessary.
# [true/false] Skip qBittorrent. If true, subsequent qBit environment variables are not required.
- QBIT_SKIP=
# The IP address of your qBittorrent app. Requires http(s):// and no trailing slash.
# The IP address of your qBittorrent app. Requires http(s):// and no trailing slash.
- QBIT_ADDR=
# Your qBittorrent username
# qBittorrent username
- QBIT_USER=
# Your qBittorrent password
# qBittorrent password
- QBIT_PASS=

volumes:
Expand Down

0 comments on commit c68cfff

Please sign in to comment.