Перейти к содержимому

Формат подписки

Xray Checker поддерживает пять различных форматов для конфигурации прокси. Для настройки используйте переменную окружения SUBSCRIPTION_URL.

Подробнее о методах проверки прокси читайте в разделе методы проверки.

1. URL подписки (По умолчанию)

Стандартный URL подписки, возвращающий Base64-кодированный список прокси-ссылок.

Пример:

Окно терминала
SUBSCRIPTION_URL=https://example.com/subscription

Требования:

  • HTTPS URL
  • Возвращает Base64-кодированное содержимое
  • Содержимое - это прокси-URL, разделенные переносом строки
  • Поддерживает стандартные заголовки User-Agent

Отправляемые заголовки:

Accept: */*
User-Agent: Xray-Checker

2. Строка Base64

Прямая Base64-кодированная строка, содержащая ссылки конфигурации прокси.

Пример:

Окно терминала
SUBSCRIPTION_URL=dmxlc3M6Ly91dWlkQGV4YW1wbGUuY29tOjQ0MyVlbmNyeXB0aW9uPW5vbmUmc2VjdXJpdHk9dGxzI3Byb3h5MQ==

Формат содержимого (до кодирования):

vless://[email protected]:443?encryption=none&security=tls#proxy1
trojan://[email protected]:443?security=tls#proxy2
vmess://base64encodedconfig
ss://base64encodedconfig

3. JSON-файл V2Ray

Один JSON-файл конфигурации в формате V2Ray/Xray.

Пример:

Окно терминала
SUBSCRIPTION_URL=file:///path/to/config.json

Формат файла:

{
"outbounds": [
{
"protocol": "vless",
"settings": {
"vnext": [
{
"address": "example.com",
"port": 443,
"users": [
{
"id": "uuid",
"encryption": "none"
}
]
}
]
},
"streamSettings": {
"network": "tcp",
"security": "tls"
}
}
]
}

4. Xray JSON-массив (Мульти-конфиг)

JSON-массив, содержащий несколько конфигураций Xray с именами. Этот формат удобен при экспорте конфигураций из GUI-клиентов или управлении несколькими именованными конфигурациями в одном файле.

Пример:

Окно терминала
SUBSCRIPTION_URL=file:///path/to/configs.json

Формат файла:

[
{
"remarks": "US Server 1",
"outbounds": [
{
"protocol": "vless",
"settings": {
"vnext": [
{
"address": "us1.example.com",
"port": 443,
"users": [{ "id": "uuid-1", "encryption": "none" }]
}
]
},
"streamSettings": { "network": "tcp", "security": "tls" }
}
]
},
{
"remarks": "EU Server 1",
"outbounds": [
{
"protocol": "trojan",
"settings": {
"servers": [
{
"address": "eu1.example.com",
"port": 443,
"password": "password123"
}
]
},
"streamSettings": { "network": "tcp", "security": "tls" }
}
]
}
]

Поле remarks из каждой конфигурации будет использоваться как имя прокси в панели управления.

5. Папка с конфигурациями

Директория, содержащая несколько JSON-файлов конфигурации V2Ray/Xray.

Пример:

Окно терминала
SUBSCRIPTION_URL=folder:///path/to/configs

Требования:

  • Директория должна содержать .json файлы
  • Каждый файл следует формату JSON V2Ray
  • Файлы обрабатываются в алфавитном порядке
  • Некорректные файлы пропускаются с предупреждением