Tailscale вместо localhost: ссылки агента на любом устройстве

Tailscale вместо localhost: ссылки агента на любом устройстве

Команда tailscale serve публикует локальный порт компьютера внутри приватной сети Tailscale и выдаёт для него HTTPS-адрес в зоне ts.net. Страницу по этому адресу открывают только устройства вашей сети, из интернета она недоступна. Правило в памяти агента обязывает Claude Code или Codex присылать такой адрес вместо localhost, и результат работы агента можно проверить с телефона или с другого компьютера.

Когда команда ведёт проект с ИИ-агентом в Claude Code или Codex, агент постоянно присылает работу на проверку: превью страницы, внутреннюю панель, страницу с результатами проверки. Смотреть её нужно и за рабочим компьютером, и с телефона, поэтому нужен надёжный способ открыть присланное на любом устройстве команды. Ссылка вида localhost:3000, которую агент присылает по умолчанию, открывается только на машине, где он работает. Задачу решают приватная сеть Tailscale, команда tailscale serve и одно правило в памяти агента.

Почему адрес localhost открывается только на одном компьютере

Имя localhost указывает на тот же компьютер, с которого сделан запрос. Когда сервер разработки запущен на рабочей станции или на удалённом сервере, телефон по этому адресу обращается к самому себе и страницу не находит. Агент при этом работает на том же компьютере, что и сервер, поэтому для него адрес localhost рабочий.

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

Что такое Tailscale и какой тариф нужен компании

Tailscale строит приватную сеть между вашими устройствами поверх протокола WireGuard. Такая сеть в терминах Tailscale называется tailnet: в неё входят компьютеры, серверы и телефоны, на которых установлен клиент и выполнен вход в вашу сеть. Отдельных логинов и паролей у сервиса нет, вход идёт через провайдера учётных записей: Google, Microsoft, GitHub, Apple, Okta, OneLogin, собственный OIDC или passkeys (документация Tailscale).

Бесплатный тариф Personal стоит 0 долларов и допускает до 6 пользователей с неограниченным числом их устройств (страница тарифов). Лимит пользователей на нём подняли с 3 до 6 с 8 апреля 2026 года (блог Tailscale).

Важно. Тариф Personal предназначен только для некоммерческого использования, это прямо указано в разделе вопросов на странице тарифов Tailscale. Компании для рабочих задач нужен тариф Standard за 8 долларов за пользователя в месяц, следующий уровень Premium стоит 18 долларов. Бесплатный тариф подходит, чтобы попробовать схему на личных устройствах, но не для работы команды.

Установка на компьютеры и телефоны

Клиент ставится на каждое устройство, с которого вы хотите открывать ссылки агента, и на компьютер, где агент работает. На всех устройствах вход выполняется в одну и ту же сеть.

  • macOS. Отдельный установщик .pkg с сайта Tailscale (рекомендуемый вариант) или версия из Mac App Store. Не ставьте обе версии на один Mac (варианты для macOS).
  • Windows. Установщик с сайта tailscale.com. Вход выполняется через провайдера учётных записей, отдельного пароля Tailscale нет.
  • Linux. Скрипт установки, команды ниже. Команда sudo tailscale up печатает ссылку для входа.
  • iOS и Android. Приложение Tailscale. Войдите в ту же сеть и оставьте подключение включённым.

На Linux установка занимает две команды:

curl -fsSL https://tailscale.com/install.sh | sh sudo tailscale up

Команда tailscale serve

Команда tailscale serve делает локальный сервис доступным только внутри вашей сети (документация Serve). Она проксирует только адреса на 127.0.0.1, а для проброса порта не нужны права root (справочник CLI).

Перед первым запуском в сети должны быть включены HTTPS-сертификаты, а для них нужен MagicDNS. Если сертификаты выключены, команда покажет ссылку, по которой их включают в браузере. При выпуске сертификата имя компьютера попадает в публичный журнал Certificate Transparency, поэтому в именах машин не должно быть секретов (документация по сертификатам).

Порт 3000 публикуется одной командой:

tailscale serve --bg 3000

Без флага --bg команда работает на переднем плане. С флагом она остаётся в фоне и возобновляется после перезагрузки компьютера и после переподключения Tailscale. В результате вы получаете адрес вида https://имя-компьютера.имя-сети.ts.net/, где первая часть совпадает с именем компьютера, а вторая с именем вашей сети.

