CMS YouWebsite · 2.0.0

Инструкция по установке

← Все руководства

Установка проходит в четыре шага. Сначала отправьте архив со своего компьютера на сервер. Затем запустите установку на сервере, настройте почту и владельца в браузере и проверьте сайт. В архиве уже есть готовый сайт.

Что подготовить

  • Сервер у хостинга. В панели он может называться VDS или VPS. При заказе выберите Ubuntu 24.04 или новее. Достаточно 1 ядра, 1 ГБ памяти и 10 ГБ места. Для CMS нужен отдельный сервер без уже работающего сайта.
  • Данные для входа на сервер. Откройте его карточку в панели хостинга. Скопируйте числовой адрес сервера (IP). Для входа понадобится пользователь root и пароль из панели либо ключ для входа.
  • Домен — адрес будущего сайта. Откройте настройки домена там, где управляются его записи DNS. Добавьте запись типа A со значением IP вашего сервера. Для основного адреса в поле «Имя» панель обычно предлагает @ или пустое поле. Для адреса вроде test.ваш-домен.ru введите test. Если нужен и адрес с www, добавьте запись с тем же IP. В поле «Имя» введите www для основного адреса или www.test для test.ваш-домен.ru. Изменения могут вступать в силу несколько часов. Перед установкой программа сама проверит, куда указывают эти имена.
  • Почта для отправки писем сайтом. Подойдёт, например, ящик на Яндексе или Mail.ru. Для него нужен отдельный пароль приложения. Где его сделать, подскажет окно установки. Приготовьте и адрес владельца, куда будут приходить коды входа.

1. Отправьте архив на сервер

Откройте окно для команд на своём компьютере

  • Mac. Нажмите ⌘ + пробел, наберите «Терминал» и нажмите Enter. Вставляйте команды сочетанием ⌘ + V.
  • Windows 10 или 11. Откройте «Пуск», наберите «PowerShell» и откройте Windows PowerShell. Вставьте команду через Ctrl + V или щёлкните правой кнопкой мыши в окне.
  • Linux. В меню приложений найдите «Терминал» и откройте его. Вставьте команду через Ctrl + Shift + V или через меню «Вставить» по правой кнопке мыши.

Копируйте только текст внутри блока с командой. Вставьте одну команду в открытое окно, нажмите Enter и дождитесь результата. Выполняйте следующую команду, когда окно снова готово принять ввод.

Найдите скачанный файл

Скачайте архив CMS YouWebsite по полученной ссылке и сохраните его на компьютере, например в папке «Загрузки». Файл этой версии называется cms-youwebsite-2.0.0.zip. Если у вашего архива другой номер версии, подставляйте его в команды ниже и в имя распакованной папки на шаге 2.

Скопируйте команду, вставьте её в окно и нажмите Enter:

cd "$HOME/Downloads"

Если окно пишет, что такой папки нет, или архив скачался в другое место, откройте в браузере список загрузок и нажмите рядом с ZIP «Показать в папке».

  • Mac или Linux. Напечатайте в терминале cd и пробел. Перетащите папку с ZIP из окна файлов в терминал, затем нажмите Enter.
  • Windows. Нажмите на адресную строку Проводника, скопируйте адрес папки и подставьте его между кавычками в команду cd "путь к папке с архивом". Вставьте команду в PowerShell и нажмите Enter.

Проверьте, что окно видит архив. На Mac или Linux введите ls и нажмите Enter. На Windows введите dir и нажмите Enter. Имя ZIP должно появиться в списке.

Скопируйте ZIP на сервер

Вставьте нужную команду. Замените IP_СЕРВЕРА на числовой адрес из панели хостинга и нажмите Enter.

Если входите на сервер по паролю:

scp cms-youwebsite-2.0.0.zip root@IP_СЕРВЕРА:/root/

Если входите по ключу, созданному по этой инструкции:

scp -i "$HOME/.ssh/cms_youwebsite" cms-youwebsite-2.0.0.zip root@IP_СЕРВЕРА:/root/

Если у вас уже есть ключ с другим именем, подставьте после -i путь к приватному файлу ключа на вашем компьютере. Это файл без окончания .pub.

При первом соединении окно может спросить, доверяете ли вы серверу. Сверьте его IP и, если хостинг показывает отпечаток сервера, сравните его с отпечатком в окне. После проверки введите yes и нажмите Enter. Если попросят пароль, введите пароль для входа на сервер и нажмите Enter. При вводе пароля на экране могут вообще не появляться символы. Для ключа с отдельным паролем окно может попросить пароль самого ключа.

Дождитесь окончания передачи. Обычно рядом с именем файла появится 100%, а затем окно снова будет готово принять команду. Если Windows не понимает scp или ssh, откройте подсказку ниже.

2. Запустите установку на сервере

Войдите на сервер

Продолжайте в том же окне. Вставьте нужную команду, снова замените IP_СЕРВЕРА на ваш адрес и нажмите Enter.

Вход по паролю:

ssh root@IP_СЕРВЕРА

Вход по ключу:

