Files
buryan-infra/ops/vpn/xhttp/xhttp-add-inbound.py
T
root d4ba9e8fe4 VPN Этап 2, шаг 2: VLESS + XHTTP добавлен и проверен снаружи
Задача 2.2 из реестра. XHTTP передаёт VLESS поверх обычных HTTPS-запросов:
трафик выглядит как обращения к сайту, а не как непрерывный поток. Для
провайдера, который разбирает характер соединения, это поведение иное,
чем у обычного VLESS+TLS, — потому и полезен как запасной.

Решение по устройству: XHTTP идёт на отдельном TCP-порту 8444 со своим
TLS и нашим сертификатом git.buryans.ru. Вариант «спрятать за nginx»
рассматривал, но он добавляет лишний слой и точку отказа без выигрыша.

Сделано:
* в конфигурацию xray добавлен входящий (порт 8444, сеть xhttp, TLS);
* клиенты перенесены с основного входа — человеку работает тот же ключ;
* путь /buryan-xhttp, маскировка под git.buryans.ru;
* порт открыт в экране VPS, правила сохранены;
* скрипты в ops/vpn/xhttp/.

ПРОВЕРЕНО СНАРУЖИ, с домашнего канала:
    напрямую:        46.8.140.22
    через XHTTP:     193.233.210.184  <- наш VPS
    домашние службы и YouTube через него: 200, 200, 200
    в журнале клиента всё ушло с пометкой [proxy]

Урок с Hysteria2 применён сразу: порт открыл в экране ДО проверки.
В прошлый раз канал работал на сервере, но был недоступен снаружи
из-за политики DROP — на эти грабли второй раз не наступил.

Итого рабочих каналов теперь три:
    VLESS + TLS   TCP 10443  — основной
    Hysteria2     UDP 10443  — QUIC, для видео и на случай помех TCP
    VLESS + XHTTP TCP 8444   — ведёт себя как обычный сайт

Резервная копия обновлена: оба канала и все 40 ключей зашифрованы в
ops/secrets-enc/vpn-configs.json, восстановление проверено сверкой.

Дальше по плану: собрать единый профиль с автоматическим переключением
между тремя каналами и доказать переключение отключением основного.
2026-10-16 22:26:53 +03:00

