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

Браузер через Tailscale

Откройте Octoboard в браузере на другом компьютере через вашу собственную сеть Tailscale, без SSH и удалённого рабочего стола. Хост — это компьютер, на котором работает Octoboard: Mac, компьютер с Windows или сервер Linux с octoboardd. Вход по SSH (Удалённый вход в macOS) может оставаться выключенным.

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

Браузер на вашем компьютере → ретранслятор на вашем компьютере (127.0.0.1) ⟷ Tailscale ⟷ ретранслятор на хосте (127.0.0.1) → Octoboard

Впервые сталкиваетесь с этим?
  • Tailscale: сервис, который объединяет ваши устройства в частную сеть через интернет, где бы они ни находились. Вы входите в него со своим аккаунтом.
  • Tailnet: ваша сеть Tailscale: устройства, вошедшие в ваш аккаунт Tailscale.
  • 127.0.0.1 (loopback): адрес, который всегда означает «этот же компьютер».
  • Порт: число, которое выбирает одну программу на компьютере, как номер двери. 127.0.0.1:3369 — это порт 3369 на этом компьютере.
  • socat: небольшая бесплатная программа, которая передаёт соединение из одного места в другое. Здесь она служит ретранслятором.
  • Tailscale Serve: команда Tailscale, которая открывает порт только для вашего tailnet. Её родственная функция Tailscale Funnel открыла бы его для всего интернета; здесь её нельзя использовать никогда.
  • Терминал: окно, в которое вводят команды: Терминал в macOS, PowerShell в Windows.

В целях безопасности Octoboard принимает только тот браузер, который открывает его по адресу 127.0.0.1 — адресу, который всегда означает «этот же компьютер» (его также называют loopback). Поэтому просто ввести в браузере адрес хоста в Tailscale нельзя. Вместо этого вы запускаете небольшую программу-ретранслятор на каждом компьютере: на вашем она делает так, что хост выглядит локальным по адресу 127.0.0.1; на хосте она передаёт соединение в Octoboard. Трафик между ними переносит Tailscale.

  • Tailscale на обоих компьютерах, с входом в один и тот же tailnet. Используйте tailnet, в котором только ваши устройства: любое устройство, которое он допускает к хосту, получает доступ к открытому вами порту.

  • socat на каждом компьютере, который является Mac или работает под Linux. Компьютеру с Windows он не нужен.

    Сначала установите Homebrew, если его нет (в macOS нет инструмента, который мог бы выполнить эту работу), затем выполните в Терминале:

    Terminal window
    brew install socat
  • Два или три окна, оставленные открытыми, пока вы работаете: ретранслятор и Tailscale Serve на хосте (кроме ретранслятора в Windows) и ретранслятор на вашем компьютере (кроме Windows).

  1. Получите адрес для браузера: в нём есть ключ, по которому браузер входит.

    В Octoboard откройте Настройки › Удалённый доступ, включите Разрешить удалённый доступ и нажмите Разрешить, чтобы подтвердить. Под переключателем появятся две вкладки. На вкладке Браузер в разделе Шаг 2: адрес для браузера нажмите Скопировать адрес.

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

    Пропустите Шаг 1: SSH-перенаправление. В настройках приложения SSH упоминается в нескольких местах; здесь это можно не учитывать, потому что в этой инструкции нужен только адрес для браузера.

    Не закрывайте Octoboard: если вы выйдете из приложения, удалённый доступ прекратится.

  2. Запустите ретранслятор на хосте, который соединяет порт на 127.0.0.1 хоста с Octoboard. Этот порт — порт хоста в шагах ниже.

    Выполните это в Терминале и оставьте окно открытым. Ретранслятор слушает только 127.0.0.1:3370.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    Порт хоста — 3370.

  3. Откройте порт хоста для своего tailnet с помощью Tailscale Serve и оставьте окно открытым. Никогда не используйте Tailscale Funnel: он выставил бы порт в открытый интернет.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    Если у вас приложение Tailscale из App Store, выполняйте команду как /Applications/Tailscale.app/Contents/MacOS/Tailscale вместо tailscale. Если у вас автономное приложение, сначала установите команду в его настройках, в разделе CLI integration.

    Чтобы проверить, выполните в другом окне tailscale serve status: в списке должен быть порт хоста.

