Разница между Tailscale serve и funnel
Узнайте, в чем отличие Tailscale serve от funnel при публикации сервисов. Разберем, как открыть порт для публичного интернета и почему функция может быть заблокирована.
tailscale serve и funnel: кто может открыть URL
Разница между tailscale serve и tailscale funnel заключается только в аудитории. serve размещает HTTPS (hypertext transfer protocol secure) front end на локальном порту и публикует его только в вашем tailnet. funnel публикует тот же локальный порт во всём публичном Интернете через relay-серверы, которыми управляет Tailscale. Обе команды принимают одинаковые флаги и одинаковые цели. Между приватной панелью и панелью, доступной всему миру, стоит одно слово.
В обоих случаях вы получаете сертификат, которому браузеры уже доверяют, для имени, оканчивающегося на ts.net. При этом на firewall вашего VPS не требуется открывать входящий порт. Демон tailscaled уже поддерживает исходящее соединение с tailnet, поэтому трафик поступает через него. Подключение сервера к tailnet — отдельная задача. Для неё подходят запуск VPS как Tailscale exit node и реклама subnet router для приватной сети. Здесь рассматривается публикация сервиса, который уже подключён к tailnet.
Что необходимо для работы команд
- Tailscale версии 1.52 или новее на VPS, с выполненным входом в tailnet. Сама функция Funnel появилась в версии 1.38.3, но команды serve и funnel были изменены в 1.52, и все команды в этом руководстве используют новый синтаксис. Проверьте версию с помощью
tailscale versionиtailscale status. - Включенный MagicDNS. MagicDNS — это встроенная в Tailscale система доменных имен (DNS), которая присваивает машине имя вида
blog-vps.your-tailnet.ts.netвместо использования только100.xадреса. - Включенные HTTPS-сертификаты для tailnet на странице DNS в консоли администратора. Без этого у вас не будет сертификата для защиты порта.
- Только для
funnel: атрибут узлаfunnelв файле политики tailnet. Именно здесь у большинства возникают первые трудности, ниже это описано подробнее.
Все команды здесь начинаются с sudo, так как tailscaled обычно работает от имени root, и по умолчанию только root может управлять этой службой. Предоставьте одному пользователю право выполнять эти команды без sudo, назначив его оператором:
sudo tailscale set --operator=$USERПубликация в tailnet с помощью tailscale serve
Укажите serve локальный порт, и остальное будет настроено автоматически.
sudo tailscale serve 3000Available within your tailnet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.Команда 3000 является сокращённой формой http://127.0.0.1:3000. Tailscale прослушивает порт 443 на tailnet-адресе машины, завершает TLS (защита транспортного уровня) с сертификатом ts.net и передаёт обычный HTTP на локальный порт. Приложению не нужно знать о существовании сертификата. Это основная причина использовать такой вариант перед панелью администрирования, которую иначе пришлось бы оставить доступной по обычному HTTP. Очевидный кандидат — веб-интерфейс, который привязан только к 127.0.0.1. Хороший пример — веб-интерфейс dsh на порту 3080. Вместо того чтобы каждый раз создавать SSH-туннель, когда он нужен, один раз укажите serve порт 3080 и подключайтесь к интерфейсу с любого устройства в tailnet.
Теперь обратите внимание на последнюю строку: Press Ctrl+C to exit. Команда выполняется в foreground, а сопоставление действует только внутри этого процесса. Закройте терминал — URL перестанет работать, потому что конфигурация не была записана на диск. Добавьте --bg, и сопоставление будет сохранено в конфигурации serve узла. Она сохраняется после закрытия терминала и перезагрузки.
sudo tailscale serve --bg 3000Serve поддерживает не только номер порта. --set-path публикует сервис по подмаршруту, поэтому несколько приложений могут использовать одно имя хоста:
sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090В качестве цели можно также указать каталог со статическими файлами или backend, который уже использует TLS с сертификатом, проверку которого вы не хотите выполнять:
sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443Команда поддерживает не только HTTP. --tcp=<port> передаёт необработанный поток TCP (протокол управления передачей), а --tls-terminated-tcp=<port> завершает TLS на вашем узле и передаёт дальше открытый текст. Так перед сервисом, который вообще не поддерживает HTTP, можно разместить доверенный сертификат:
sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899Почему funnel сообщает, что атрибут узла не задан?
По умолчанию функция funnel отключена для всей tailnet. При первом запуске выводится это сообщение, после чего работа прекращается:
Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.Команда была верной. Политика tailnet не предоставила этому узлу разрешение на публикацию, поэтому клиент отклоняет запрос до обращения к реле. Отредактируйте файл политики tailnet в консоли администратора в разделе Access Controls и добавьте атрибут:
"nodeAttrs": [
{
"target": ["autogroup:member"],
"attr": ["funnel"],
},
],autogroup:member предоставляет это право всем участникам tailnet. Если публиковать сервисы должен только один компьютер, присвойте ему тег и укажите этот тег в качестве цели, например tag:public. Сохраните политику и снова выполните команду funnel.
Если ваша учетная запись позволяет редактировать политику tailnet (роли Owner, Admin или Network admin), в новых версиях клиентов доступен быстрый способ: CLI выводит URL-адрес страницы подтверждения, и при его одобрении автоматически создаются HTTPS-сертификаты и добавляется нужный атрибут. Если у вас нет одной из этих ролей, этот URL вам не поможет. Внести изменения должен пользователь с доступом к политике.
Публикация в интернете с помощью tailscale funnel
После того как атрибут задан, используйте уже известную вам команду с другим глаголом.
sudo tailscale funnel --bg 3000Available on the internet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.Внимательно читайте первую строку каждый раз. Available within your tailnet и Available on the internet — единственное видимое различие между частным и публичным сервисом, а команды для их создания различаются всего на одно слово.
По состоянию на октябрь 2026 года funnel прослушивает только порты 443, 8443 или 10000. По умолчанию используется 443, а --https=8443 или --https=10000 являются альтернативами. Любой другой порт будет отклонен, так как реле funnel принимают соединения только на этих портах. Именно поэтому URL-адрес funnel — это всегда либо просто имя хоста, либо имя хоста с добавленными в конце :8443 или :10000.
Как проверить, что сейчас опубликовано?
Предположения приводят к тому, что панель управления месяц остаётся доступной из Интернета. Вместо этого запросите состояние у узла.
tailscale serve status
tailscale funnel status
tailscale serve status --jsonОбе команды отображения состояния читают один и тот же файл конфигурации, поэтому любая из них показывает полную картину. Используйте форму --json в скрипте или запланированной проверке, потому что обычный вывод предназначен для чтения пользователем. Если ничего не настроено, вы получите одну строку:
No serve configЕсли после настройки, которая должна была сработать, вы видите такой вывод, значит, сопоставление было создано в интерактивном режиме, а процесс завершился. Создайте его снова с помощью --bg.
Чтобы удалить одно сопоставление, повторите команду, которая его создала, и добавьте в конец off. Чтобы удалить все сопоставления serve и funnel на узле, используйте reset.
sudo tailscale funnel --https=443 3000 off
sudo tailscale serve resetПосле любого из этих действий снова выполните tailscale serve status и проверьте, что осталось, вместо того чтобы предполагать, что команда сделала именно то, что вы хотели.
Преимущества и недостатки
Преимущества очевидны, именно поэтому пользователи выбирают этот метод вместо обратного прокси-сервера (reverse proxy).
- Сертификат, которому доверяют браузеры, обновляется автоматически. Не нужно устанавливать ACME-клиент и следить за задачами по обновлению.
- Не нужно открывать входящие порты на брандмауэре VPS.
tailscaledустанавливает исходящие соединения, поэтому стандартный брандмауэр ufw с политикой запрета по умолчанию на вашем VPS останется таким же защищенным. - Не нужно покупать DNS-записи, настраивать их или ждать обновления.
- Не требуется проброс портов (port forwarding), что является единственным решением для машин за NAT, в отличие от VPS с публичным IP-адресом.
Недостатки также существенны, и Funnel обладает всеми ими.
- Имя принадлежит не вам. Публичные пользователи видят
host.your-tailnet.ts.net. Funnel не поддерживает пользовательские домены, поэтому вы не сможете использоватьapp.example.com. - Путь трафика не под вашим контролем. Трафик сначала попадает на ретранслятор Tailscale, который проксирует поток к вашему узлу через tailnet. Tailscale заявляет, что трафик Funnel ограничен по пропускной способности, но документация не приводит конкретных цифр, поэтому измерьте производительность самостоятельно, прежде чем полагаться на этот сервис.
- Отсутствие инструментов управления. Обратный прокси-сервер дает вам доступ к логам, ограничению частоты запросов (rate limits), лимитам размера запросов и возможности настроить аутентификацию. Funnel предоставляет только URL. Все остальное должно быть реализовано внутри вашего приложения.
- Список портов ограничен, как указано выше.
Обе функции зависят от инфраструктуры Tailscale: выдача сертификатов для имени ts.net и сами ретрансляторы Funnel. Решение о том, допустима ли такая зависимость, зависит от того, что эти серверы могут делать с вашим трафиком, что подробно описано в модели доверия Tailscale. Использование обеих функций бесплатно: Tailscale указывает Funnel как доступный на всех тарифных планах, документация по Serve не упоминает ограничений по тарифам, а бесплатный план включает до шести пользователей с неограниченным количеством устройств на каждого. Седьмой пользователь — обычная причина перехода на платный тариф, хотя некоторые функции, такие как SCIM (система управления идентификацией между доменами) и логи сетевых потоков, требуют платного тарифа при любом количестве пользователей. После этого порога оплата зависит от количества пользователей, а не машин, поэтому стоит изучить стоимость tailnet на платном тарифе, прежде чем делать serve или funnel критически важными компонентами. Если вы рассматриваете самостоятельно развернутый сервер управления Headscale, не предполагайте, что эти функции будут работать автоматически. Проверьте примечания к выпуску для той версии Headscale, которую планируете использовать.
Какой вариант использовать?
Правило простое.
Используйте serve для всего внутреннего: административных интерфейсов, панелей мониторинга, интерфейса метрик, который не должен индексироваться, и промежуточной копии сайта. Членство в tailnet — это контроль доступа, и он работает хорошо. Устройство, не подключённое к tailnet, не сможет даже разрешить это имя.
Используйте funnel для демонстрационной ссылки, приёмника webhook, на который сторонняя система должна отправлять запросы POST, или callback OAuth во время разработки. Это самый быстрый способ получить общедоступный URL HTTPS, а одной командой off его можно отключить. Но общедоступный означает именно общедоступный: имя хоста не является секретом, а funnel перед приложением без аутентификации превращает его в открытый сервис. Всё, что находится за ним, должно самостоятельно проверять подлинность запросов с такой же тщательностью, какая требуется для доступной из Интернета конечной точки Ollama.
Для всего, что вы считаете production-средой, используйте полноценный reverse proxy. Ваш домен, ваш сертификат, ваши журналы, ваши ограничения частоты запросов — и никаких посторонних участников в цепочке обработки запроса. В материале Сравнение nginx, Caddy и Traefik в качестве reverse proxy рассматривается выбор подходящего решения.
Типичные ошибки и сообщения системы
Funnel отказывается запускаться. Funnel not available; "funnel" node attribute not set. — это проблема политики, а не команды. Добавьте атрибут funnel в файл политики tailnet, сохраните его и повторите попытку.
Все работало, но теперь tailscale serve status выдает No serve config. Отображение было создано в интерактивном режиме, и этот процесс завершился. Запустите ту же команду с флагом --bg.
Имя разрешается, но ответа нет. Serve проксирует запросы к указанной цели, поэтому если там ничего не слушает, проксировать некуда. Проверьте с помощью ss -ltnp | grep 3000 на той же машине, где запущен tailscaled. Частая причина — контейнер публикует порт на адресе Docker bridge вместо 127.0.0.1, из-за чего хост не видит слушающий процесс там, где вы его ожидаете. Принципы работы сети в Docker Compose объясняют, где фактически оказывается опубликованный порт. Если приложение уже работает в Compose, добавление Tailscale в стек в качестве sidecar-контейнера устраняет эту неопределенность, так как контейнер получает собственное имя в tailnet и вообще не публикует порты на хосте.
Ошибки сертификата для имени ts.net. Скорее всего, HTTPS-сертификаты не включены для tailnet. Включите их в консоли администратора, а затем выполните этап получения сертификата отдельно, чтобы его ошибки не смешивались с выводом serve:
sudo tailscale cert your-host.your-tailnet.ts.netFunnel работает через мобильный интернет, но ведет себя иначе, чем на ноутбуке. Ваш ноутбук находится в tailnet, поэтому MagicDNS разрешает имя в 100.x адрес, и вы обращаетесь к сервису через tailnet, не затрагивая ретранслятор Funnel. Это корректное поведение, означающее, что ваш ноутбук не может проверить публичную доступность. Используйте curl с машины, которая не находится в tailnet.
FAQ
В чем разница между tailscale serve и tailscale funnel?
Кто может получить доступ к результату. tailscale serve публикует локальный порт по HTTPS URL, доступному только устройствам в вашем tailnet. tailscale funnel публикует тот же порт по URL, доступному всем пользователям Интернета, через relay-серверы, которыми управляет Tailscale. Флаги и цели у этих команд общие. Первая строка вывода показывает, какой режим выбран: Available within your tailnet или Available on the internet.
Почему tailscale funnel сообщает, что атрибут node не задан?
Потому что funnel отключен для tailnet, пока кто-либо его не включит. Это сообщение имеет вид Funnel not available; "funnel" node attribute not set. и формируется вашим клиентом до обращения к relay-серверу. Добавьте запись nodeAttrs, которая предоставляет атрибут funnel узлу autogroup:member или тегу, если публиковать должен только один компьютер, в файл политики tailnet в разделе Access Controls. Администратор tailnet также может открыть URL подтверждения, который выводит CLI.
Какие порты может использовать Tailscale Funnel?
Только 443, 8443 и 10000. По умолчанию используется 443. Другой порт можно выбрать с помощью --https=8443 или --https=10000. Это ограничение relay-серверов funnel, а не вашего сервера, поэтому изменения в firewall или конфигурации VPS его не снимают. Для tailscale serve такого ограничения нет, поскольку трафик не выходит за пределы вашего tailnet.
Сохраняется ли URL serve или funnel после перезагрузки?
Только если вы использовали --bg. Без этого флага команда работает в foreground, выводит Press Ctrl+C to exit., а mapping исчезает вместе с процессом. С --bg mapping записывается в конфигурацию serve узла и восстанавливается командой tailscaled после перезагрузки. Проверьте состояние с помощью tailscale serve status. Если ничего не настроено, команда выводит No serve config.
Безопасно ли оставлять funnel запущенным?
С точки зрения транспорта это безопасно: соединение использует HTTPS, и в firewall не открывается порт. Но в обычном смысле это небезопасно, поскольку URL является публичным, а значит, публичным становится и приложение за ним. Используйте funnel только перед приложением, которое самостоятельно проверяет запросы. После завершения демонстрации или теста webhook остановите funnel, добавив off к команде, с помощью которой он был создан.
Источники описания поведения команд выше: документация и справочник CLI для Tailscale Serve и Funnel на сайте tailscale.com/docs.