From c68cfff22c3317769e7983a7b7258d2904535497 Mon Sep 17 00:00:00 2001 From: Chad Lajiness Date: Mon, 23 Dec 2024 10:14:10 -0600 Subject: [PATCH] slightly updated documentation --- README.md | 24 ++++++++++++------------ docker-compose.yml | 20 ++++++++++---------- 2 files changed, 22 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index e2251a4..7b339f7 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/docker-compose.yml b/docker-compose.yml index 66093b4..2441e14 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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: