Skip to content

Enable third-party app access to qBittorrent API#5299

Open
nmfretz wants to merge 1 commit intomasterfrom
qbittorrent-reverse-proxy-auth
Open

Enable third-party app access to qBittorrent API#5299
nmfretz wants to merge 1 commit intomasterfrom
qbittorrent-reverse-proxy-auth

Conversation

@nmfretz
Copy link
Copy Markdown
Member

@nmfretz nmfretz commented Apr 7, 2026

Summary

  • Enables qBittorrent's reverse proxy support so it reads the real client IP from X-Forwarded-For and checks it against AuthSubnetWhitelist instead of the direct connection IP
  • Adds PROXY_AUTH_WHITELIST: "/api/*" so third-party apps can reach the API without Umbrel's proxy auth
  • Includes migration for existing installs

This allows third-party apps (e.g. qRemote on iOS) to authenticate with qBittorrent natively while preserving the subnet whitelist for internal auto-configuration of Radarr, Sonarr, etc.

Fixes #4315

How it works

  • Third-party app from LAN (192.168.1.x) → proxy lets /api/* through, sets X-Forwarded-For: 192.168.1.x → doesn't match 10.21.0.0/16 → qBittorrent requires native login
  • Radarr/Sonarr/MAC (10.21.x.x) → connects directly, no proxy involved → matches subnet whitelist → no auth needed
  • Browser via Umbrel dashboardPROXY_AUTH_ADD handles it as usual

@al-lac I've tested this on my Umbrel and confirmed all three scenarios work. No need to merge this PR directly, feel free to bring these changes into your existing qBittorrent PR if that's easier.

Enable qBittorrent's reverse proxy support so it reads the real client
IP from X-Forwarded-For and checks it against AuthSubnetWhitelist.
This allows third-party apps (e.g. qRemote) to authenticate with
qBittorrent natively while preserving the subnet whitelist for
internal auto-configuration of Radarr, Sonarr, etc.

Fixes #4315
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 7, 2026

🎉   Linting finished with no errors or warnings   🎉

Thank you for your submission! This is an automated linter that checks for common issues in pull requests to the Umbrel App Store.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Disable Umbrel's Proxy Auth and AuthSubnetWhitelist for qBitTorrent

1 participant