WardPane
Скачать

Установка

Установка WardPane на чистый сервер Ubuntu 24.04 LTS занимает несколько минут. От вас нужен доступ root по SSH, остальное установщик проверит сам.

Требования

Что Нужно
Система Ubuntu 24.04 LTS, x86_64 или arm64, только что установленная
Память 1 ГБ RAM хватает на десяток небольших сайтов. При 512 МБ используйте базу GeoLite2 Country вместо City
Порты 80 и 443 для сайтов, 1500 для панели. Они должны быть свободны: если их занимает nginx или Apache, установщик остановится
Доступ root или пользователь с sudo
Сеть исходящий HTTPS к Let’s Encrypt, nodejs.org и wardpane.com

Если у VPS-провайдера есть свой файрвол (его часто называют security groups, «группы безопасности»), откройте TCP 80, 443 и 1500 и в нём.

Одной командой

Подключитесь к серверу по SSH и выполните:

curl -fsSL https://wardpane.com/install | sudo bash

Скрипт:

  1. проверяет, что система Ubuntu 24.04, что он запущен от root и что есть curl, tar и sha256sum;
  2. спрашивает ваш email и показывает ссылки на Условия использования, Политику конфиденциальности и Согласие на обработку персональных данных;
  3. спрашивает, принимаете ли вы Условия и Политику конфиденциальности, а затем, даёте ли согласие на обработку персональных данных. Ответ «нет» на любой из вопросов прерывает установку;
  4. спрашивает, присылать ли вам новости и предложения (по умолчанию «нет»);
  5. отправляет на ваш email шестизначный код. Введите его; он действует 15 минут и 5 попыток;
  6. скачивает релиз по HTTPS, сверяет его контрольную сумму SHA-256 с опубликованной на wardpane.com, распаковывает его и запускает install.sh панели. Если сумма не совпадает, установка останавливается, ничего не запустив.

Чтобы передать параметры в install.sh, добавьте их после bash -s --:

curl -fsSL https://wardpane.com/install | sudo bash -s -- --php --email [email protected]

Из архива

Запросите архив на странице загрузки. На почту придёт ссылка, по которой можно скачать архив один раз в течение 24 часов. Проверьте его контрольную сумму SHA-256, как описано на той странице, скопируйте архив на сервер, затем:

tar xzf wardpane-2.0.0.tar.gz
cd wardpane
sudo ./install.sh --email [email protected]

Что делает установщик

  1. Проверяет ОС, архитектуру, память, диск, свободные порты и доступность API Let’s Encrypt.
  2. Устанавливает Node.js LTS, если подходящей версии нет.
  3. Создаёт системного пользователя wardpane и папки /opt/wardpane, /var/lib/wardpane и /var/www. Пользователь, который запустил sudo, попадает в группу www-data и может загружать файлы по SFTP без root.
  4. Спрашивает данные для входа в панель (см. ниже) и записывает /opt/wardpane/.env.
  5. Устанавливает службу systemd wardpane. Служба работает без root, с защитными настройками systemd, и из особых прав (capability) у неё есть только право занимать порты 80 и 443.
  6. Настраивает ufw: SSH (порт вашей текущей сессии и порт из sshd -T), 80, 443 и 1500.
  7. Запускает службу и проверяет, что панель отвечает.

В конце установщик выводит адрес панели, https://<server-ip>:1500, и данные для входа.

Первый вход

Если запустить установщик из терминала без --user и --password, он предложит два варианта:

  • [1] Generate (сгенерировать; по умолчанию, рекомендуется): случайное имя вида admin-x7k2q9 и пароль из 24 символов. Оба выводятся в конце. Сохраните их.
  • [2] Choose your own (задать свои): имя (Enter означает admin; буквы, цифры и . _ @ -) и пароль, который вводится дважды без отображения, не короче 12 символов, без кавычек, обратных слешей и переводов строки. Три неудачные попытки прерывают установщик.

Без терминала или с -y вопросов нет: имя admin (или из --user), пароль случайный.

С этими именем и паролем вы и входите в панель. Дополнительно можно разрешить вход под root с root-паролем сервера (--root-login, по умолчанию выключено); см. безопасность панели. Вход других пользователей сервера с их паролем ОС появится в версии 2.2; см. пользователи.

Параметры установщика

Параметр Что делает
--email <address> Email для учётной записи Let’s Encrypt. Без него сертификаты не выпускаются
--user, --password Задать данные для входа в панель без вопросов. Лучше вводить пароль по запросу: пока идёт установка, пароль, переданный параметром, виден другим пользователям в ps
--ip <address> Публичный адрес IPv4, если автоопределение выбрало не тот
--staging Использовать тестовую среду Let’s Encrypt (staging, тестовые сертификаты)
--php, --no-php Установить PHP или пропустить этот вопрос
--root-login, --no-root-login Разрешить или запретить вход под root с паролем root сервера
--no-ufw Не трогать файрвол
--force Продолжить, несмотря на проверки, которые можно обойти
-y Без вопросов: ответы по умолчанию, случайный пароль

Обновление с Small Web Panel 1.x

Запустите новый установщик на сервере с 1.x. Установщик переделает её на месте. Сначала он копирует всё в /var/backups/wardpane/<time>/. Потом переименовывает служебного пользователя swpanel в wardpane, а пользователей сайтов swp_<id> в wp_<id> с теми же uid и gid, чтобы владельцы файлов не сбились, переносит /var/lib/smallwebpanel в /var/lib/wardpane и запускает WardPane. Если WardPane не поднимется, сервер автоматически вернётся к 1.x.

После перехода один раз перезагрузите страницу панели (Ctrl+F5) и войдите заново. Ссылки, выданные версией 1.x для сайтов в режиме «Только по ссылке», продолжают работать. Подробности в разделе обновление.

Дальше

Откройте панель и переходите к разделу первые шаги.