Текущее состояние и сброс настроек доступны через две подкоманды:

tailscale serve status tailscale serve reset
Агент публикует порт командой tailscale serve и присылает адрес в зоне ts.net. Его открывают устройства вашей сети, из интернета страница недоступна.
Агент публикует порт командой tailscale serve и присылает адрес в зоне ts.net. Его открывают устройства вашей сети, из интернета страница недоступна.

Кто может открыть ссылку: localhost, Serve и Funnel

У Tailscale есть вторая команда, tailscale funnel, и результат у неё противоположный: Funnel открывает сервис публичному интернету. Разницу между тремя способами стоит зафиксировать до того, как агент получит право публиковать порты.

  • localhost. Открывает только компьютер, на котором запущен сервер. Подходит для проверки на том же компьютере, где работает агент.
  • tailscale serve. Открывают устройства вашей сети Tailscale, которым доступ разрешён правилами ACL. Подходит для приёмки работы агента с телефона и с других компьютеров команды.
  • tailscale funnel. Открывает публичный интернет. Только для осознанной публикации наружу, не для внутренних превью.

Для проверки работы агента мы рекомендуем Serve, а Funnel оставляем решением, которое принимает человек, а не агент.

Правило для агента

Агенту нужно один раз записать в память, какой адрес вы ждёте. Мы используем такую формулировку:

Any time you give me a link to something running on this computer (a preview, a review page, a dashboard), give me a Tailscale link, never localhost. I work across several computers and my phone. Publish it with tailscale serve, open the link yourself to check it works, then send it.

Правило требует от агента опубликовать страницу через tailscale serve, самому открыть ссылку и убедиться, что она работает, и только после этого прислать её вам. Файл для записи зависит от агента:

  • Claude Code: ~/.claude/CLAUDE.md для всех проектов, ./CLAUDE.md или ./.claude/CLAUDE.md для одного проекта.
  • Codex: ~/.codex/AGENTS.md для всех проектов или AGENTS.md в корне репозитория.

Как это выглядит в работе команды

Мы пользуемся этой схемой в собственной работе: задачи агентам ставятся с нескольких компьютеров и с телефона, а сами агенты работают в том числе на удалённом сервере, как описано в статье «Как работать с Claude Code на зарубежном VPS». Агент присылает адрес в сети Tailscale, он открывается в браузере телефона, и на экране видна именно та страница, которую агент просит проверить. Это может быть превью страницы сайта, страница с результатами проверки или внутренняя панель.

В команде тот же адрес открывает коллега, если его устройство подключено к сети компании. К Serve применяются правила управления доступом (ACL), поэтому администратор сети определяет, каким пользователям и устройствам доступны страницы агента. Руководитель отдела может открыть превью с телефона, сервис при этом не выставлен в интернет, а круг зрителей задан правилами, а не тем, кому переслали ссылку.

Ограничения схемы

Мы описываем схему как её пользователи, и у неё есть границы, которые стоит знать до внедрения.

  1. Ссылка работает, пока работает источник. Она открывается, только когда компьютер с агентом онлайн, подключён к Tailscale и на нём запущен сервер разработки.
  2. Serve предназначен для своих. Команда делает сервис доступным только внутри вашей сети, поэтому показ страницы клиенту или подрядчику вне сети требует отдельного решения.
  3. Имена машин публичны. Они попадают в журнал Certificate Transparency при выпуске HTTPS-сертификата.
  4. Бесплатный тариф не для компании. Personal разрешён только для некоммерческого использования, рабочая команда оплачивает Standard.
  5. Правило в памяти агента остаётся инструкцией, а не гарантией. Содержимое страницы всё равно проверяет человек.

Итог

Адрес localhost годится для одного компьютера, а приёмка работы агента в компании идёт с нескольких устройств и у нескольких людей. Клиент Tailscale на устройствах команды, команда tailscale serve --bg 3000 и одно правило в памяти агента заменяют localhost адресом, который открывается внутри вашей сети и закрыт для интернета. Перед тем как подключать команду, проверьте две вещи: тариф должен быть коммерческим, а правила ACL должны описывать, кто видит страницы агента.

Статья впервые опубликована в блоге Кельвы: кельва.рф/blog/tailscale-vmesto-localhost. Там же список источников и ответы на частые вопросы.