Перейти к основному содержимому

На обычном компьютере

Предварительные требования​

  • Аппаратное обеспечение, совместимое с архитектурой x86 и предназначенное для YunoHost, с объёмом оперативной памяти не менее 512 МБ и дисковым пространством не менее 16 ГБ
    • Это может быть старый ноутбук, настольный компьютер или полноценный сервер
  • USB-накопитель объёмом более 1 ГБ
  • Достойный интернет-провайдер, желательно с хорошей и неограниченной пропускной способностью исходящего трафика
  • Кабель Ethernet (RJ-45) для подключения сервера к маршрутизатору.
  • Компьютер для чтения этого руководства, прошивки образа и доступа к серверу.

Загрузка образа YunoHost​

warning

Если ваш компьютер 32-разрядный, обязательно загрузите 32-разрядный образ.

к сведению

(FIXME: этот фрагмент кода в данный момент не работает...)

При желании вы можете загрузить открытый ключ проекта, чтобы проверить подлинность изображений.

Прошивка образа YunoHost​

Запишите образ на USB-накопитель или CD/DVD-диск.

Загрузите и установите Etcher для вашей операционной системы.

Вставьте USB-накопитель, выберите образ и нажмите «Записать» (Flash).

Etcher

Загрузите машину с USB-накопителя​

  • Подключите компьютер к домашнему маршрутизатору с помощью Ethernet-кабеля.
  • Загрузите сервер с вставленным USB-накопителем или компакт-диском, выбрав его в качестве загрузочного устройства.
    • В зависимости от аппаратного обеспечения вам потребуется нажать одну из следующих клавиш: <F9>, <F10>, <F11>, <F12>, <DEL>, <ESC> or <Alt>.
    • Примечание: если на сервере ранее была установлена современная версия Windows (8 или новее), сначала необходимо настроить систему так, чтобы она выполнила «полную перезагрузку». Это можно сделать в разделе «Особые варианты загрузки» (Advanced startup options).
подсказка

Если не удается загрузиться с образа YunoHost, попробуйте воспользоваться Ventoy (выберите «Ventoy» в разделе «Запись образа YunoHost» (Flash the YunoHost image) выше).

Запуск графической установки​

Вы должны увидеть примерно такой экран:

Предварительный просмотр меню ISO
Предварительный просмотр меню ISO
осторожно

После проверки правильности раскладки клавиатуры запустится установка, которая полностью удалит данные с вашего жёсткого диска!

  1. Выберите Graphical install
  2. Выберите язык, местоположение, раскладку клавиатуры и, при необходимости, часовой пояс.
  3. После этого установщик загрузит и установит все необходимые пакеты.
к сведению

Если установка YunoHost завершается с ошибкой и вам не удаётся решить проблему, имейте в виду, что можно сначала установить Debian, а затем установить поверх него YunoHost. См. соответствующие инструкции.

Перейти к начальной настройке​

к сведению

Если вы восстанавливаете сервер с помощью резервной копии YunoHost, пропустите этот шаг и вместо этого восстановите резервную копию, а не выполняйте шаг после установки.

к сведению

В данной документации предполагается, что вы находитесь в той же локальной сети, что и ваша установка YunoHost.

Для VPS используйте публичный IP-адрес вместо локального домена или адреса.

На компьютере откройте браузер и попробуйте подключиться к веб-панели администратора:

  • если вы устанавливаете на VPS, вы, вероятно, использовали метод установки curl | bash, и он должен был указать вам адрес, обычно https://xx.xx.xx.xx (с публичным IPv4-адресом вашего сервера)
  • если вы устанавливаете дома и предполагаете, что вы находитесь в той же локальной сети, что и сервер,
    • вы можете попробовать открыть https://yunohost.local (это может сработать, а может и нет, в зависимости от того, поддерживает ли ваш компьютер и сеть протокол Bonjour)
    • если вы уже знаете локальный IP-адрес машины, перейдите по адресу https://xx.xx.xx.xx (с локальным IP-адресом, обычно начинающимся с 192.168)
    • в противном случае вам потребуется узнать его локальный IP-адрес перед продолжением.
warning

При первом посещении вы, скорее всего, столкнётесь с предупреждением о безопасности, связанным с сертификатом, используемым сервером. На данный момент ваш сервер использует самоподписанный сертификат. Позже вы сможете добавить сертификат, автоматически распознаваемый веб-браузерами, как описано в документации по сертификатам. На данный момент вам следует добавить исключение безопасности, чтобы принять текущий сертификат. (Однако, ПОЖАЛУЙСТА, не привыкайте слепо принимать подобные предупреждения безопасности!)

В результате вы должны попасть на эту страницу:

