Настройка рабочего места

Для работы с программными продуктами ISPsystem требуется ПК или мобильное устройство с возможностью подключения: 

• к веб-интерфейсу продукта;
• к серверу с продуктом по SSH.

Подключение к веб-интерфейсу

Стабильная работа веб-интерфейса поддерживается в актуальных версиях браузеров:

• Google Chrome; 
• Mozilla Firefox;
• Safari.

Работа веб-интерфейса в других браузерах c движком Chromium (Opera, Microsoft Edge, Яндекс Браузер и др.) поддерживается, но не гарантируется.

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

• Angular;
• Stencil.

Для корректной работы веб-интерфейса:

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

Подключение по SSH

SSH — сетевой протокол для удалённого подключения к серверу. SSH использует алгоритмы шифрования трафика, поэтому соединение по SSH является безопасным.

Подключение осуществляется под учётной записью суперпользователя на удалённом сервере. Обычно, это учётная запись root. 

Для аутентификации используется пароль или SSH-ключи. По умолчанию SSH использует порт 22/TCP, но может быть перенастроен на работу с другим портом.

Программное обеспечение (ПО) для работы SSH состоит из двух частей:

• серверная — входит в состав ОС на удалённом сервере;
• клиентская — устанавливается на рабочее место.

Установка клиентского ПО

Для ПК с ОС семейства Unix (Ubuntu, Debian, AlmaLinux, Astra Linux, macOS и т.д.) установка дополнительного ПО не требуется. 

Для устройств с ОС Windows версии 10 и выше установите компонент Клиент OpenSSH. Подробнее см. в официальной документации Microsoft.

Для мобильных устройств установите любой SSH-клиент.

Подключение с использованием логина и пароля

1. Откройте окно терминала или командную строку.

2. Введите команду: 

   Если SSH использует стандартный порт

   ssh <user>@<host>

   Если SSH использует нестандартный порт

   ssh -p <port> <user>@<host>

   Пояснения к команде

   <port> — порт подключения

   <user> — учётная запись с правами суперпользователя

   <host> — IP-адрес или доменное имя удалённого сервера

3. Введите пароль к учётной записи.

Подключение с помощью SSH-ключей

SSH-ключи представляют собой пару — закрытый и открытый ключ. Закрытый ключ — секретная информация, которая хранится у пользователя. Открытый ключ должен храниться на сервере, к которому будет осуществляться доступ по SSH.

1. Сформируйте ключ:
   1. Откройте окно терминала или командную строку.

   2. Введите команду: 

      ssh-keygen

   3. Укажите имя и путь к файлу для SSH-ключей. Если эти параметры не будут указаны, то закрытый ключ сохранится в файл id_rsa, а открытый — в id_rsa.pub в директориях:
      
      •  ОС Windows — C:\Users\<имя_пользователя>\.ssh\;
      •  ОС семейства Unix — /home/<имя_пользователя>/.ssh/.

2. Скопируйте содержимое открытого ключа в файл /<имя_суперпользователя>/.ssh/authorized_keys на сервере. В Unix-системах вы можете использовать для этого команду: 

   Если SSH использует стандартный порт

   ssh-copy-id -i <path_to_key> <user>@<host>

   Если SSH использует нестандартный порт

   ssh-copy-id -i <path_to_key> -p <port> <user>@<host>

   Пояснения к команде

   <path_to_key> — путь к файлу с открытым SSH-ключом

   <port> — порт подключения

   <user> — учётная запись с правами суперпользователя

   <host> — IP-адрес или доменное имя удалённого сервера

3. Подключитесь к серверу:
   1. Откройте окно терминала или командную строку.

   2. Введите команду: 

      Если SSH использует стандартный порт

      ssh <user>@<host>

      Если SSH использует нестандартный порт

      ssh -p <port> <user>@<host>

      Пояснения к команде

      <port> — порт подключения

      <user> — учётная запись с правами суперпользователя

      <host> — IP-адрес или доменное имя удалённого сервера

Копирование файлов

Вы можете копировать файлы с рабочего места на сервер и обратно с помощью утилиты scp. Для этого:

1. Откройте окно терминала или командную строку.

2. Выполните команду:

   Скопировать файл с рабочего места на сервер

   scp <path_to_local_file> <user>@<host>:<path_to_remote_file>

   Скопировать файл с сервера на рабочее место

   scp <user>@<host>:<path_to_remote_file> <path_to_local_file> 

   Пояснения к командам

   <path_to_local_file> — путь к файлу на рабочем месте

   <user> — учётная запись с правами суперпользователя

   <host> — IP-адрес или доменное имя удалённого сервера

   <path_to_remote_file> — путь к файлу на сервере

   Пример команды: 

   scp my_local_file.txt root@192.0.2.1:/root/my_dir/my_remote_file.txt

   Если SSH использует нестандартный порт, укажите его в команде в параметре -P

   Пример команды с нестандартным портом

   scp my_local_file.txt -P 2222 root@192.0.2.1:/root/my_dir/my_remote_file.txt

Возможные проблемы при подключении по SSH

Для подробной диагностики изучите лог-файлы /var/log/auth.log на сервере.