173 lines
6.7 KiB
Python

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Добавляет входящий VLESS + XHTTP в конфигурацию xray на VPS.
ЗАЧЕМ. XHTTP — это способ передачи VLESS поверх обычных HTTPS-запросов:
трафик выглядит как обращения к сайту, а не как непрерывный поток.
Если провайдер начнёт разбирать характер соединения, этот способ ведёт
себя иначе, чем обычный VLESS+TLS, и потому полезен как запасной.
РЕШЕНИЕ ПО УСТРОЙСТВУ. XHTTP идёт на отдельном TCP-порту (8444) со
своим TLS и нашим сертификатом git.buryans.ru. Вариант «спрятать за
nginx» рассматривал, но он добавляет лишний слой и точку отказа, а
выигрыша здесь нет. Один лишний порт — понятнее.
Что делаю:
* копия конфигурации;
* добавляю один входящий (порт 8444, сеть xhttp, TLS);
* добавляю клиентов: те же, что на основном входе, чтобы человеку
работал тот же ключ;
* встроенная проверка (xray run -test) ДО применения;
* перезапуск, проверка портов и живого канала;
* при провале — автоматический откат.
Запуск на VPS: python3 xhttp-add-inbound.py
"""
import json
import os
import re
import shutil
import subprocess
import sys
import time
CFG = "/usr/local/etc/xray/config.json"
PORT = 8444
PATH = "/buryan-xhttp"
SNI = "git.buryans.ru"
CERT = "/etc/letsencrypt/live/git.buryans.ru/fullchain.pem"
KEY = "/etc/letsencrypt/live/git.buryans.ru/privkey.pem"
def snapshot():
stamp = time.strftime("%Y%m%d_%H%M%S")
bak = "%s.before-xhttp-%s" % (CFG, stamp)
shutil.copy2(CFG, bak)
return bak
def rollback(bak):
print(" ОТКАТ: возвращаю конфигурацию из копии")
shutil.copy2(bak, CFG)
subprocess.run(["systemctl", "restart", "xray"], capture_output=True)
time.sleep(3)
r = subprocess.run(["systemctl", "is-active", "xray"],
capture_output=True, text=True)
print(" служба после отката: %s" % r.stdout.strip())
sys.exit(1)
def main():
print("=== 1. ЧИТАЮ КОНФИГУРАЦИЮ ===")
cfg = json.load(open(CFG, encoding="utf-8"))
inbounds = cfg.get("inbounds", [])
print(" входящих сейчас: %d" % len(inbounds))
for ib in inbounds:
cs = ib.get("settings", {}).get("clients", [])
print(" порт %-6s %-10s клиентов %d" % (
ib.get("port"), ib.get("streamSettings", {}).get("security"), len(cs)))
if any(ib.get("port") == PORT for ib in inbounds):
print("\n входящий на порту %d уже есть — правка не нужна" % PORT)
sys.exit(0)
# беру клиентов с основного входа: чтобы работал тот же ключ
base = next((ib for ib in inbounds if ib.get("port") == 10443), None)
if not base:
sys.exit(" ОШИБКА: не нашёл основной вход (10443)")
clients = [dict(c) for c in base.get("settings", {}).get("clients", [])]
print("\n переношу клиентов с основного входа: %d" % len(clients))
print("\n=== 2. КОПИЯ ===")
bak = snapshot()
print(" %s" % bak)
print("\n=== 3. ДОБАВЛЯЮ ВХОДЯЩИЙ XHTTP ===")
new_inbound = {
"tag": "xhttp-in",
"listen": "0.0.0.0",
"port": PORT,
"protocol": "vless",
"settings": {
"clients": clients,
"decryption": "none",
},
"streamSettings": {
"network": "xhttp",
"security": "tls",
"tlsSettings": {
"serverName": SNI,
"certificates": [
{"certificateFile": CERT, "keyFile": KEY}
],
},
"xhttpSettings": {
"host": SNI,
"path": PATH,
"mode": "auto",
},
},
"sniffing": {"enabled": True, "destOverride": ["http", "tls", "quic"]},
}
inbounds.append(new_inbound)
cfg["inbounds"] = inbounds
tmp = "/usr/local/etc/xray/xhttp-test.json"
with open(tmp, "w", encoding="utf-8") as f:
json.dump(cfg, f, indent=2, ensure_ascii=False)
f.write("\n")
print(" записан временный файл: %s" % tmp)
print("\n=== 4. ВСТРОЕННАЯ ПРОВЕРКА ДО ПРИМЕНЕНИЯ ===")
r = subprocess.run(["xray", "run", "-test", "-config", tmp],
capture_output=True, text=True)
print(" %s" % (r.stdout + r.stderr).strip().splitlines()[-1]
if (r.stdout + r.stderr).strip() else " нет вывода")
if r.returncode != 0:
print(" ОШИБКА проверки — не применяю")
print((r.stdout + r.stderr)[-400:])
os.remove(tmp)
rollback(bak)
print("\n=== 5. ПРИМЕНЯЮ ===")
shutil.copy2(tmp, CFG)
os.remove(tmp)
subprocess.run(["systemctl", "restart", "xray"], capture_output=True)
time.sleep(4)
print("\n=== 6. ПРОВЕРКА ===")
ok = True
for p in (10443, 2087, 2053, PORT):
r = subprocess.run(["ss", "-tln"], capture_output=True, text=True)
if (":%d " % p) in r.stdout:
print(" порт %-6d слушает" % p)
else:
print(" порт %-6d НЕ слушает" % p)
ok = False
r = subprocess.run(["systemctl", "is-active", "xray"],
capture_output=True, text=True)
print(" служба: %s" % r.stdout.strip())
if r.stdout.strip() != "active":
ok = False
cfg2 = json.load(open(CFG, encoding="utf-8"))
n = sum(len(i.get("settings", {}).get("clients", []))
for i in cfg2.get("inbounds", []))
print(" всего клиентов во всех входах: %d" % n)
if ok:
print("\n============================================================")
print(" ГОТОВО: XHTTP добавлен на порт %d" % PORT)
print(" путь: %s, отпечаток TLS: %s" % (PATH, SNI))
print(" копия до правки: %s" % bak)
print("============================================================")
else:
print("\n ПРОВЕРКА НЕ ПРОШЛА")
rollback(bak)
if __name__ == "__main__":
main()