Установка VoidAuth через Docker Compose для Self-Hosted приложений

VoidAuth — это open-source SSO-провайдер, который позволяет упростить управление доступом к вашим self-hosted приложениям. В этой инструкции вы узнаете, как установить VoidAuth с помощью Docker Compose.

0 просмотров

VoidAuth — это open-source SSO-провайдер, который позволяет упростить управление доступом к вашим self-hosted приложениям. В этой инструкции вы узнаете, как установить VoidAuth с помощью Docker Compose.

Требования

  • Docker: Установленный и запущенный Docker на вашем сервере или локальной машине.
  • PostgreSQL или SQLite: База данных для хранения пользовательских данных и настроек.
  • Стабильное интернет-соединение: Для загрузки образов Docker и обновлений.
  • Доступ к переменным окружения: Для настройки URL, ключей хранения и других параметров.

Подготовка

  1. Создайте отдельный каталог для размещения конфигурационных файлов и базы данных:
  2. mkdir voidauth && cd voidauth
  3. Скачайте официальный образ VoidAuth с Docker Hub:
  4. docker pull voidauth/voidauth:latest
  5. Создайте файл docker-compose.yml в текущей директории.

Настройка docker-compose.yml

services:
  voidauth:
    image: voidauth/voidauth:latest
    restart: unless-stopped
    volumes:
      - ./config:/app/config
    environment:
      APP_URL: https://auth.example.com
      STORAGE_KEY: your-storage-key
      DB_PASSWORD: your-db-password
      DB_HOST: voidauth-db
    depends_on:
      voidauth-db:
        condition: service_healthy

  voidauth-db:
    image: postgres:18
    restart: unless-stopped
    environment:
      POSTGRES_PASSWORD: your-db-password
    volumes:
      - db:/var/lib/postgresql/18/docker
    healthcheck:
      test: "pg_isready -U postgres -h localhost"

volumes:
  db:

Замените APP_URL, STORAGE_KEY, DB_PASSWORD и другие переменные окружения на значения, подходящие для вашей среды.

Запуск VoidAuth

  1. Запустите контейнеры с помощью Docker Compose:
  2. docker compose up -d
  3. После запуска проверьте логи для получения ссылки на сброс пароля:
  4. docker compose logs voidauth
  5. Откройте браузер и перейдите по URL, указанному в APP_URL, чтобы начать работу с VoidAuth.

Первый вход

  1. Используйте ссылку на сброс пароля из логов Docker для входа в админ-панель.
  2. После первого входа измените имя пользователя и установите надежный пароль.
  3. Создайте пользователей через страницу приглашений в админ-панели.

Обновление VoidAuth

  1. Остановите контейнеры:
  2. docker compose down
  3. Обновите образ VoidAuth:
  4. docker pull voidauth/voidauth:latest
  5. Запустите контейнеры снова с помощью docker compose up -d.

Резервное копирование и безопасность

  1. Регулярно выполняйте резервные копии базы данных через Docker-объемы или инструменты PostgreSQL/SQLite.
  2. Используйте HTTPS для защиты передачи данных между клиентом и сервером.

    3. n

  3. Не храните реальные значения переменных окружения в конфигурационных файлах. Используйте безопасные placeholders.

Частые ошибки и устранение

  1. Ошибка: «Service ‘voidauth-db’ is not healthy»: Убедитесь, что переменная POSTGRES_PASSWORD совпадает с DB_PASSWORD.
  2. Ошибка: «Cannot connect to the database»: Проверьте настройки подключения в docker-compose.yml и убедитесь, что база данных запущена.
  3. Ошибка: «APP_URL не доступен»: Убедитесь, что ваш DNS правильно настроен и порт 443 (или 80) открыт в брандмауэре.
Реклама