ssh -i "$HOME/.ssh/cms_youwebsite" root@IP_СЕРВЕРА

Если ключ называется иначе, укажите тот же файл, который использовали при отправке архива. Ответьте на запрос пароля, если он появится. Когда в начале строки появится что-то вроде root@имя-сервера:~#, вы внутри сервера. Дальнейшие команды одинаковы для Mac, Windows и Linux.

Распакуйте архив

В этом же окне вставьте первую команду и нажмите Enter. Она откроет папку, куда вы отправили ZIP.

cd /root

Вставьте следующую команду и нажмите Enter. Она распакует ZIP. Если после запуска появилась новая строка для ввода без сообщения об ошибке, можно идти дальше.

python3 -m zipfile -e cms-youwebsite-2.0.0.zip .

Откройте распакованную папку. Скопируйте команду, вставьте и нажмите Enter:

cd cms-youwebsite-2.0.0

Ответьте на вопросы установки

Вставьте команду и нажмите Enter:

sudo bash install.sh

Читайте вопросы по одному. После каждого ответа нажимайте Enter.

  1. Домен сайта. Введите адрес вроде мой-сайт.рф, без https:// и без www в начале. Можно писать по-русски.
  2. Открывать сайт и с www? Нажмите Enter, если вы добавили запись для этого имени. Если запись не добавляли, напишите н и нажмите Enter. Если установщик пишет, что адрес пока указывает не на этот сервер, нажмите Enter на вопросе «Всё равно продолжить?». Исправьте запись в панели домена, дождитесь обновления и снова запустите sudo bash install.sh.
  3. Название сайта. Напишите его как для посетителей. Оно появится в шапке, заголовках страниц и письмах сайта.
  4. Добавить демонстрационные публикации? Нажмите Enter, если хотите увидеть примеры. Для сайта без примеров напишите н и нажмите Enter.
  5. Почта для Let's Encrypt. Можно оставить пустой и нажать Enter. Let's Encrypt выдаёт бесплатный сертификат, с которым сайт работает по защищённому адресу https://. Почту для отправки писем сайта вы настроите в браузере на следующем шаге.
  6. Начать установку? Проверьте показанные адрес и название. Если всё верно и вы согласны с условиями выдачи сертификата, нажмите Enter. Если заметили ошибку, напишите н, нажмите Enter и запустите команду установки ещё раз.

Подождите, пока закончатся сообщения. Установщик подготовит сайт, получит сертификат и включит ночные копии. В конце он покажет ссылку на окна установки. Оставьте окно с командами открытым до конца следующего шага.

3. Окна установки: почта и владелец

В конце вывода найдите ссылку вида https://ваш-домен.ru/console/#setup=…. Скопируйте её целиком, включая часть после #, вставьте в адресную строку браузера и нажмите Enter.

  1. Почта сайта. Выберите почтовую службу. Откройте подсказку «Как получить пароль приложения», если ещё не сделали такой пароль. Введите адрес ящика, с которого сайт будет отправлять письма, и пароль приложения. Адрес для обращений посетителей можно оставить пустым. Нажмите «Проверить и сохранить». Если проверка не прошла, прочитайте сообщение под формой, исправьте данные и нажмите кнопку ещё раз.
  2. Владелец сайта. Придумайте имя для входа, например parish. Начните с латинской буквы и используйте от 3 до 40 символов. Введите почту владельца, придумайте пароль длиной от 12 символов и введите его дважды. Можно включить «Показать пароль» и проверить ввод. Нажмите «Отправить код на почту».
  3. Код из письма. Откройте почту владельца. Найдите письмо, скопируйте шесть цифр, вставьте их в поле «Код из письма» и нажмите «Завершить установку». Если письма нет, проверьте папку «Спам» и нажмите «Отправить код ещё раз». Если ошиблись в данных владельца, нажмите «Исправить логин, почту или пароль».
  4. Откроется консоль — место, где вы будете вести сайт. Выберите часовой пояс своего города или региона, когда консоль попросит это сделать.

Ссылка для установки действует сутки. Храните её у себя до завершения настройки владельца. Если срок истёк, вернитесь в окно с командами, подключитесь к серверу, если уже вышли, вставьте команду и нажмите Enter:

sudo cms-youwebsite-setup

Откройте новую ссылку, которую напечатает команда. Если владелец уже создан, войти в консоль можно по адресу сайта с /console/ в конце.

4. Проверьте сайт, вход и копию

  1. Откройте новую вкладку и введите адрес сайта с https:// в начале. Должна открыться главная страница без предупреждения браузера.
  2. Вернитесь в консоль и нажмите «Выйти». Снова откройте адрес сайта с /console/ в конце. Введите имя и пароль владельца, затем код из нового письма. Должна открыться консоль.
  3. В консоли откройте «Резервные копии», нажмите «Сделать копию сейчас» и дождитесь появления ZIP в списке. Нажмите «Скачать» рядом с этой копией и проверьте, что файл появился в загрузках браузера.

