Перейти к содержимому
Octoboard Документация

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

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

Не уверены, что этот способ вам подходит? В разделе Выбор способа подключения он сравнивается со способами только для браузера, которым SSH не нужен.

Настольное приложение на этом компьютере · Браузер через SSH-перенаправление ⟷ SSH ⟷ Сервер Linux или другой компьютер

Впервые сталкиваетесь с этим?
  • Хост: машина, на которой работает Octoboard и к которой вы хотите подключиться: сервер Linux либо другой Mac или компьютер с Windows.
  • Сервер: здесь — машина с Linux, на которую вы входите по сети, обычно арендованная, без собственного экрана.
  • SSH: стандартный шифрованный способ войти на другую машину и вводить на ней команды. Он встроен в macOS, Windows и Linux.
  • Терминал: окно, в которое вводят команды: Терминал в macOS, PowerShell в Windows.
  • SSH-перенаправление: команда SSH, которая делает так, что нечто на хосте появляется на вашем компьютере, и браузер может открыть это там.
  • Отпечаток (ключ хоста): короткий код, который идентифицирует SSH той или иной машины. Однократная проверка показывает, что вы подключились к нужной машине.
  • Файл ключа: файл, который выполняет вход вместо пароля. Некоторые провайдеры серверов выдают такой файл.
  • Способ войти на хост по SSH. Для сервера Linux адрес и имя пользователя сообщает его провайдер. Чтобы проверить, что вход работает, откройте Терминал (macOS) или PowerShell (Windows) и выполните команду ниже, подставив своё имя пользователя и адрес сервера. При первом входе на вопрос, доверять ли серверу, ответьте yes.

    Terminal window
    ssh <you>@<server>

    Если хост — Mac или компьютер с Windows, вход по SSH включается в его системных настройках; как это сделать, показано в разделе Другой компьютер в роли хоста.

  • Для сервера Linux — установленный и запущенный на нём Octoboard. Как это сделать, показано в разделе Установка › Сервер Linux. Серверная программа Octoboard octoboardd в приложении называется «служба».

  • Приложение Octoboard на этом компьютере для macOS или Windows, если вы не будете пользоваться только браузером.

  1. Войдите на сервер по SSH под тем пользователем, который запускает Octoboard, выполните эту команду и скопируйте строку, начинающуюся с octoboard+ssh://: это данные для подключения, по которым приложение узнаёт, куда и как подключаться.

    Terminal window
    octoboardd connection

    Если этот компьютер обращается к серверу по другому адресу или порту SSH, добавьте --host или --ssh-port в команду, чтобы она вывела правильные данные для подключения.

    QR-код, который она тоже выводит, содержит ту же строку. Пока его не сканирует ни одно приложение.

  2. В приложении Octoboard на этом компьютере откройте Удалённые устройства на панели слева или, в macOS, выберите Удалённо › Удалённые устройства в строке меню. В Windows также можно выбрать Удалённые устройства в системном меню окна или в списке переходов значка на панели задач.

  3. Нажмите Добавить удалённую службу, затем Вставить в разделе Данные для подключения, чтобы заполнить поля.

  4. В разделе Аутентификация выберите Пароль, если вы входите с паролем своей учётной записи. Выберите Файл ключа, если провайдер сервера выдал вам вместо этого файл ключа (часто его имя похоже на id_ed25519 или заканчивается на .pem), и укажите, где он лежит на этом компьютере.

  5. Нажмите Сохранить, затем Подключить. Если потребуется, введите пароль.

    Если вы вставили данные для подключения, вместе с ними пришла и идентичность сервера (его отпечаток), и приложение проверит её за вас. Если вы ввели адрес вручную, при первом подключении приложение покажет отпечаток. Чтобы убедиться, что вы подключились к нужной машине, сравните его с тем, который эта команда выводит на сервере, и подключайтесь, только если они совпадают:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Всё получилось, если открылось отдельное окно Octoboard с проектами и сеансами сервера.

Можно подключиться и к Mac или компьютеру с Windows, на котором работает приложение Octoboard.

  1. На компьютере, к которому хотите подключиться, откройте в Octoboard раздел Настройки › Удалённый доступ.
  2. Нажмите там Открыть Системные настройки (macOS) или Открыть Параметры (Windows) и включите Удалённый вход (macOS) или OpenSSH Server (Windows), следуя пути, который указан в строке, чтобы этот компьютер принимал входы по SSH. Для этого нужны права администратора. Вернувшись в Octoboard, вы увидите в строке состояние Включён.
  3. Включите Разрешить удалённый доступ, нажмите Разрешить, чтобы подтвердить, и не закрывайте Octoboard: если вы выйдете из приложения, удалённый доступ прекратится.
  4. На вкладке Приложение Octoboard нажмите Копировать данные для подключения и отправьте их на другой компьютер, например по электронной почте или в мессенджере.
  5. На компьютере, с которого будете работать, добавьте хост так же, как в шагах 2–5 раздела Подключение к серверу Linux, вставив отправленные данные. Войдите с именем пользователя и паролем на хосте.

