Headscale на VPS: self-hosted Tailscale для своих серверов

wget https://github.com/juanfont/headscale/releases/download/v0.28.0/headscale_0.28.0_linux_amd64.deb

sudo apt install ./headscale_0.28.0_linux_amd64.deb

headscale version
# headscale v0.28.0

sudo nano /etc/headscale/config.yaml

# URL, по которому клиенты будут подключаться к вашему серверу
server_url: https://vpn.ваш-домен.ru

# Адрес для прослушивания (Nginx будет проксировать на этот порт)
listen_addr: 127.0.0.1:8080

# Метрики (опционально — для Prometheus)
metrics_listen_addr: 127.0.0.1:9090

# IP-диапазоны для узлов mesh-сети
prefixes:
  v4: 100.64.0.0/10
  v6: fd7a:115c:a1e0::/48
  allocation: sequential

# База данных (SQLite — подходит для домашнего и небольшого проф. использования)
database:
  type: sqlite
  sqlite:
    path: /var/lib/headscale/db.sqlite
    write_ahead_log: true

# DERP — публичные relay-серверы Tailscale (использовать бесплатно)
derp:
  urls:
    - https://controlplane.tailscale.com/derpmap/default
  auto_update_enabled: true
  update_frequency: 24h

# Magic DNS
dns:
  magic_dns: true
  base_domain: vpn.ваш-домен.ru

vpn.ваш-домен.ru  →  A  →  IP_СЕРВЕРА

sudo apt install -y nginx

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    listen 80;
    server_name vpn.ваш-домен.ru;

    location / {
        proxy_pass         http://127.0.0.1:8080;
        proxy_http_version 1.1;

        # WebSocket и HTTP/2 upgrade
        proxy_set_header   Upgrade    $http_upgrade;
        proxy_set_header   Connection $connection_upgrade;

        proxy_set_header   Host              $host;
        proxy_set_header   X-Real-IP         $remote_addr;
        proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;

        # Важно: отключить буферизацию для стриминга событий
        proxy_buffering    off;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
    }
}

# Активировать конфиг
sudo ln -s /etc/nginx/sites-available/headscale /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

# Получить SSL-сертификат (certbot сам добавит HTTPS-блок в конфиг)
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d vpn.ваш-домен.ru

# Запустить Headscale
sudo systemctl enable --now headscale

# Проверить статус
sudo systemctl status headscale

curl https://vpn.ваш-домен.ru/health
# {"status":"pass"}

sudo headscale users create mynet

sudo headscale preauthkeys create --user mynet --reusable --expiration 24h

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

sudo tailscale up   --login-server https://vpn.ваш-домен.ru   --authkey hskey-auth-xxxxxxxxxxxx-xxxxxxxx

sudo headscale nodes list

# ID | Hostname | Name    | User  | IP addresses              | Ephemeral | Last seen      | Online | Expired
# 1  | server1  | server1 | mynet | 100.64.0.1, fd7a::1/128   | false     | 2026-02-05 ... | yes    | no

sudo headscale nodes register --user mynet --key nodekey:xxxxxxxxxx

# Пинг соседнего сервера по короткому имени
ping server2

# SSH на другой VPS без пароля (если настроены ключи)
ssh user@server2

# Curl к приложению на другом сервере
curl http://server2:8080/api/health

# Установить Tailscale
curl -fsSL https://tailscale.com/install.sh | sh

# Подключиться к вашей Headscale
sudo tailscale up   --login-server https://vpn.ваш-домен.ru   --authkey hskey-auth-xxxxxxxxxxxx-xxxxxxxx

# На App VPS — подключение к базе данных на DB VPS
psql -h db-vps -U myuser -d mydb
# db-vps разрешается через Magic DNS в 100.64.0.3

# Список всех узлов
sudo headscale nodes list

# Список пользователей
sudo headscale users list

# Создать ещё один reusable ключ (для новых серверов)
sudo headscale preauthkeys create --user mynet --reusable --expiration 7d

# Список ключей
sudo headscale preauthkeys list --user mynet

# Удалить узел из сети
sudo headscale nodes delete --id 3

# Статус на клиентском сервере
tailscale status