vless_config_aggregator

KO | EN

gitlite — search

#html #javascript #python #flutter #android #c #hacktoberfest #reactjs #java #css #unity #nextjs

vless_config_aggregator

★ 42 Open GitHub ↗

A web-server that automatically aggregates links from multiple 3x-ui proxy servers into a single common link.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://github.com/NoisyCake/3x-ui_subscriptions_aggregator/blob/main/README.md">ENGLISH</a> •
 <a href="https://github.com/NoisyCake/3x-ui_subscriptions_aggregator/blob/main/README.ru.md">РУССКИЙ</a>

# vless_config_aggregator

A reverse proxy that aggregates multiple VLESS configurations from various services into a single unified subscription link.
</div>

## Prepare

> [!NOTE]
> This guide is relevant for Debian-based Linux distributions. Most testing was done with the sing-box client Hiddify

### Certificate
This service requires a valid SSL certificate, so you'll need to get it first.

Once your domain is set up, generate a certificate using the following (make sure ports 80 and/or 443 are open):
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install certbot

sudo certbot certonly --standalone -d <domain> --register-unsafely-without-email
```

The certificates will be located in: "/etc/letsencrypt/live/<domain>/"

### Subscriptions
If you want aggregate not only direct links (`vless://`) but also subscription URLs, you'll need to enable Subscription on each panel in settings.  
All clients you want to merge must share the same **subscription ID**.

![Server 1](https://i.ibb.co/672ypTMt/image.png)

![Server 2](https://i.ibb.co/sSn9byZ/2025-03-18-153330.png)

### Configuration file
To get the service up and running, you'll also need a plain `.txt` file with your list configurations available on GitHub or locally.

As mentioned above, both subscription and direct VLESS links are supported:
1. Direct `vless://` links go into the file as-is.
2. For subscription links, you must strip out the subscription ID part. For example, `https://<domain>:<port>/<url>/<subscription_id>` -> `https://<domain>:<port>/<url>/` (make sure the is a trailing slash).

Example:
```txt
https://subscription_link_example:1/imy/
https://subscription_link_example:2/sub/
vless://...
vless://...
vless://...
```

---
## Installing & Setup

Download and install required tools:
```bash
sudo apt update && sudo apt upgrade -y
sudo apt install git curl

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```

Download repo:
```bash
git clone https://github.com/NoisyCake/vless_config_aggregator.git
cd vless_config_aggregator
cp .env.template .env
```

---
## Running the Service

Start everything via Docker: `sudo docker compose up --build -d`.

The final aggregated link will depend on the contents of your config file and your purposes:
1. If there are only direct links or subscription links aren’t needed: `https://{SERVER_NAME}:{PORT}/{URL}/{SUB_NAME}`;
2. If subscriptions are used: `https://{SERVER_NAME}:{PORT}/{URL}/subscription_id/{SUB_NAME}`.

In both cases, the `/{SUB_NAME}` part is obviously unnecessary if the variable is empty.

---
## License

MIT licensed — see LICENSE for details.

---
## Changelog & Feedback

You can track version changes on the Releases page.
Suggestions, bug reports, and pull requests are welcome!

vless_config_aggregator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README