Created 6. FlareSolverr MITM Proxy (markdown)

6.-FlareSolverr-MITM-Proxy.md

@@ -0,0 +1,113 @@
+# Using FlareSolverr MITM Proxy
+
+This guide explains how to set up and use the **FlareSolverr MITM Proxy** with the app.
+
+## What this does
+
+The MITM proxy makes it possible to send requests with headers through FlareSolverr.
+
+## Requirements
+
+You need one of the following:
+
+- **Windows:** Docker Desktop
+- **Linux:** Docker and Docker Compose
+
+It is also possible to host the MITM proxy and FlareSolverr on another system and connect to it remotely from the app.
+
+## Docker Compose
+
+Create a `docker-compose.yml` file with the following content:
+
+```yml
+version: "2.1"
+services:
+  flaresolverr-mitm-proxy:
+    image: ghcr.io/zelak312/flaresolverr-mitm-proxy:latest
+    container_name: flaresolverr-mitm-proxy
+    restart: unless-stopped
+#    environment:
+#      - PROXY=http://localhost:8181 # Optional: only use if you want to use an upstream proxy
+#      - PROXY_AUTH=user:pass # Optional: only use if you have an upstream proxy with auth
+    ports:
+      - 8080:8080
+
+  flaresolverr:
+    image: ghcr.io/flaresolverr/flaresolverr:latest
+    container_name: flaresolverr
+    environment:
+      - LOG_LEVEL=${LOG_LEVEL:-info}
+      - LOG_HTML=${LOG_HTML:-false}
+      - CAPTCHA_SOLVER=${CAPTCHA_SOLVER:-none}
+      - TZ=Europe/London
+    ports:
+      - 8191:8191
+    restart: unless-stopped
+```
+## Start the containers
+
+Run the following command in the folder that contains your `docker-compose.yml` file:
+
+```bash
+docker compose up -d
+```
+
+## App setup
+
+After the containers are running, open the app and go to the **FlareSolverr** section in the settings.
+
+### Enable the MITM proxy
+
+- Enable **MITM Proxy**
+- Set the **Host**
+- Set the **Port**
+
+### Example
+
+If the app is running on the same machine as Docker, you would usually use:
+
+- **Host:** `127.0.0.1` or `localhost`
+- **Port:** `8080`
+
+If Docker is running on another device or server, use the IP address or hostname of that system instead.
+
+## Final step
+
+After saving the settings:
+
+1. Restart the app
+2. Try again
+
+It should now use the MITM proxy.
+
+## Notes
+
+- The MITM proxy runs on port `8080`
+- FlareSolverr runs on port `8191`
+- If you want to use an upstream proxy, you can uncomment and configure:
+  - `PROXY`
+  - `PROXY_AUTH`
+
+## Troubleshooting
+
+### It still does not work
+
+Check the following:
+
+- Both containers are running
+- Port `8080` is reachable from the app
+- The host and port in the app are correct
+- You restarted the app after enabling the MITM proxy
+
+### Check container status
+
+```bash
+docker ps
+```
+
+### Check logs
+
+```bash
+docker logs flaresolverr-mitm-proxy
+docker logs flaresolverr
+```