Обновление¶

Как обновить инстанс VPN Hub на новую версию образа ghcr.io/alexeyshalaev/vpn-hub — для каждого способа установки. Данные (БД, бэкапы, каталог провайдеров) живут в томах и переживают пересоздание контейнера; обновляется только образ приложения.

Требования¶

• Работающий инстанс, развёрнутый одним из способов (Compose, docker run, Kubernetes).
• Доступ к тому же .env / Secret и тем же томам (иначе потеряете данные).
• Свежий бэкап БД (см. danger выше).
• Сохранённый мастер-ключ — он не меняется при обновлении, но без него не расшифровать секреты и бэкапы.

Как проходит обновление¶

Новая версия — это новый образ. При старте контейнер сам выполняет alembic upgrade head и доводит схему БД до нужной ревизии. Накат сериализован транзакционным advisory-lock: если поднимается несколько инстансов, второй ждёт первого и видит уже накатанную схему — параллельный старт безопасен.

Стратегия тегов¶

От выбора тега зависит воспроизводимость обновлений.

Docker Compose¶

# в каталоге установки, в .env
VPNHUB_TAG=1.2.3

docker compose pull
docker compose up -d

docker image prune -f

curl -fsSL https://raw.githubusercontent.com/AlexeyShalaev/vpn-hub/master/deploy/scripts/update.sh | bash

curl -fsSL https://raw.githubusercontent.com/AlexeyShalaev/vpn-hub/master/deploy/scripts/update.sh | bash -s -- --tag 1.2.3

Проверьте, что оба контейнера снова здоровы:

docker compose ps

NAME          IMAGE                                    STATUS
vpnhub-app-1  ghcr.io/alexeyshalaev/vpn-hub:1.2.3      Up 12s (healthy)
vpnhub-db-1   postgres:17                              Up 30s (healthy)

Один docker run¶

Обновление вручную — тем же образом, что и Compose, но по шагам. Вытяните новый образ:

docker pull ghcr.io/alexeyshalaev/vpn-hub:1.2.3

Остановите и удалите старый контейнер (тома, переданные через -v, при этом не удаляются):

docker stop vpn-hub
docker rm vpn-hub

Запустите заново с теми же томами и тем же окружением, что и в первый раз, — поменялся только тег образа:

docker run -d --name vpn-hub \
  --env-file .env \
  -p 127.0.0.1:8000:8000 \
  -v vpnhub-backups:/var/lib/vpnhub/backups \
  -v vpnhub-data:/var/lib/vpnhub/data \
  ghcr.io/alexeyshalaev/vpn-hub:1.2.3

Убедитесь, что контейнер поднялся и здоров:

docker ps

CONTAINER ID   IMAGE                                 STATUS
a1b2c3d4e5f6   ghcr.io/alexeyshalaev/vpn-hub:1.2.3   Up 15s (healthy)

Kubernetes¶

images:
  - name: ghcr.io/alexeyshalaev/vpn-hub
    newTag: "1.2.3"

kubectl apply -k overlays/bundled-db
kubectl -n vpnhub rollout status deploy/vpnhub

kubectl -n vpnhub set image deploy/vpnhub vpnhub=ghcr.io/alexeyshalaev/vpn-hub:1.2.3
kubectl -n vpnhub rollout status deploy/vpnhub

Дождитесь, пока новый под станет Running и готов:

kubectl -n vpnhub get pods

NAME                          READY   STATUS    RESTARTS   AGE
vpnhub-7d9c8b6f4-abcde        1/1     Running   0          20s

kubectl -n vpnhub rollout restart deploy/vpnhub

kubectl -n vpnhub rollout undo deploy/vpnhub

Обновление из панели (кнопка «Обновить сейчас»)¶

Раздел Система показывает текущую версию и, если вышла новее, кнопку «Обновить сейчас». Само приложение в контейнере пересоздать себя не может, поэтому кнопка делегирует рестарт внешнему механизму — драйвер выбирается по настройкам (приоритет command → webhook → k8s). Пока ни один не настроен, кнопка честно предлагает ручной путь и не имитирует прогресс.

После нажатия панель перезапускается, страница ждёт возврата новой версии и сама перезагружается. Данные в PostgreSQL сохраняются, миграции накатываются на старте.

# в .env (закрепите оверлей, чтобы пережил обновления):
COMPOSE_FILE=compose.yaml:selfupdate.compose.yaml   # +:caddy.compose.yaml, если нужен HTTPS
VPNHUB_UPDATE_TOKEN=$(openssl rand -hex 32)
docker compose up -d

kubectl apply -k deploy/k8s/overlays/bundled-db   # RBAC и serviceAccountName приедут с базой

kubectl apply -f deploy/k8s/base/rbac.yaml
kubectl -n vpnhub patch deployment vpnhub --type merge \
  -p '{"spec":{"template":{"spec":{"serviceAccountName":"vpnhub"}}}}'

Автообновления по расписанию (опционально)¶

Автоматический подъём образа удобен для домашнего/некритичного инстанса, но добавляет риск: любой pull может принести несовместимую версию без вашего участия.

Пример для Compose с Watchtower (поддерживаемый форк; оригинал containrrr/watchtower архивирован в конце 2025):

services:
  app:
    labels:
      com.centurylinklabs.watchtower.enable: "true"

  watchtower:
    image: ghcr.io/nickfedor/watchtower:latest
    restart: unless-stopped
    environment:
      WATCHTOWER_LABEL_ENABLE: "true"    # следить ТОЛЬКО за помеченными сервисами (app)
      WATCHTOWER_CLEANUP: "true"         # удалять старые образы
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

Мажорное обновление PostgreSQL (17 → 18)¶

При пине образа postgres:17 база сама не прыгнет на 18 — тег фиксирует мажор. Смена мажора PostgreSQL требует отдельной процедуры dump/restore (каталог данных /var/lib/postgresql/data несовместим между мажорами), это не делается простым pull.

Дальше: Docker Compose · Kubernetes · Скрипты установки · Переменные окружения