j0hnmatrix/alldebrid-proxy repository overview

⁠AllDebrid Proxy for Plex

This project provides a lightweight proxy service that integrates with AllDebrid⁠ to unlock streaming links on-the-fly.
It is designed to work seamlessly with .strm files in Plex, allowing clients to play content directly without manual link unlocking.

⁠✨ How It Works

• Plex reads .strm files that contain URLs pointing to this proxy.
• When a client requests a file, the proxy:
  1. Receives the original AllDebrid or 1fichier link via the url query parameter.
  2. Calls the AllDebrid API (/link/unlock) to resolve the direct download link.
  3. Returns an HTTP 302 redirect to the unlocked link, or the link itself depending on configuration.
• Clients follow the redirect and stream the file directly from AllDebrid’s CDN.

This means Plex clients don’t need to know about AllDebrid — they only see the proxy URL.

⁠⚙️ Features

• Automatic link unlocking via AllDebrid API.
• LRU cache to avoid repeated API calls for the same link.
• Configurable behavior:
  • Redirect mode (ALLOW_REDIRECT=true) → sends HTTP 302.
  • Inline mode (ALLOW_REDIRECT=false) → returns the unlocked link in the response body.
• Debug logging (DEBUG=true) to inspect API responses.
• Health check endpoint (/health) for monitoring.

⁠🚀 Usage

⁠Environment Variables

⁠Example .strm File

http://your-nas:5050/debrid?url=https://alldebrid.com/f/XYZ