Ночные копии включаются при установке. Чтобы посмотреть время следующей, вернитесь в окно команд на сервере, вставьте команду и нажмите Enter:

systemctl list-timers cms-youwebsite-backup.timer --no-pager

В строке с cms-youwebsite-backup.timer должно быть время следующего запуска.

Обновление сайта

Сначала скачайте копию в консоли. Возьмите ZIP новой версии и отправьте его на сервер как в шаге 1. На сервере распакуйте именно новый ZIP и откройте его папку как в шаге 2. Вставьте команду и нажмите Enter:

sudo bash install.sh

Установщик обновит сайт и сохранит его страницы, публикации, пользователей и настройки.

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

  • Оформить и наполнить сайт. В консоли есть «Шапка и меню», «Подвал», «Страницы», публикации и «Пользователи». Подпись «Сайт на CMS YouWebsite» можно убрать галочкой в «Подвале». Памятки по работе с сайтом.
  • Открыть сайт для поиска. Сразу после установки сайт закрыт для поисковиков. Когда он готов, откройте на сервере папку распакованного ZIP, вставьте sudo bash install.sh --search on и нажмите Enter. Чтобы снова закрыть сайт для поиска, выполните sudo bash install.sh --search off. Если на адресах вроде mail.ваш-домен.ru работают другие сервисы, перед открытием проверьте, что они открываются по https://. Подробности для администратора.
  • Сохранить или вернуть копию сайта. Делайте и скачивайте копии в разделе «Резервные копии». Памятка по копиям и восстановлению.

Если что-то пошло не так

  • «Имя … указывает на …» или «Сертификат не выпущен». Сверьте IP в записи A с адресом сервера в панели хостинга. Проверьте и имя с www, если согласились его подключить. Дождитесь обновления записей. Если в панели хостинга есть отдельные правила доступа с интернета, проверьте, что разрешены подключения для сайта по портам 80 и 443. Затем снова выполните sudo bash install.sh на сервере, из папки распакованного ZIP. Установка подхватит уже сохранённые ответы.
  • «Permission denied» при копировании или входе. Проверьте, что в команде указаны IP нужного сервера и пользователь root. Для входа по ключу проверьте путь после -i и наличие публичного ключа в панели для этого сервера. Для входа по паролю сверяйтесь с данными в панели.
  • «No such file or directory» при копировании. Проверьте папку и точное имя ZIP. Браузер иногда дописывает к имени (1), если такой файл уже скачивали.
  • Коды больше не приходят или нужно сменить почту сайта. Войдите на сервер, вставьте sudo cms-youwebsite-setup --mail и нажмите Enter. Команда спросит данные почты и сразу их проверит.
  • Нужен новый пароль владельца или утерян доступ к его почте. Войдите на сервер, вставьте sudo cms-youwebsite-users и нажмите Enter. В меню выберите пункт 6 для нового пароля или 9 для восстановления доступа владельца.
  • Сайт не открывается или консоль пишет «Внутренняя ошибка». Скопируйте текст сообщения. Если ошибка в консоли, на сервере выполните journalctl -u cms-youwebsite -n 50 --no-pager, чтобы увидеть последние сообщения программы. Подробности для администратора.

Если Windows не понимает ssh или scp

Откройте «Пуск» и найдите «Дополнительные компоненты». Откройте этот раздел в параметрах Windows, нажмите кнопку добавления компонента, найдите «Клиент OpenSSH» и установите его. Закройте PowerShell, откройте его снова и повторите команду. Подсказка Microsoft.

Если хостинг просит ключ для входа

Создайте ключ на том компьютере, с которого будете входить на сервер. Откройте окно для команд, как описано в шаге 1.

  1. Создайте папку для ключа. Вставьте команду для своей системы и нажмите Enter.

    На Mac и Linux:

    mkdir -p "$HOME/.ssh"
    

    В Windows PowerShell:

    New-Item -ItemType Directory -Force "$HOME/.ssh"
    
  2. Вставьте следующую команду и нажмите Enter. Придумайте пароль ключа и повторите его, когда окно попросит. Если уже видите вопрос о замене существующего файла, введите n и нажмите Enter, чтобы сохранить старый ключ. Для нового ключа задайте другое имя вместо cms_youwebsite и используйте это имя дальше.

    ssh-keygen -t ed25519 -f "$HOME/.ssh/cms_youwebsite"
    
  3. Покажите публичную часть ключа. Вставьте подходящую команду и нажмите Enter.

    На Mac и Linux:

    cat "$HOME/.ssh/cms_youwebsite.pub"
    

    В Windows PowerShell:

    Get-Content "$HOME/.ssh/cms_youwebsite.pub"
    
  4. Скопируйте целиком строку, которая начинается с ssh-ed25519. В панели хостинга вставьте её в поле для SSH-ключа и выберите этот ключ для сервера. Файл без .pub храните на своём компьютере. Он нужен для команд входа и отправки архива.

Без окон (вручную)

Если вы администрируете сервер и хотите настроить почту и владельца без браузера, используйте команды из руководства администратора. Там же описано, как собрать сайт из исходников.