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

# Список ключей (в v0.28 показывает все ключи глобально)
sudo headscale preauthkeys list

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

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

# Установить Go (если нет)
sudo apt install -y golang-go

# Скомпилировать derper
go install tailscale.com/cmd/derper@latest

# Бинарник окажется в ~/go/bin/derper — переместите в /usr/local/bin
sudo install -m 755 ~/go/bin/derper /usr/local/bin/derper
derper --version

sudo tee /etc/systemd/system/derper.service << 'EOF'
[Unit]
Description=Tailscale DERP relay
After=network.target

[Service]
ExecStart=/usr/local/bin/derper -hostname derp.ваш-домен.ru -certmode letsencrypt -certdir /var/lib/derper
Restart=on-failure
RestartSec=5
DynamicUser=yes
StateDirectory=derper

[Install]
WantedBy=multi-user.target
EOF

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo systemctl daemon-reload
sudo systemctl enable --now derper

regions:
  900:
    regionid: 900
    regioncode: my-derp
    regionname: My Private DERP
    nodes:
      - name: 900a
        regionid: 900
        hostname: derp.ваш-домен.ru
        ipv4: IP_DERP_СЕРВЕРА
        derpport: 443

derp:
  urls:
    - https://controlplane.tailscale.com/derpmap/default
  paths:
    - /etc/headscale/derp.yaml
  auto_update_enabled: true
  update_frequency: 24h

version: "3"
services:
  headplane:
    image: ghcr.io/tale/headplane:0.6.1
    container_name: headplane
    restart: unless-stopped
    ports:
      - "127.0.0.1:3000:3000"
    volumes:
      - /etc/headscale/config.yaml:/etc/headscale/config.yaml:ro
      - /var/run/headscale/headscale.sock:/var/run/headscale/headscale.sock
      - ./headplane-data:/var/lib/headplane
    environment:
      - HEADPLANE_SERVER_HOST=0.0.0.0
      - HEADPLANE_SERVER_PORT=3000
      - HEADPLANE_HEADSCALE_URL=https://vpn.ваш-домен.ru
      - HEADPLANE_COOKIE_SECRET=сгенерируйте_случайную_строку_32_символа

docker compose up -d
docker logs headplane

# Открыть в браузере (через Nginx с SSL)
# https://admin.ваш-домен.ru