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 установка занимает две команды:
Команда tailscale serve
Команда tailscale serve делает локальный сервис доступным только внутри вашей сети (документация Serve). Она проксирует только адреса на 127.0.0.1, а для проброса порта не нужны права root (справочник CLI).
Перед первым запуском в сети должны быть включены HTTPS-сертификаты, а для них нужен MagicDNS. Если сертификаты выключены, команда покажет ссылку, по которой их включают в браузере. При выпуске сертификата имя компьютера попадает в публичный журнал Certificate Transparency, поэтому в именах машин не должно быть секретов (документация по сертификатам).
Порт 3000 публикуется одной командой:
Без флага --bg команда работает на переднем плане. С флагом она остаётся в фоне и возобновляется после перезагрузки компьютера и после переподключения Tailscale. В результате вы получаете адрес вида https://имя-компьютера.имя-сети.ts.net/, где первая часть совпадает с именем компьютера, а вторая с именем вашей сети.
Текущее состояние и сброс настроек доступны через две подкоманды:
Кто может открыть ссылку: localhost, Serve и Funnel
У Tailscale есть вторая команда, tailscale funnel, и результат у неё противоположный: Funnel открывает сервис публичному интернету. Разницу между тремя способами стоит зафиксировать до того, как агент получит право публиковать порты.
- localhost. Открывает только компьютер, на котором запущен сервер. Подходит для проверки на том же компьютере, где работает агент.
- tailscale serve. Открывают устройства вашей сети Tailscale, которым доступ разрешён правилами ACL. Подходит для приёмки работы агента с телефона и с других компьютеров команды.
- tailscale funnel. Открывает публичный интернет. Только для осознанной публикации наружу, не для внутренних превью.
Для проверки работы агента мы рекомендуем Serve, а Funnel оставляем решением, которое принимает человек, а не агент.
Правило для агента
Агенту нужно один раз записать в память, какой адрес вы ждёте. Мы используем такую формулировку:
Правило требует от агента опубликовать страницу через tailscale serve, самому открыть ссылку и убедиться, что она работает, и только после этого прислать её вам. Файл для записи зависит от агента:
- Claude Code: ~/.claude/CLAUDE.md для всех проектов, ./CLAUDE.md или ./.claude/CLAUDE.md для одного проекта.
- Codex: ~/.codex/AGENTS.md для всех проектов или AGENTS.md в корне репозитория.
Как это выглядит в работе команды
Мы пользуемся этой схемой в собственной работе: задачи агентам ставятся с нескольких компьютеров и с телефона, а сами агенты работают в том числе на удалённом сервере, как описано в статье «Как работать с Claude Code на зарубежном VPS». Агент присылает адрес в сети Tailscale, он открывается в браузере телефона, и на экране видна именно та страница, которую агент просит проверить. Это может быть превью страницы сайта, страница с результатами проверки или внутренняя панель.
В команде тот же адрес открывает коллега, если его устройство подключено к сети компании. К Serve применяются правила управления доступом (ACL), поэтому администратор сети определяет, каким пользователям и устройствам доступны страницы агента. Руководитель отдела может открыть превью с телефона, сервис при этом не выставлен в интернет, а круг зрителей задан правилами, а не тем, кому переслали ссылку.
Ограничения схемы
Мы описываем схему как её пользователи, и у неё есть границы, которые стоит знать до внедрения.
- Ссылка работает, пока работает источник. Она открывается, только когда компьютер с агентом онлайн, подключён к Tailscale и на нём запущен сервер разработки.
- Serve предназначен для своих. Команда делает сервис доступным только внутри вашей сети, поэтому показ страницы клиенту или подрядчику вне сети требует отдельного решения.
- Имена машин публичны. Они попадают в журнал Certificate Transparency при выпуске HTTPS-сертификата.
- Бесплатный тариф не для компании. Personal разрешён только для некоммерческого использования, рабочая команда оплачивает Standard.
- Правило в памяти агента остаётся инструкцией, а не гарантией. Содержимое страницы всё равно проверяет человек.
Итог
Адрес localhost годится для одного компьютера, а приёмка работы агента в компании идёт с нескольких устройств и у нескольких людей. Клиент Tailscale на устройствах команды, команда tailscale serve --bg 3000 и одно правило в памяти агента заменяют localhost адресом, который открывается внутри вашей сети и закрыт для интернета. Перед тем как подключать команду, проверьте две вещи: тариф должен быть коммерческим, а правила ACL должны описывать, кто видит страницы агента.
Статья впервые опубликована в блоге Кельвы: кельва.рф/blog/tailscale-vmesto-localhost. Там же список источников и ответы на частые вопросы.