Что такое Headscale?

Headscale — это реализация сервера управления Tailscale с открытым исходным кодом, размещаемая на собственной инфраструктуре. Она позволяет запустить собственный сервер координации для приватной mesh-сети на основе WireGuard, чтобы ваши устройства могли безопасно подключаться друг к другу без зависимости от размещённой у Tailscale панели управления — при этом продолжая использовать стандартные клиенты Tailscale.

            🚀 Почему важны последние версии: Headscale развивается вместе с протоколом Tailscale, добавляя поддержку новых функций клиента, улучшения ACL и исправления стабильности. Использование последней версии обеспечивает совместимость с актуальными клиентами Tailscale.
        

⚡ Ключевые возможности Headscale

🔐 Self-hosted панель управления

Запускайте собственный сервер координации — без зависимости от стороннего размещённого сервиса.

🌐 Mesh-сеть WireGuard

Быстрое, зашифрованное соединение между всеми вашими устройствами напрямую.

📱 Стандартные клиенты

Работает с официальными клиентами Tailscale для настольных систем, мобильных устройств и серверов.

📜 Политики ACL

Гибкие правила контроля доступа для сегментации и защиты вашей сети.

🎯 Почему Headscale?

Полный контроль: Владейте сервером координации и данными своей сети
Без привязки к вендору: Альтернатива с открытым исходным кодом размещённой панели управления
Использует официальные клиенты: Сохраняется отточенный опыт работы с приложением Tailscale
Лёгкий: Единый бинарный файл на Go, который легко развернуть

🆕 Основные возможности

Сервер координации: Self-hosted панель управления Tailscale
WireGuard: Современная, зашифрованная mesh-сеть
ACL: Контроль доступа на основе политик
Множество пользователей: Пространства имён для разделения устройств и пользователей

📦 Установка из debian.griffo.io

Шаг 1: Добавить репозиторий

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
sudo apt update
                

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
apt update
                

Шаг 2: Установить headscale

# Install latest headscale
sudo apt install headscale

# Verify installation
headscale version
                

# Install latest headscale
apt install headscale

# Verify installation
headscale version
                

🎯 Примеры базового использования

# Show version
headscale version

# Create a user
headscale users create alice

# Generate a pre-auth key for a user
headscale preauthkeys create --user alice --reusable

# List connected nodes
headscale nodes list

# Serve the control server
headscale serve
        

🚀 Почему стоит выбрать debian.griffo.io?

📊 Сравнение репозиториев:

Официальный Debian: Часто отстаёт на месяцы, не хватает последних функций
debian.griffo.io: Последняя версия в течение нескольких часов после релиза
Ручная установка: Требуется ручная загрузка и настройка PATH
Наш репозиторий: Готовые к использованию, предварительно собранные пакеты

✅ Последние функции: Получайте новейшие функции и улучшения Headscale немедленно
✅ Без ручной настройки: Готовые бинарные файлы, устанавливаемые и обновляемые через apt
✅ Автоматические обновления: Пакеты обновляются в течение нескольких часов после релизов апстрима
✅ Правильные зависимости: Корректно упакованы со всеми необходимыми библиотеками
✅ Мульти-дистрибутив: Работает на Bookworm, Trixie и Sid
✅ Простое обслуживание: Простые команды apt для обновлений

📦 Репозиторий сборки пакетов

Пакеты Debian собираются и поддерживаются автоматически в этом репозитории GitHub:

📁 headscale-debian — сборки последних релизов

🔗 Связанные пакеты

Также доступны из debian.griffo.io:

Garage — S3-совместимое распределённое объектное хранилище
Forgejo — Лёгкий self-hosted софтверный форж
k9s — Терминальный интерфейс для кластеров Kubernetes

            🎯 Идеально для: тех, кто размещает сервисы самостоятельно, и организаций, которым нужна приватная, безопасная mesh-VPN на клиентах Tailscale, но с полным контролем над сервером координации и своими данными.
        

💝 Поддержать проект

Если этот репозиторий экономит ваше время и усилия, рассмотрите возможность его поддержки!

⭐ Поставить звезду на GitHub 🐦 Поделиться в Twitter

🕸️ Установка последней версии Headscale в Debian