Подключение по 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, если вы не будете пользоваться только браузером.
Подключение к серверу Linux
Заголовок раздела «Подключение к серверу Linux»-
Войдите на сервер по SSH под тем пользователем, который запускает Octoboard, выполните эту команду и скопируйте строку, начинающуюся с
octoboard+ssh://: это данные для подключения, по которым приложение узнаёт, куда и как подключаться.Terminal window octoboardd connectionЕсли этот компьютер обращается к серверу по другому адресу или порту SSH, добавьте
--hostили--ssh-portв команду, чтобы она вывела правильные данные для подключения.QR-код, который она тоже выводит, содержит ту же строку. Пока его не сканирует ни одно приложение.
-
В приложении Octoboard на этом компьютере откройте Удалённые устройства на панели слева или, в macOS, выберите Удалённо › Удалённые устройства в строке меню. В Windows также можно выбрать Удалённые устройства в системном меню окна или в списке переходов значка на панели задач.
-
Нажмите Добавить удалённую службу, затем Вставить в разделе Данные для подключения, чтобы заполнить поля.
-
В разделе Аутентификация выберите Пароль, если вы входите с паролем своей учётной записи. Выберите Файл ключа, если провайдер сервера выдал вам вместо этого файл ключа (часто его имя похоже на
id_ed25519или заканчивается на.pem), и укажите, где он лежит на этом компьютере. -
Нажмите Сохранить, затем Подключить. Если потребуется, введите пароль.
Если вы вставили данные для подключения, вместе с ними пришла и идентичность сервера (его отпечаток), и приложение проверит её за вас. Если вы ввели адрес вручную, при первом подключении приложение покажет отпечаток. Чтобы убедиться, что вы подключились к нужной машине, сравните его с тем, который эта команда выводит на сервере, и подключайтесь, только если они совпадают:
Terminal window ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
Всё получилось, если открылось отдельное окно Octoboard с проектами и сеансами сервера.
Другой компьютер в роли хоста
Заголовок раздела «Другой компьютер в роли хоста»Можно подключиться и к Mac или компьютеру с Windows, на котором работает приложение Octoboard.
- На компьютере, к которому хотите подключиться, откройте в Octoboard раздел Настройки › Удалённый доступ.
- Нажмите там Открыть Системные настройки (macOS) или Открыть Параметры (Windows) и включите Удалённый вход (macOS) или OpenSSH Server (Windows), следуя пути, который указан в строке, чтобы этот компьютер принимал входы по SSH. Для этого нужны права администратора. Вернувшись в Octoboard, вы увидите в строке состояние Включён.
- Включите Разрешить удалённый доступ, нажмите Разрешить, чтобы подтвердить, и не закрывайте Octoboard: если вы выйдете из приложения, удалённый доступ прекратится.
- На вкладке Приложение Octoboard нажмите Копировать данные для подключения и отправьте их на другой компьютер, например по электронной почте или в мессенджере.
- На компьютере, с которого будете работать, добавьте хост так же, как в шагах 2–5 раздела Подключение к серверу Linux, вставив отправленные данные. Войдите с именем пользователя и паролем на хосте.
Всё получилось, если открылось отдельное окно с проектами и сеансами хоста.
Из браузера
Заголовок раздела «Из браузера»-
Получите команду SSH-перенаправления:
-
На хосте Mac или Windows сначала выполните шаги 1–3 раздела Другой компьютер в роли хоста. Затем на вкладке Браузер найдите Шаг 1: SSH-перенаправление. Нажмите на адрес в команде, чтобы выбрать, как другой компьютер будет обращаться к этому (или выберите Ввести адрес самостоятельно и позже замените
<server>), затем нажмите Скопировать команду переадресации. Нажмите также Скопировать адрес в разделе Шаг 2: адрес для браузера. -
На сервере Linux выполните на нём эту команду. Она выводит адрес для браузера, а затем команду SSH, которую нужно выполнить.
Terminal window octoboardd addressЗамените
<server>в команде адресом сервера.
-
-
На компьютере, с которого будете открывать браузер, выполните команду SSH в Терминале (macOS) или PowerShell (Windows). Окно может запросить пароль, после чего больше ничего не покажет: это нормально. Пока работаете, оставьте его открытым: если закрыть окно, браузер отключится.
-
Откройте в браузере адрес для браузера, который начинается с
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. - Удалённые файлы открываются здесь: просматривайте файл в удалённом окне или скачайте его копию, чтобы открыть в приложении этого компьютера, назначенном для такого файла.
- Автоматическое переподключение: если сеть пропадёт, окно продолжает пытаться подключиться, пока не получится или пока вы его не закроете.