Когда сервер уже работает
Один пользователь и вечный ключ - удобная сказка на вечер установки. Утром кто-то просит вторую ссылку, вечером первая засветилась в чужом чате, а ядро на GitHub уже новее того, что лежит в /usr/local/bin. Этот модуль про то, как менять пропуск, не запирая себя на лестнице.
ВВОДНАЯ
Рядом держите учебный config.json из урока 5.3, страницу VLESS про поле email и README скрипта установки про команду обновления. Новых протоколов не добавляем. Отдельной команды «ротировать ключ» у Xray в справке нет. Ротация - это правка полей, которые вы уже умеете генерировать.
ВЫ УЗНАЕТЕ
- как завести второго человека отдельным
idи увидеть его в журнале; - в каком порядке менять shortId и пару x25519, чтобы старый клиент дожил до новой ссылки;
- куда смотреть по симптому и какие двери на сервере оставить закрытыми.
6.1 Несколько пользователей
Список на входящем VLESS называется users. Каждый элемент - свой человек. Минимальный набор, который мы уже используем: id, flow, email. Идентификатор даёт xray uuid. Поток у обоих в этом курсе один и тот же, xtls-rprx-vision. Почта в протокол не уходит. Она помечает трафик в журнале и в статистике, так поле описано на странице VLESS.
Второй человек в том же входящем выглядит так:
{
"id": "22222222-2222-4222-8222-222222222222",
"flow": "xtls-rprx-vision",
"email": "boris@example.com"
}
UUID снова заглушка. Настоящий сгенерируйте отдельно, не «прибавьте единицу» к чужому. email сделайте различимым. Одинаковые пометки в журнале слипаются, и урок 6.4 вам потом не поможет.
shortIds при этом может остаться одним на всех. Метка REALITY и пользователь VLESS - разные списки. Двум людям можно выдать две метки, если хотите отзывать их порознь. Тогда в серверном массиве два чётных значения, а в каждой ссылке своё sid.
Ссылка Бориса отличается от ссылки Анны двумя местами, если shortId общий: другой UUID и другая подпись после #. pbk, sni, fp, адрес и порт те же, потому что пара ключей и донор у сервера общие. Кто скопировал ссылку Анны, не становится Борисом. Он становится Анной. Журнал покажет её email.
После правки снова xray run -test и systemctl restart xray. Старая Анна от рестарта не обязана страдать, если её объект в списке остался. Обрывается текущее соединение. Новое поднимется с тем же ключом.
Панель из урока 5.5 делает то же самое кнопкой. После кнопки откройте JSON и проверьте, что второй объект попал в users, а не в соседний протокол.
6.2 Ротация ключей и shortId
Ротации как команды нет. Есть порядок, в котором вы не отбираете единственный пропуск раньше времени.
Новый человек или утёкшая ссылка одного человека. Добавьте новый id, отдайте новую ссылку, убедитесь, что человек зашёл, удалите старый объект, перезапустите службу. Наоборот тоже работает, но тогда между удалением и доставкой новой ссылки у человека пусто. Для одного себя заведите второй объект заранее.
Новый shortId. Добавьте метку в массив shortIds рядом со старой. Раздайте ссылки с новым sid. Когда старые клиенты обновятся, старую метку уберите. Пока обе строки в списке, оба sid проходят. Пустая метка тоже участвует, если вы её оставили. Убрать пустую строку из массива - тоже ротация.
Новая пара x25519. Это общий секрет всех ссылок. xray x25519 даёт новую пару. privateKey на сервере и pbk у всех клиентов меняются вместе. Старый Password после замены перестаёт подходить, и неузнанный трафик уходит на target. Со стороны это выглядит как «открылся чужой сайт», урок 3.4. Поэтому сначала предупредите людей, потом меняйте, потом перезапускайте. Одного себя не забудьте: ваша собственная ссылка тоже устареет.
PrivateKey со старой машины сотрите там, где он залежался в истории терминала и в черновике. В журнале доступа его быть не должно: в учебном конфиге туда пишется трафик, не ключ. Но debug умеет быть болтливым. На каждый день оставьте warning.
Hash32 при ротации снова никуда не копируют. Легко принять новую третью строку за «новый публичный ключ, на этот раз точно». Подпись строки важнее ощущения.
6.3 Обновление Xray
Тот же скрипт, что ставил ядро, его и обновляет. README называет @ install и установкой, и обновлением. Проверка без установки - @ check. Строку снова копируйте из README в день работы. На сверке курса она совпадала с уроком 5.1.
Если ваш SSH ходит через Xray, добавьте --manually-restart-later, иначе обрыв скрипта на рестарте оставит обновление на полпути. Пока SSH отдельный, флаг не обязателен. Рестарт после смены бинарника всё равно нужен, просто его делаете вы, когда лестница на месте.
--logrotate у скрипта заводит ротацию журналов. README просит не ставить второй ротатор рядом: расходятся права, запись в лог начинает спотыкаться. Если журналы вам пока не мешают, флаг можно не трогать. Выключить доступный журнал вовсе можно значением none в поле access или error.
Geo-файлы обновляются отдельно, командой update-geodata. Учебный конфиг без категорий в ней не нуждается.
После обновления имеет смысл снова выполнить xray run -test на текущем файле. Поле, которое переименовали, всплывёт здесь. Клиент с старым flow при этом сам не обновится. Ссылка у людей та же, пока вы не смените поля из урока 6.2.
6.4 Мониторинг и симптомы
Смотреть есть куда, и все четыре места уже назывались.
systemctl status xray- жива ли служба.journalctl -u xray -e --no-pager- что она сказала при старте./var/log/xray/error.logиaccess.log- если пути заданы и уровень неnone.emailвнутри строки доступа отличает Анну от Бориса.
Когда лог кому-то пересылают, включите maskAddress. Страница журнала даёт quarter, half и full. Пустое значение, оно же по умолчанию, адреса не прячет. В общий чат сырой доступный журнал не кладут: там назначения, которые просил клиент.
Команда xray api stats в справке есть и работает только если API включён в конфиге. Учебный файл API не поднимает. Счётчик ради счётчика добавил бы ещё один входящий. Для базового сервера хватает журнала.
| Симптом | Причина, которую уже можно проверить | Проверка |
|---|---|---|
xray run -test ругается на shortId |
Нечётная длина или чужой символ | Посчитайте знаки. aaa1234 из документации - ошибка, aa1234 дополняется нулями |
| В тесте или в журнале странная роль REALITY | На клиенте заполнен target |
Уберите target с клиента. Поле отличает сервер от клиента |
| В браузере сайт донора, туннеля нет | Проверка не прошла, трафик ушёл на target |
pbk, sid, sni, flow, UUID. Не Hash32 вместо Password |
| Долгая тишина, статуса у службы нет | Порт не доходит | ufw status и цифра port. Адрес в ссылке - машина, не донор |
| Служба жива, а правки не видны | Работает старый процесс или старый файл | systemctl restart xray после -test |
| Публичный сайт открывается, частный адрес сервера нет | Заводская политика Freedom | Для VLESS частные диапазоны закрыты, пока нет явного allow |
| В журнале не разобрать, кто ходил | Пустой или одинаковый email |
Разные пометки у объектов в users |
| После смены пары ключей старый телефон «открыл чужой сайт» | Старый Password больше не пара | Новая ссылка с новым pbk. Так и выглядит неузнанный клиент |
Строку ошибки ядро пишет свою. Если текст на экране не совпал с таблицей дословно, ищите поле, а не перевод. Таблица про класс причины.
6.5 Что ещё закрыть на сервере
Короткий список дверей уже есть с модуля 4: SSH и порт Xray. Больше входящих ufw в этой схеме не требует. Панель на порту вроде 8000 либо закрыта снаружи, либо ограничена так, как написано в её README. «Посмотреть с телефона» без ограничения - вторая дверь.
fail2ban - пакет, который смотрит журнал SSH и на время закрывает адрес, слишком часто ошибающийся с входом. Пороги попыток и длину бана курс не копирует из чужих скриптов: их там полно, и они друг другу противоречат. После установки смотрите fail2ban-client status и документацию пакета. Если тюрьмы SSH в статусе нет, она не включена. Имя тюрьмы и файл в jail.d берите оттуда, не из памяти.
На сам Xray fail2ban из этого модуля не вешаем. Неузнанный REALITY-запрос уходит на донора и не обязан оставлять удобную строку «неверный пароль». Защита входа здесь - секрет ссылки и короткий список портов, а не счётчик попыток.
Автообновления Ubuntu уже описаны в руководстве. Пакет unattended-upgrades установлен по умолчанию и ставит обновления безопасности. По умолчанию он запускается раз в день. Журнал лежит в /var/log/unattended-upgrades. Автоматическая перезагрузка машины выключена, пока вы сами не поставили Unattended-Upgrade::Automatic-Reboot. Заводское значение - false.
Начиная с Ubuntu 24.04 LTS, пакет needrestart по умолчанию перезапускает затронутые службы. Актуальный LTS новее этой отметки, так что сюрприз возможен: обновилась библиотека, перезапустился процесс. SSH по ключу и вторая сессия тут те же, что в уроке 4.3. Не выключайте автообновления безопасности только потому, что рестарт неприятен. Выключите автоматическую перезагрузку всей машины, если вам нужен свой час, и оставьте установку заплаток.
Ядро Xray этот механизм само не обновляет. Его обновляет скрипт из урока 6.3. Система и ядро - две лестницы.
Историю терминала с PrivateKey стоит почистить на сервере после генерации. Файл конфига и так закрыт правами 0640. Этого хватает против другого пользователя на машине. Этого не хватает против того, кому вы сами отправили ссылку.
ССЫЛКУ ОТЗЫВАЮТ ОБЪЕКТОМ, НЕ ПРОСЬБОЙ
Попросить человека «удали у себя» не отзывает пропуск. Отзывает удаление его id или смена общей пары x25519. Пока объект на месте, старая строка работает. QR в галерее телефона - та же строка.
ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ ЭТОЙ ВЕРСИИ
Учебный сервер - один входящий VLESS, транспорт RAW, REALITY и один Freedom. Своё шифрование выключено строкой none. Своих правил маршрутизации и своего DNS нет: несовпавшее уходит в первый исходящий. Нет fallbacks, второго входящего, балансировки, API, статистики, подписок и TUN. Панель и Docker в файл не входят. Подписи ML-DSA-65 и FinalMask тоже нет. target в тексте - www.example.com, ключи - заглушки. В работу это несут после замены заглушек и xray run -test. Как устроены соседние режимы, курс здесь не рассказывает. Список, где их закроют, - модуль 7.
ПРАКТИКА
- Допишите на бумаге в
usersвторой объект. UUID обозначьте как заглушку,emailсделайте не таким, как у первого. Скажите, какие поля ссылки у двоих совпадут, еслиshortIdобщий. - Распишите порядок смены shortId так, чтобы старый клиент не отвалился раньше, чем вы отдадите новый. В порядке должно быть окно, когда в массиве живут обе метки.
- Возьмите симптом «в браузере сайт донора» из таблицы урока 6.4 и назовите две проверки, которые отличают его от симптома «тишина и нет TCP».
ВЫВОД МОДУЛЯ
Второй человек - второй объект в users со своим UUID и своим email. ShortId и пару ключей меняют сначала добавлением, потом раздачей ссылок, потом удалением старого. Ядро обновляет тот же официальный скрипт. По симптому сначала отличают «не узнали REALITY» от «не дошли до порта». На сервере остаются SSH, один порт Xray, обновления безопасности Ubuntu и секрет, который не лежит в общем чате. Чего в файле нет специально, собрано во врезке выше. Дальше эти имена только раскладывают по курсам, без новых настроек.
ПРОВЕРЬТЕ СЕБЯ
- Зачем у двух пользователей разные
email, если в ссылкеvless://этого поля нет? - Почему новую пару x25519 нельзя сменить втихомолку, не предупредив тех, у кого старый
pbk? - Какая команда скрипта обновляет ядро, а какая только смотрит, есть ли обновление?