Предварительный просмотр страницы первоначальной настройки веб-интерфейса
Предварительный просмотр страницы первоначальной настройки веб-интерфейса

Основной домен​

Настройки, специфичные для WSL

Вам придётся выбрать фиктивный домен, поскольку он будет недоступен извне. Например, ynh.wsl. Самая сложная часть — это показ этого домена для вашего хостинг-провайдера.

Измените файл C:\Windows\System32\drivers\etc\hosts. В нём должна быть строка, начинающаяся с ::1, обновите её или добавьте при необходимости, чтобы получить:

::1    ynh.wsl localhost

Если вы хотите создать поддомены, не забудьте добавить их также в файл hosts:

::1    ynh.wsl subdomain.ynh.wsl localhost

Это будет домен, используемый пользователями вашего сервера для доступа к порталу аутентификации. Позже вы сможете добавить другие домены и при необходимости изменить основной домен.

  • Если вы новичок в самостоятельном размещении и у вас ещё нет доменного имени, мы рекомендуем использовать .nohost.me / .noho.st / .ynh.fr (например, homersimpson.nohost.me). Если оно еще не занято, домен будет настроен автоматически, и вам не потребуется никаких дополнительных шагов настройки. Обратите внимание, что недостатком является отсутствие полного контроля над конфигурацией DNS.
  • Если у вас уже есть доменное имя, вы, вероятно, захотите использовать его здесь. Позже вам потребуется настроить записи DNS, как описано здесь.
подсказка

Да, вам обязательно нужно настроить доменное имя. Если у вас нет доменного имени и вы не хотите использовать .nohost.me / .noho.st / .ynh.fr, вы можете создать фиктивный домен, например, yolo.test, и изменить свой локальный файл /etc/hosts таким образом, чтобы этот фиктивный домен указывал на соответствующий IP-адрес, как объяснено здесь.

Первый пользователь​

На этом этапе создаётся первый пользователь. Вам следует выбрать имя пользователя и достаточно сложный пароль. (Мы не можем не подчеркнуть, что пароль должен быть надёжным!) Этот пользователь будет добавлен в группу администраторов и, следовательно, сможет получить доступ к пользовательскому порталу, веб-интерфейсу администратора и подключаться через SSH или SFTP. Администраторы также будут получать электронные письма, отправленные на адреса root@yourdomain.tld и admin@yourdomain.tld: эти письма могут использоваться для отправки технической информации или оповещений. Позже вы можете добавить дополнительных пользователей, которых также можно добавить в группу администраторов.

Этот пользователь заменяет старого пользователя admin , на которого могут ссылаться некоторые старые страницы документации. В этом случае просто замените admin на ваше имя пользователя.

Проведите первичную диагностику​

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

Система диагностики призвана обеспечить простой способ проверки правильности настройки всех критически важных аспектов вашего сервера и помочь вам в устранении неполадок. Диагностика будет запускаться дважды в день и отправлять оповещение по электронной почте в случае обнаружения проблем.

подсказка

Не пугайтесь! При первом запуске диагностики вполне ожидаемо увидеть множество предупреждений (жёлтых или красных), поскольку обычно требуется настроить DNS-записи (если вы не используете домен .nohost.me/noho.st/ynh.fr), а также настроить перенаправление портов на домашнем маршрутизаторе.

подсказка

Если уведомление неактуально (например, потому что вы не планируете использовать определённую функцию), можно смело пометить проблему как «игнорируемую»: для этого перейдите в раздел веб-панели администратора > Диагностика (Diagnosis), и нажмите кнопку игнорирования для данной конкретной проблемы.

warning

В частности, к системам, установленным в WSL или на виртуальных машинах, скорее всего, нельзя будет получить доступ извне без дополнительной настройки сети в VirtualBox и на вашем компьютере.

Для запуска диагностики перейдите в раздел «Диагностика» (Diagnosis) в веб-интерфейсе администратора. Нажмите кнопку «Запустить начальную диагностику» (Run initial diagnosis) — вы должны увидеть экран, подобный этому:

Предварительный просмотр диагностической панели
Предварительный просмотр диагностической панели

Получите сертификат Let's Encrypt​

После настройки DNS-записей и перенаправления портов (если оно требуется) вы сможете установить сертификат Let's Encrypt. Это избавит новых посетителей от того пугающего предупреждения о безопасности, которое возникало ранее.

Более подробные инструкции и информацию о сертификатах SSL/TLS можно найти на соответствующей странице.

Перейдите в раздел «Домены» > Нажмите на свой домен > «Сертификат» (Domains > Domain > Certificate)

Предварительный просмотр диагностической панели
Предварительный просмотр диагностической панели

🎉 Поздравляем!​

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