6run0/eveo7-mumble-authenticator repository overview

⁠Alliance Auth Mumble Authenticator — Docker image

Русская версия — ниже.

Production-oriented Docker image for the Alliance Auth Mumble Authenticator⁠, a single long-lived process that bridges a Mumble (Murmur) ICE server to an Alliance Auth⁠ MariaDB backend. It validates Mumble logins against Alliance Auth (and, optionally, short-lived EVE Online templink guest credentials), serves EVE portraits as channel textures, parks idle users, exposes Prometheus metrics, and runs a self-healing ICE healthcheck.

The image is linux/amd64 only: zeroc-ice ships pre-built wheels for CPython 3.12 on Linux exclusively, so there is no architecture or interpreter matrix.

⁠Tags

Pin X.Y.Z for reproducible deployments; latest is convenient but shifts under you. The image tag matches the PyPI package version released from the same tag.

⁠Quick start

docker pull docker.io/6run0/eveo7-mumble-authenticator:latest
docker pull docker.io/6run0/eveo7-mumble-authenticator:3.1.0   # version-pinned

The image needs a reachable Alliance Auth MariaDB/MySQL database and a running Murmur (Mumble) server with the ICE interface enabled and its Ice.Secret known. Configuration is supplied entirely through MA__-prefixed environment variables; three secrets are required and startup fails closed if any is unset:

docker run --rm \
  --network host \
  -e MA__ALLIANCE_AUTH__DATABASE__PASSWORD=your-db-password \
  -e MA__ICE_SERVER__SECRET=your-murmur-ice-secret \
  -e MA__ICE_CLIENT__SECRET=your-murmur-ice-secret \
  -e MA__ALLIANCE_AUTH__DATABASE__HOST=127.0.0.1 \
  -e MA__ALLIANCE_AUTH__DATABASE__NAME=alliance_auth \
  -e MA__ALLIANCE_AUTH__DATABASE__USER=alliance \
  -e MA__ICE_SERVER__HOST=127.0.0.1 \
  -e MA__ICE_SERVER__PORT=6502 \
  6run0/eveo7-mumble-authenticator:latest

MA__ICE_CLIENT__SECRET must equal MA__ICE_SERVER__SECRET, or the Settings root validator rejects startup. A ready-to-edit Compose service is shipped in docker-compose.yml⁠.

⁠Configuration

Runtime configuration is entirely through environment variables — YAML and legacy keys are rejected at startup. See:

• README.md⁠ — install, deploy, and operational reference.
• example.env⁠ — the generated, self-documenting MA__* environment-variable template (the single configuration reference).

⁠Source and issues

Built and published from gitlab.com/eveo7/eveo7-mumble-authenticator⁠. Report problems and find the changelog there.

⁠Alliance Auth Mumble Authenticator — Docker-образ

English version above.

Ориентированный на продакшен Docker-образ для Alliance Auth Mumble Authenticator⁠ — одного долгоживущего процесса, который связывает ICE-сервер Mumble (Murmur) с backend-базой MariaDB Alliance Auth⁠. Он проверяет логины Mumble против Alliance Auth (и, опционально, против краткоживущих гостевых учётных данных templink для EVE Online), отдаёт портреты EVE как текстуры каналов, паркует неактивных пользователей, публикует метрики Prometheus и выполняет самовосстанавливающийся ICE-healthcheck.

Образ собран только под linux/amd64: zeroc-ice поставляет готовые wheel-пакеты исключительно для CPython 3.12 на Linux, поэтому матрицы архитектур и интерпретаторов нет.

⁠Теги

Для воспроизводимых развёртываний закрепляйте X.Y.Z; latest удобен, но смещается под вами. Тег образа совпадает с версией PyPI-пакета, выпущенного из того же git-тега.

⁠Быстрый старт

docker pull docker.io/6run0/eveo7-mumble-authenticator:latest
docker pull docker.io/6run0/eveo7-mumble-authenticator:3.1.0   # привязка к версии

Образу нужны доступная база данных MariaDB/MySQL Alliance Auth и запущенный сервер Murmur (Mumble) с включённым ICE-интерфейсом и известным Ice.Secret. Конфигурация задаётся целиком через переменные окружения с префиксом MA__; три секрета обязательны, и при отсутствии любого из них запуск падает (fail-closed):

docker run --rm \
  --network host \
  -e MA__ALLIANCE_AUTH__DATABASE__PASSWORD=your-db-password \
  -e MA__ICE_SERVER__SECRET=your-murmur-ice-secret \
  -e MA__ICE_CLIENT__SECRET=your-murmur-ice-secret \
  -e MA__ALLIANCE_AUTH__DATABASE__HOST=127.0.0.1 \
  -e MA__ALLIANCE_AUTH__DATABASE__NAME=alliance_auth \
  -e MA__ALLIANCE_AUTH__DATABASE__USER=alliance \
  -e MA__ICE_SERVER__HOST=127.0.0.1 \
  -e MA__ICE_SERVER__PORT=6502 \
  6run0/eveo7-mumble-authenticator:latest

MA__ICE_CLIENT__SECRET должен совпадать с MA__ICE_SERVER__SECRET, иначе root-валидатор Settings отклонит запуск. Готовый к правке Compose-сервис лежит в docker-compose.yml⁠.

⁠Конфигурация

Конфигурация рантайма — целиком через переменные окружения; YAML и устаревшие ключи отклоняются при запуске. См.:

• README.ru.md⁠ — установка, развёртывание и операционный справочник.
• example.env⁠ — сгенерированный самодокументируемый шаблон переменных MA__* (единственный справочник по конфигурации).

⁠Исходники и issues

Собирается и публикуется из gitlab.com/eveo7/eveo7-mumble-authenticator⁠. Там же сообщайте о проблемах и смотрите журнал изменений.