Всё получилось, если открылось отдельное окно с проектами и сеансами хоста.

  1. Получите команду SSH-перенаправления:

    • На хосте Mac или Windows сначала выполните шаги 1–3 раздела Другой компьютер в роли хоста. Затем на вкладке Браузер найдите Шаг 1: SSH-перенаправление. Нажмите на адрес в команде, чтобы выбрать, как другой компьютер будет обращаться к этому (или выберите Ввести адрес самостоятельно и позже замените <server>), затем нажмите Скопировать команду переадресации. Нажмите также Скопировать адрес в разделе Шаг 2: адрес для браузера.

    • На сервере Linux выполните на нём эту команду. Она выводит адрес для браузера, а затем команду SSH, которую нужно выполнить.

      Terminal window
      octoboardd address

      Замените <server> в команде адресом сервера.

  2. На компьютере, с которого будете открывать браузер, выполните команду SSH в Терминале (macOS) или PowerShell (Windows). Окно может запросить пароль, после чего больше ничего не покажет: это нормально. Пока работаете, оставьте его открытым: если закрыть окно, браузер отключится.

  3. Откройте в браузере адрес для браузера, который начинается с http://127.0.0.1:.

Всё получилось, если Octoboard открылся во вкладке браузера, не требуя входа.

Пользоваться этим адресом может только тот, кто имеет доступ к Octoboard через SSH-перенаправление. Держите его в тайне: его ключ даёт полный контроль, а сам адрес остаётся в истории и закладках браузера и синхронизируется с другими вашими устройствами, если включена синхронизация браузера.

  • «Не удалось связаться с сервером», либо команда SSH пишет «Connection refused» или не отвечает: вход по SSH на хосте выключен или неверны адрес либо порт SSH. Проверьте, что Удалённый вход или OpenSSH Server включён и что вы можете войти командой ssh выше.
  • «Не удалось войти» или «Permission denied»: неверны имя пользователя, пароль или файл ключа.
  • «Ключ хоста не совпадает»: отвечает не та машина, к которой вы подключались раньше. Так бывает после переустановки сервера, но это может означать и неполадку. Не продолжайте, пока не выясните причину.
  • Страница в браузере не загружается: окно SSH было закрыто или его команда остановилась. Выполните её снова и перезагрузите страницу.
  • Никаких лишних открытых портов: Octoboard принимает соединения только с самого хоста, поэтому, чтобы подключиться с другого компьютера, сначала нужно войти на хост по SSH. Поэтому вам нужен SSH или один из ретрансляторов.
  • Проверка того, к какой машине вы подключились: приложение запоминает ключ хоста — идентичность SSH этой машины — при первом успешном подключении и блокирует соединение с предупреждением, если эта идентичность позже изменится.
  • Пароль не хранится: после первого входа с паролем или своим файлом ключа приложение создаёт для этого компьютера отдельный ключ SSH, который используется для последующих входов.
  • Как лишить компьютер доступа: удалите запись этого компьютера из списка разрешённых ключей SSH на хосте (~/.ssh/authorized_keys в Linux и macOS). Этот ключ больше не сможет войти; уже открытое соединение сохранится до своего завершения.
  • Одно окно на каждый адрес назначения SSH: подключения с другим именем пользователя, хостом или портом SSH открываются каждое в своём окне, поэтому их проекты, сеансы и уведомления никогда не смешиваются.
  • Состояние каждого подключения: откройте значок приложения в строке меню в macOS или в области уведомлений в Windows, чтобы увидеть вкладку для каждого подключения.
  • Удалённые сайты открываются здесь: когда агент запускает на хосте сайт, нажмите выданную им ссылку localhost, и приложение откроет этот сайт на этом компьютере через SSH.
  • Удалённые файлы открываются здесь: просматривайте файл в удалённом окне или скачайте его копию, чтобы открыть в приложении этого компьютера, назначенном для такого файла.
  • Автоматическое переподключение: если сеть пропадёт, окно продолжает пытаться подключиться, пока не получится или пока вы его не закроете.