Браузер через 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Ничего устанавливать не нужно: хост с Windows уже отдаёт браузеру порт на
127.0.0.1, а компьютер с Windows, с которого вы открываете браузер, использует встроенную команду.Terminal window sudo apt install socatЕсли в вашем дистрибутиве не
apt, используйте его менеджер пакетов (dnf,pacmanи так далее). -
Два или три окна, оставленные открытыми, пока вы работаете: ретранслятор и Tailscale Serve на хосте (кроме ретранслятора в Windows) и ретранслятор на вашем компьютере (кроме Windows).
На хосте
Заголовок раздела «На хосте»-
Получите адрес для браузера: в нём есть ключ, по которому браузер входит.
В Octoboard откройте Настройки › Удалённый доступ, включите Разрешить удалённый доступ и нажмите Разрешить, чтобы подтвердить. Под переключателем появятся две вкладки. На вкладке Браузер в разделе Шаг 2: адрес для браузера нажмите Скопировать адрес.
Передайте адрес на другой компьютер так, чтобы его видели только вы, например заметкой для самого себя: он работает как пароль.
Пропустите Шаг 1: SSH-перенаправление. В настройках приложения SSH упоминается в нескольких местах; здесь это можно не учитывать, потому что в этой инструкции нужен только адрес для браузера.
Не закрывайте Octoboard: если вы выйдете из приложения, удалённый доступ прекратится.
В Octoboard откройте Настройки › Удалённый доступ, включите Разрешить удалённый доступ и нажмите Разрешить, чтобы подтвердить. Под переключателем появятся две вкладки. На вкладке Браузер в разделе Шаг 2: адрес для браузера нажмите Скопировать адрес. Запишите также число в поле Порт браузера.
Передайте адрес на другой компьютер так, чтобы его видели только вы, например заметкой для самого себя: он работает как пароль.
Пропустите Шаг 1: SSH-перенаправление. В настройках приложения SSH упоминается в нескольких местах; здесь это можно не учитывать, потому что в этой инструкции нужен только адрес для браузера.
Не закрывайте Octoboard: если вы выйдете из приложения, удалённый доступ прекратится.
Выполните это под тем пользователем, под которым работает octoboardd, и скопируйте выведенный адрес, начинающийся с
http://127.0.0.1:3369/. Команду SSH, которую она выводит после адреса, пропустите.Terminal window octoboardd address -
Запустите ретранслятор на хосте, который соединяет порт на
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.Запускать ничего не нужно: сам Octoboard слушает порт браузера, и только на
127.0.0.1. Порт хоста — это Порт браузера (3369, если вы его не меняли).Выполните это под тем же пользователем, в терминале или сеансе
tmux, который остаётся открытым. Ретранслятор слушает только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. -
Откройте порт хоста для своего 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.В PowerShell или командной строке:
Terminal window tailscale serve --tcp=3369 tcp://127.0.0.1:3369Если вы меняли Порт браузера, укажите свой порт.
Terminal window tailscale serve --tcp=3370 tcp://127.0.0.1:3370Если Tailscale сообщает, что у вас недостаточно прав, один раз разрешите своему пользователю управлять им командой
sudo tailscale set --operator="$USER"или выполните команду сsudo.Чтобы проверить, выполните в другом окне
tailscale serve status: в списке должен быть порт хоста.
На компьютере, с которого вы открываете браузер
Заголовок раздела «На компьютере, с которого вы открываете браузер»-
Найдите хост в приложении Tailscale на этом компьютере и запомните его имя (например,
my-mac) или адрес (число вида100.x.y.z). -
Запустите ретранслятор на этом компьютере, который делает хост доступным здесь по адресу
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Выполните её в Терминале и оставьте окно открытым.
Откройте PowerShell от имени администратора. В команде ниже замените
<host IP>адресом хоста вида100.x.y.z(этой команде нужно именно число, имя не подойдёт), а<host port>— портом хоста.Terminal window netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=3369 connectaddress=<host IP> connectport=<host port>Это перенаправление остаётся на месте, в том числе после перезагрузок, пока вы его не удалите (см. ниже), поэтому окно держать открытым не нужно. Ему нужна служба IP Helper, которая по умолчанию запущена.
-
Откройте в браузере адрес, который вы скопировали на хосте. Он начинается с
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 опубликовал бы порт для всего интернета.