Xray: ключи, файл и служба
Машина уже пускает вас по ключу и молчит на лишних портах. Осталось поставить ядро официальным скриптом, положить в него вывеску и собрать ту ссылку, которую модуль 3 уже умеет читать. Панели в конце модуля существуют. Учебный путь идёт через файл, чтобы поля не прятались за кнопкой.
ВВОДНАЯ
Держите открытыми README репозитория XTLS/Xray-install и страницу REALITY. Строку установки скопируйте из README в день работы. Ниже она приведена так, как README выглядел на сверке курса. Чужой однострочник, который обещает «оптимальный» донор и сам открывает файрвол, в этот модуль не входит.
ВЫ УЗНАЕТЕ
- как официальный скрипт кладёт бинарник, службу и пустой конфиг;
- как собрать
config.jsonиз полей модуля 2 без настоящих ключей в тексте; - как из того же файла получить ссылку и чем панель отличается от этого пути.
5.1 Официальный скрипт и ключи
Скрипт XTLS/Xray-install в своём README описан для систем с systemd. По имени там стоят CentOS, Debian и OpenSUSE. Слова Ubuntu в этой фразе нет. Ubuntu относится к семейству Debian и использует systemd. Перед запуском всё равно откройте README: если строка сдвинулась, верна страница, не этот абзац.
Строку установки в PDF не копируем: она живёт в README и съезжает быстрее урока. Откройте раздел Basic Usage, пункт про установку и обновление ядра. На день сверки строка заканчивалась на @ install и качала install-release.sh из того же репозитория. Если примета разошлась со страницей, верна страница.
Скрипт качается и тут же выполняется. Имеет смысл сначала прочитать install-release.sh глазами. Это не второй способ установки. Это тот же файл.
Что появится на диске, README перечисляет прямо. Бинарник /usr/local/bin/xray. Каталог /usr/local/etc/xray/ с правами 0750 и владельцем root:xray. Файлы json с правами 0640. Каталог журналов /var/log/xray/ с правами 0700 и владельцем xray. Юнит xray.service. Свежий config.json скрипт создаёт содержимым {}. Пока вы его не замените, VLESS там не живёт.
С 18 октября 2026 README предупреждает: служба идёт от пользователя xray, не от общего nobody. Свежая установка этого почти не замечает. Обновление со старой схемы замечает. Не возвращайте службу на root. Конфиг она должна читать, а не владеть им.
Скрипт кладёт geoip.dat и geosite.dat в /usr/local/share/xray/. Учебный файл их не использует. Трогать update-geodata не нужно, пока вам не понадобились категории. Предупреждение README про смену источника этих файлов относится к тем, кто уже строил правила на старых категориях. Лёгкий geoip, по странице маршрутизации, содержит короткий список страновых категорий. Имена категорий курс не переносит: в базовом файле их нет.
Две команды из xray help. Команды для shortId там нет:
/usr/local/bin/xray uuid
/usr/local/bin/xray x25519
xray uuid печатает идентификатор пользователя. xray x25519 печатает PrivateKey, Password (PublicKey) и Hash32. Первая строка - в серверный privateKey. Вторая - в клиентский password и в pbk. Третья не используется. ShortId возьмите сами: чётная шестнадцатеричная строка до 16 символов, урок 2.2.
Запомните вывод у себя. В курс и в чат его не переписывают.
5.2 Какой сайт стоит в target
Поля донора уже разобраны в уроке 2.4. Здесь только сборка строки.
target выглядит как адрес и порт: в образце документации это example.com:443. serverNames - список имён без звёздочки. В том же образце это example.com и www.example.com. Для учёбы в файле ниже оставлено одно имя, www.example.com, и тот же хост в target. Это по-прежнему пример, не рекомендация живого донора. example.com зарезервирован под документацию.
Перед тем как открывать порт наружу, замените пример на сайт или узел, которым вы распоряжаетесь либо на который есть письменное разрешение. Команда со страницы REALITY:
/usr/local/bin/xray tls ping www.example.com
Командой xray tls ping проверьте, что рукопожатие отвечает и какое имя в сертификате. Это имя и есть кандидат в serverNames. Чужой публичный сайт, сайт за сетью доставки и «список доноров» из однострочника не подставляйте.
Порт внутри target и порт входящего Xray - разные клетки. Обе могут быть равны 443. Смысл у них разный. Первая - куда показывать гостя без ключа. Вторая - где слушает ваша дверь. В ufw открывают вторую.
5.3 Файл config.json
Файл лежит в /usr/local/etc/xray/config.json. Права 0640, группа xray, владелец root. Правьте через sudo. Пользователь службы файл читает и не должен его переписывать.
Ниже учебный скелет, без комментариев, чтобы его принял и обычный разбор JSON. Он показывает, какое поле к какому слою относится. Это не готовый сервер и не файл, который копируют с чужой страницы. На сайте документации в таких примерах часто стоят строки //. Ядро их в своих образцах показывает. Если допишете комментарий, проверкой останется команда из урока 5.4, не чужой линтер, который комментариев не ждёт.
Заглушки REPLACE_WITH_PRIVATE_KEY и UUID-заглушку на своей машине заменяют вывод своих команд. Пока они стоят как в этом тексте, файл объясняет протокол и не является рабочим сервером. Так и должно быть в PDF. На инфраструктуру, которой вы не администрируете, его не переносят.
{
"log": {
"logLevel": "warning",
"access": "/var/log/xray/access.log",
"error": "/var/log/xray/error.log"
},
"inbounds": [
{
"listen": "0.0.0.0",
"port": 443,
"protocol": "vless",
"settings": {
"decryption": "none",
"users": [
{
"id": "11111111-1111-4111-8111-111111111111",
"flow": "xtls-rprx-vision",
"email": "anna@example.com"
}
]
},
"streamSettings": {
"method": "raw",
"security": "reality",
"realitySettings": {
"show": false,
"target": "www.example.com:443",
"serverNames": ["www.example.com"],
"privateKey": "REPLACE_WITH_PRIVATE_KEY",
"shortIds": ["a1b2c3d4e5f67890"]
}
}
}
],
"outbounds": [
{
"protocol": "freedom",
"tag": "direct"
}
]
}
listen со значением 0.0.0.0 - заводское и означает все адреса машины. Страница входящего пишет, что :: для ядра то же самое: оба слушают IPv4 и IPv6. port 443 совпадает с правилом ufw из урока 4.4. Поменяете одно, поменяйте другое.
decryption записан явно как none. Пустым его оставлять нельзя. Список называется users. Слово clients вы увидите в панелях. В файл ядра по этой странице VLESS пишите users. email нужен, чтобы отличать людей в журнале. level не указан и по документации равен 0.
Поле журнала на странице называется logLevel. Значение warning - заводское. На Xray 26.11.9 старое написание loglevel проверка тоже принимает: разбор JSON не смотрит на регистр, а в выводе -dump имя всё равно становится logLevel. В файле курса стоит имя со страницы.
"method": "raw" - имя со страницы транспорта. Старое поле network и значение tcp на Xray 26.11.9, которым прогнан учебный файл, тест тоже принимает. Стандарт ссылки всё ещё говорит tcp и поле network. В файле курса остаётся имя со страницы: method и raw.
Старые примеры TLS ещё пишут allowInsecure. Страница TLS помечает его устаревшим и отсылает к pinnedPeerCertSha256. На сборке 26.11.9 тест идёт дальше: поле снято, ядро просит pinnedPeerCertSha256 и verifyPeerCertByName. В учебном REALITY этого поля нет. Копировать его из старой заметки не нужно.
Исходящий один, протокол freedom, метка direct. Отдельного блока routing нет. Страница маршрутизации говорит: не совпало ни одно правило - трафик идёт в первый исходящий. Он здесь и есть первый.
Freedom для входящего VLESS по умолчанию не пускает в частные и зарезервированные адреса. Правило allow добавляйте только если клиенту правда нужна внутренняя сеть, и ограничивайте его. Образец на странице Freedom с чужими geoip-категориями в учебный файл не копируется.
Тот же файл без комментариев лежит в code/config.example.json рядом с курсом. Текст в PDF и текст в файле должны совпадать. Если расходятся, верьте тому, который вы только что сверили со страницей, и поправьте второй.
5.4 Служба, логи и ссылка
Проверка файла без запуска службы:
sudo /usr/local/bin/xray run -test -config /usr/local/etc/xray/config.json
Флаг -test есть в справке xray run. Ошибку длины shortId и кривой JSON он показывает до клиента. Заглушку REPLACE_WITH_PRIVATE_KEY этот тест отвергает: ядро пишет, что privateKey недействителен. На Xray 26.11.9 тот же файл с настоящим ключом и существующим каталогом журналов отвечает Configuration OK. Каталог /var/log/xray/ создаёт скрипт установки. Без него тест спотыкается уже о путь журнала, даже если ключ верный.
Дальше:
sudo systemctl enable --now xray
sudo systemctl restart xray
sudo systemctl status xray
sudo journalctl -u xray -e --no-pager
Каталог /var/log/xray/ скрипт создаёт, но сам Xray туда не пишет, пока пути не указаны в log. В учебном файле они указаны. Уровень warning - значение по умолчанию. debug на каждый день не нужен: журнал раздувается и начинает содержать лишнее. Доступ к файлам у пользователя xray, каталог с правами 0700.
Ссылка собирается из того же файла. Возьмите поля урока 3.2 и подставьте своё.
На листе ссылка снова разложена по полям. В буфере она одна строка.
vless://UUID@АДРЕС:443
?type=tcp
&encryption=none
&security=reality
&pbk=PASSWORD
&sid=a1b2c3d4e5f67890
&sni=www.example.com
&fp=chrome
&flow=xtls-rprx-vision
#anna
UUID - поле id. АДРЕС - публичный адрес машины, не хост из target. PASSWORD - строка Password, не PrivateKey. sni - элемент serverNames. sid - элемент shortIds. type=tcp остаётся в ссылке, даже если в файле написано raw. fp=chrome при REALITY не выкидывайте.
Имя после # закодируйте, если в нём есть пробел или нелатинская буква. Наша anna и так подходит.
Клиент из модуля 3 получает эту строку или её QR. QR вы сделаете любым генератором картинки из текста. Секрета в картинке не больше, чем в строке. Обоим место не в общем чате.
Пока SSH отдельный, как в модуле 4, обычный restart лестницу не режет. Если SSH пойдёт через этот же Xray, к обновлению из урока 6.3 добавьте флаг из README скрипта. Он пишется с двумя дефисами:
--manually-restart-later
5.5 Панели коротко
3X-UI и Marzban стоят в ряду веб-панелей на странице Xray-core. Обе про много пользователей и про то, чтобы не править JSON руками. Описание репозитория 3X-UI называет панель многопротокольной, в списке есть VLESS. README Marzban называет окно в браузере, поддержку VLESS и REALITY, несколько пользователей, ссылку и QR.
Порт панели - не порт VLESS. У Marzban UVICORN_HOST по умолчанию равен 0.0.0.0, а UVICORN_PORT равен 8000. README при этом пишет, что панель по голому IP не открывают: в примере адрес вида https://YOUR_DOMAIN:8000/dashboard/. Вторую дверь в учебный ufw не добавляют «чтобы посмотреть». Как панель просит логин, читайте в её README в день установки. Заводской пароль курс не выдумывает: в прочитанном README его задаёте вы командой создания администратора. Саму команду установки панели сюда не копируем. Это уже соседний курс.
Кнопки в курс не переписываются. Они стареют быстрее полей ядра. Если панель всё же удобнее, после сохранения откройте получившийся JSON. Проверьте, что список пользователей называется так, как ждёт ваша версия, что target не оказался на клиенте, что Password не перепутан с PrivateKey и что flow равен xtls-rprx-vision. Расхождение с уроком 5.3 чините по странице документации, не по скриншоту панели.
В ряду панелей на странице Xray ссылка Hiddify ведёт в Hiddify-Manager. Клиент hiddify-app из урока 3.1 - другая программа. Не отдавайте телефону адрес панели.
Панель в этом курсе - окно к вашему серверу для своих людей. Это не инструкция, как продавать доступ посторонним. Платная раздача доступа может перевести вас в режим владельца VPN-сервиса (ст. 15.8 149-ФЗ) и под требования к таким владельцам.
ПУСТОЙ ОБЪЕКТ - ЕЩЁ НЕ СЕРВЕР
Скрипт оставляет {}. Служба при этом может числиться запущенной и ничего не принимать. После замены файла нужен xray run -test, затем systemctl restart xray. Клиенту ссылку отдают только после этого.
ПРАКТИКА
- Откройте README Xray-install и сравните строку
installс уроком 5.1. Если они разошлись, рабочей считайте README. - На уже установленной своей машине выполните
xray x25519и подпишите три строки: сервер, клиент, никуда. Вывод в конспект курса не вставляйте. - В учебном JSON найдите две разные клетки с портом 443. Подпишите, какая из них входящий Xray, а какая -
target.
ВЫВОД МОДУЛЯ
Официальный скрипт ставит ядро, пользователя xray и пустой json. Вы кладёте туда VLESS, RAW, REALITY и один Freedom. Проверка -test ловит кривой ключ раньше клиента. Ссылка берёт Password и адрес машины, а не донора. Панель имеет право нарисовать то же самое, но JSON после неё стоит прочитать. Дальше сервер живёт: люди, смена ключей, обновление и симптомы.
ПРОВЕРЬТЕ СЕБЯ
- Какой пользователь должен запускать службу по README скрипта после предупреждения от 18 октября 2026, и почему это не root?
- Куда в конфиге попадает PrivateKey, а куда Password?
- Почему в ссылке написано
type=tcp, а в файле"method": "raw"?