Как сменить адрес сервера
Если хостинг-провайдер заменил серверу публичный IPv4-адрес, вы можете перевести панель BeAdmin на новый адрес одной командой beadmin newip в веб-консоли сервера. Команда перенастроит сеть операционной системы и проверит связь, а панель переведёт на новый адрес VPN, сайты, открытые по IP, и свой SSL-сертификат. Что панель исправить не может — конфиги пользователей VPN и DNS-записи, — она перечислит в уведомлении при следующем входе.
Когда это нужно
Хостинг-провайдер заменил публичный IPv4-адрес сервера, и панель перестала открываться: в настройках сети операционной системы остался прежний адрес. SSH по старому адресу тоже не подключится, поэтому команду запускают в веб-консоли сервера — её даёт хостинг-провайдер в личном кабинете.
Что понадобится
- Новый публичный IPv4-адрес сервера и адрес шлюза. Их указывает хостинг-провайдер в личном кабинете. Частный адрес команда отклонит.
- Доступ к веб-консоли сервера в личном кабинете хостинг-провайдера и права
root. - Debian 13, Ubuntu 24.04 или Ubuntu 26.04, в которых адрес сервера прописан статически: в netplan (файлы
/etc/netplan/*.yaml) или в ifupdown (/etc/network/interfacesи каталог/etc/network/interfaces.d/). Если сервер получает адрес автоматически или настройки лежат в другом месте, команда их не найдёт — смените адрес вручную.
Шаг 1. Откройте веб-консоль сервера
Откройте веб-консоль сервера в личном кабинете хостинг-провайдера и войдите под root. Если вы вошли обычным пользователем с правами sudo, ставьте sudo перед командой.
Шаг 2. Запустите команду
Выполните команду, подставив новый IPv4-адрес сервера:
beadmin newip 130.17.10.145Команда находит в настройках сети статический адрес сервера, выводит, что собирается изменить, и запрашивает шлюз:
Current address: 213.239.156.37/24, gateway 213.239.156.1
New address: 130.17.10.145/24
Gateway [130.17.10.1]:В первой строке — текущие адрес и шлюз из настроек сети, во второй — новый адрес. Маска сети остаётся прежней (в примере /24): команда её не меняет.
Шаг 3. Подтвердите шлюз
В квадратных скобках команда предлагает шлюз по умолчанию — первый адрес подсети нового адреса. Сверьте его со шлюзом из личного кабинета хостинг-провайдера:
- совпадает — нажмите Enter;
- отличается — введите шлюз хостинг-провайдера и нажмите Enter.
Если введённое значение не похоже на IPv4-адрес, команда запросит шлюз ещё раз. Пока шлюз не подтверждён, команда ничего не меняет.
Что происходит после ввода шлюза
Дальше команда работает без вашего участия. Она сохраняет копии изменяемых файлов, записывает в настройки сети новый адрес и шлюз, применяет их и проверяет, что сервер вышел в сеть. Затем перезапускает панель и дожидается, пока панель переведёт на новый адрес то, что хранила по старому. Результат выглядит так:
✓ Network reconfigured, connection is up
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Сеть операционной системы
Строка Network reconfigured, connection is up означает, что сервер работает на новом адресе. В настройках сети меняются только адрес и шлюз интерфейса, через который идёт маршрут по умолчанию; IPv6 и DNS-серверы остаются как были.
Если настройки сети лежат в файле 50-cloud-init.yaml, который создаёт cloud-init, команда дополнительно создаёт файл /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg с содержимым network: {config: disabled}. Без него после перезагрузки cloud-init снова записал бы прежний адрес. Если такой файл уже есть, команда его не меняет.
VPN, сайты и сертификат панели
Строка VPN, sites and the panel certificate now use the new address означает, что панель перезапущена и перевела на новый адрес:
- настройку «Адрес сервера» у VPN-модулей — если в ней указан прежний IP-адрес. Домен или другой адрес, который вы ввели вручную, остаётся как был;
- поле «Адрес панели» в настройках восстановления пароля — если в нём указан прежний IP-адрес. Домен остаётся как был;
- сайты, которые открываются по IP-адресу сервера: адрес сайта, виртуальный хост и адреса в настройках WordPress, если в них указан прежний IP-адрес;
- SSL-сертификат панели: панель запрашивает сертификат для нового адреса, а сертификат для прежнего удаляет.
Адрес для входа в панель
В последней строке стоит адрес, по которому панель теперь открывается. Порт в нём — порт панели, по умолчанию 8080. Знак ! означает, что после входа вас ждёт список того, что нужно сделать вручную.
Шаг 4. Войдите в панель
Откройте адрес из последней строки вывода команды и войдите в панель как обычно. Администратор увидит уведомление «Адрес сервера изменён. Посмотрите, что нужно поправить в модулях.» Нажмите «Подробнее», чтобы открыть окно со списком того, что осталось сделать вручную.
Пример окна:
Адрес сервера изменён: 213.239.156.37 → 130.17.10.145
VPN, сайты и сертификат панели уже работают на новом адресе.
Осталось сделать вручную:
1. Раздайте пользователям VPN новые конфиги — старые ведут
на прежний адрес и не подключатся.
Mimicry — 7 пользователей, WireGuard — 3 пользователя.
2. Сгенерируйте новые ссылки для узлов входа каскада
и передайте их на серверы узлов входа.
Amnezia — 2 пользователя в режиме узла выхода.
3. Укажите 130.17.10.145 в A-записях доменов:
example.com, shop.example.com.
4. Замените старый адрес на новый в SPF домена example.com
и попросите хостера прописать PTR-запись для 130.17.10.145.В окне есть только те пункты, которые относятся к вашему серверу, а нумерация идёт подряд. Список строится при каждом входе, поэтому пункт про A-записи исчезнет, когда домены начнут указывать на новый адрес.
⚠️ Закрывайте уведомление, только когда список выполнен
Уведомление остаётся на экране, пока вы не закроете его крестиком. После закрытия панель больше не показывает его — ни вам, ни другим администраторам, — и вернуть список в панели нельзя. Пользователи с другими ролями уведомление не видят.
Что остаётся сделать вручную
Панель не может исправить то, что хранится за её пределами: у пользователей VPN, на других серверах и в DNS. Окно «Подробнее» перечисляет только то, что относится к вашему серверу.
Раздайте пользователям VPN новые конфиги
Конфиги, ссылки и QR-коды, которые вы выдали раньше, содержат прежний адрес сервера и больше не подключаются. Новые конфиги, ссылки и QR-коды из модуля уже содержат новый адрес, если в настройке «Адрес сервера» выбрано «Автоматически» или был указан прежний IP-адрес. Передайте их пользователям заново. В окне указано, у каких модулей и сколько пользователей это касается.
💡 Домен вместо IP-адреса
Если у модуля в настройке «Адрес сервера» выбрано «Свой адрес» и указан домен, конфиги его пользователей раздавать заново не нужно: направьте A-запись этого домена на новый адрес. Окно «Подробнее» всё равно перечислит пользователей такого модуля, а A-запись домена, которого нет в разделе «Сайты и домены», не покажет — проверьте её сами. С доменом вместо IP-адреса конфиги переживут и следующую смену адреса.
Сгенерируйте новые ссылки для узлов входа каскада
Каскад — режим VPN-модуля, в котором трафик идёт через цепочку серверов. Если этот сервер работает в нём узлом выхода, узлы входа на других серверах обращаются к нему по прежнему адресу. В окне указаны модули и число пользователей в режиме узла выхода. Сгенерируйте для узлов входа новые ссылки и передайте их на серверы узлов входа.
Укажите новый адрес в A-записях доменов
Домены из раздела «Сайты и домены», чьи A-записи указывают на прежний адрес, перестанут вести на этот сервер. Укажите новый адрес в A-записях этих доменов у регистратора или в сервисе, где ведётся DNS-зона домена. Как создать A-запись, описано в статье Как настроить DNS-записи для почтового сервера.
Обновите SPF и попросите PTR-запись
Если на сервере установлен модуль почты, окно предложит поправить DNS-записи почтовых доменов:
- В SPF-записи каждого домена замените прежний адрес на новый: вместо
ip4:213.239.156.37должно стоятьip4:130.17.10.145. - Попросите хостинг-провайдера создать PTR-запись для нового адреса: она относится к IP-адресу, поэтому создаёт её только хостинг-провайдер.
Проверить результат можно в окне «Почтовые DNS» у домена в разделе «Сайты и домены».
Если команда завершилась с ошибкой
Нет связи на новом адресе
✗ No connection on the new address — previous network settings restored.
Check the address and gateway with your hosting provider and run the command again.Сервер не вышел в сеть с новым адресом, и команда вернула прежние настройки сети. Панель и её настройки при этом не менялись.
Над сообщением может стоять строка newip: … с причиной: the gateway … does not answer — шлюз не отвечает, nothing outside answers — шлюз отвечает, но внешние адреса недоступны. Сверьте адрес и шлюз с данными хостинг-провайдера и запустите команду ещё раз. Команда оставляет прежнюю маску сети: если у нового адреса она другая, смените адрес вручную.
Прежние настройки восстановить не удалось
✗ No connection on the new address, and the previous network settings couldn't be restored.
Restore the files manually from /var/lib/beadmin/newip-backup/1762958412/Сервер остался без связи. В указанном каталоге лежат копии файлов, которые изменила команда; внутри повторяется структура каталогов системы, например etc/netplan/50-cloud-init.yaml. Скопируйте файлы на прежние места, подставив путь из вашего сообщения:
cp -a /var/lib/beadmin/newip-backup/1762958412/etc/. /etc/Затем примените настройки: netplan apply для netplan или systemctl restart networking для ifupdown. Когда связь вернётся, сверьте адрес и шлюз с данными хостинг-провайдера и запустите команду ещё раз.
Панель не закончила переход
✗ The network is up, but the panel didn't finish moving to the new address.
See the panel log: journalctl -u beadminСеть уже работает на новом адресе, но панель не успела перевести на него всё, что хранила по старому. Запустите ту же команду с тем же адресом ещё раз:
beadmin newip 130.17.10.145Шлюз команда не запрашивает и сеть не меняет: она повторяет только переход панели. В случае успеха выводятся строки про VPN с сайтами и про адрес панели:
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Если панель открывается, о незавершённом переходе скажет и окно «Подробнее»: «Процесс перехода на новый адрес не завершён. Рекомендуем запустить в консоли сервера beadmin newip 130.17.10.145 ещё раз.» Если повторный запуск завершился той же ошибкой, причину ищите в журнале панели: journalctl -u beadmin. Над сообщением может стоять строка newip: … с причиной.
Не найдены настройки сети
✗ Couldn't find the network configuration. Supported: netplan and /etc/network/interfaces.
Change the address manually — see the documentation.Команда ничего не изменила. Она ищет статический IPv4-адрес сервера в netplan и в /etc/network/interfaces; если адрес получен автоматически или настройки лежат в другом месте, она их не найдёт. Смените адрес вручную: в конце того раздела описано, как после этого перевести панель.
Панель хранит несколько прежних адресов
✗ The panel uses several old addresses: 213.239.156.37, 198.51.100.7.
Fix the panel address and the sites opened by IP manually.Прежние адреса в поле «Адрес панели» и у сайтов, открытых по IP-адресу, различаются. Команда не может выбрать, какой из них заменить, и ничего не меняет. Укажите новый адрес вручную в поле «Адрес панели» в настройках восстановления пароля и исправьте адрес у сайтов, открытых по IP-адресу.
Команда сразу отклонила запуск
В этих случаях команда ничего не меняет:
| Сообщение | Что делать |
|---|---|
✗ Run the command as root: sudo beadmin newip 130.17.10.145 | Команда запущена не под root. Повторите её с sudo, как в сообщении. |
Usage: beadmin newip <new IPv4 address> | Адрес не указан или указано больше одного значения. Укажите один новый IPv4-адрес. |
✗ 130.17.10 isn't an IPv4 address. | Адрес записан неверно: IPv4-адрес состоит из четырёх чисел через точки. |
✗ 10.0.0.5 is a private address. Enter the public address from your hosting provider. | Введён частный адрес. Укажите публичный адрес, который выдал хостинг-провайдер. |
The server already uses 130.17.10.145 — nothing to change. | Сеть уже работает на этом адресе, а панель не хранит другого адреса: переносить нечего. Сверьте адрес с данными хостинг-провайдера. |
✗ No gateway entered — nothing changed. | Шлюз не введён. Запустите команду ещё раз и укажите шлюз. |
Ручная смена адреса
Если команда не нашла настройки сети, смените адрес вручную. Так бывает, когда сервер получает адрес автоматически или сеть настраивает systemd-networkd либо NetworkManager, а не netplan и ifupdown.
Узнайте интерфейс, через который идёт маршрут по умолчанию:
baship -4 route show defaultИмя интерфейса стоит после
dev, напримерeth0.Найдите файл, в котором система хранит адрес этого интерфейса, сохраните его копию и замените в нём адрес и шлюз на новые. Если сеть настраивает cloud-init (файл
50-cloud-init.yaml), создайте ещё файл/etc/cloud/cloud.cfg.d/99-disable-network-config.cfgс содержимымnetwork: {config: disabled}: иначе после перезагрузки cloud-init снова запишет прежний адрес.Примените настройки способом, принятым в вашей системе, и проверьте связь:
bashping -c 3 8.8.8.8
Когда сеть заработает на новом адресе, запустите команду ещё раз с этим адресом. Настройки сети она при этом не трогает:
beadmin newip 130.17.10.145Команда находит прежний адрес в панели — в поле «Адрес панели», среди сайтов, открытых по IP-адресу, и в SSL-сертификате панели — и переводит панель на новый. В случае успеха она выводит:
The network already uses 130.17.10.145. Moving the panel from 213.239.156.37…
✓ VPN, sites and the panel certificate now use the new address
! Some modules need your attention: https://130.17.10.145:8080Дальше действуйте как после обычного запуска: войдите в панель по адресу из последней строки и пройдите список из раздела Что остаётся сделать вручную.