На компьютере, с которого вы открываете браузер

Заголовок раздела «На компьютере, с которого вы открываете браузер»
  1. Найдите хост в приложении Tailscale на этом компьютере и запомните его имя (например, my-mac) или адрес (число вида 100.x.y.z).

  2. Запустите ретранслятор на этом компьютере, который делает хост доступным здесь по адресу 127.0.0.1:3369. Если порт 3369 на этом компьютере уже занят, выберите другой порт и измените его также в адресе для браузера.

    В команде ниже замените <host> именем или адресом хоста, а <host port> — портом хоста.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    Например, для хоста Mac с именем my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    Выполните её в Терминале и оставьте окно открытым.

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

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

  • Страница не загружается: одно из окон было закрыто или его команда остановилась. Проверьте, что ретрансляторы и Tailscale Serve всё ещё работают и что tailscale serve status на хосте показывает порт хоста.
  • socat пишет «Address already in use»: этот порт занят на этом компьютере. Выберите другой порт; на своём компьютере измените его также в адресе для браузера.
  • Страница отклонена или пуста: проверьте, что вы открыли адрес на 127.0.0.1, а не по имени хоста в Tailscale или адресу 100.x.y.z.
  • Ретранслятор на хосте при открытии страницы пишет «Connection refused» или «No such file or directory»: выключено Разрешить удалённый доступ или Octoboard не запущен на хосте (в Linux — не запущен octoboardd).
  • На компьютере, с которого вы открывали браузер: остановите socat сочетанием Ctrl+C или, в Windows, удалите перенаправление в PowerShell, запущенном от имени администратора:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • На хосте: остановите команду Tailscale Serve и socat сочетанием Ctrl+C. Командой tailscale serve status убедитесь, что больше ничего не открыто; если порт всё ещё в списке, удалите его командой tailscale serve --tcp=3370 off (в Windows — tailscale serve --tcp=3369 off).

  • На хосте Mac или Windows выключите Разрешить удалённый доступ, когда он больше не нужен. Это закроет вход для браузера и отключит все страницы, открытые с этим ключом.

  • Если адрес мог утечь, выдайте ему новый ключ кнопкой Сменить ключ на вкладке Браузер или, в Linux, командой octoboardd address --rotate. Страницы, открытые по старому адресу, будут отключены.

  • Адрес — это пароль: его ключ даёт полный контроль над Octoboard на хосте, включая запуск любых команд. Он действует, пока вы его не смените. Адрес остаётся в истории и закладках браузера и синхронизируется с другими вашими устройствами, если включена синхронизация браузера.
  • Кто может добраться: любой, кто достигает порта хоста и знает ключ. Ретрансляторы слушают только 127.0.0.1, поэтому другие устройства в сети хоста или вашей локальной сети не могут к ним подключиться; Tailscale Serve делает порт хоста доступным только из вашего tailnet, в пределах его правил доступа.
  • Только на компьютерах, на которые больше никто не входит: другая учётная запись на хосте или на вашем компьютере может подключиться к этим портам 127.0.0.1, а пока ретранслятор не запущен, занять его порт и получить ключ, когда ваш браузер переподключится. Подключение по SSH не имеет этой слабости на хосте Mac или Linux, а ваш собственный компьютер её не имеет при работе в настольном приложении. В браузере у вашего компьютера она остаётся, потому что перенаправление SSH там тоже слушает порт 127.0.0.1.
  • Никогда не Funnel: Tailscale Funnel опубликовал бы порт для всего интернета.