Purpose
The Proxy Addon for 1-Stream acts as a bridge between clients and servers, allowing you to hide the real IP addresses of your 1-Stream infrastructure while improving routing flexibility and scalability.The addon works as middleware and does not process or run streams directly.
Supported Use Cases
Case 1: 1 Proxy in Front of All 1-Stream Servers
This is the most common configuration.
It is useful when routing clients from a specific geographic location through proxy servers located closer to them to improve latency and connection quality.
Example:
Your 1-Stream system is hosted in Germany, but you want to provide better connectivity for clients in Portugal.
How it works:
- Create a Proxy Group (e.g. Portugal).
- Assign one or more Lines to this Proxy Group.
- Link multiple Proxy servers to the group.
The Live Connections list will show which proxy is currently in use.
Notes:
- Proxy servers do not need the same resources as Load Balancers.
- Proxies can be added or removed from groups at any time.
- Resellers can create and manage their own Proxy Groups and Proxies for their clients.
Case 2: 1 Proxy in Front of 1-Stream Server
This setup is used to hide a specific 1-Stream server behind a proxy.
A common use case is providing different public IP addresses for reseller panels.
In this scenario:
- A dedicated proxy is created.
- The proxy is assigned directly to the Main 1-Stream Server (or another selected server).
All access is routed through the proxy, preventing exposure of the server’s real IP.
Case 3: Entry Point / Distributor for 1-Stream API Requests
As a 1-Stream installation grows, serving all API requests (Xcode, Stalker, M3U) from the Main Server becomes inefficient.
The Proxy Addon allows you to create an Entry Point to distribute API requests across multiple 1-Stream servers.
How it works:
- Create an Entry Point.
- Configure it to balance requests between selected servers.
- Assign it in the Manage Distributor section.
This improves performance, scalability, and reliability for high-traffic 1-Stream systems.





