Документация MQXX v2

Добро пожаловать в справку MQXX

Самохостинговый Git-сервер с SSH-доступом, облачным бэкапом, CLI-инструментом и профессиональной защитой от ботов. Работает на Go 1.22+ и Next.js 15.

⚡ Быстрый старт: Установите CLI и запустите mqxx init myrepo --email you@example.com — аккаунт и репозиторий создаются автоматически. Подробнее →

Возможности

Быстрый старт (4 шага)

1
Установите mqxx CLI# или скачайте бинарник с /releases
curl -sSL https://mqxx.ru/install.sh | sh
2
Создайте репо (+ зарегистрируйтесь)# Регистрация и создание репо одной командой
mqxx init myrepo --email you@example.com
3
Подтвердите email# Аккаунт создан, SSH ключ добавлен автоматически
# Кликните ссылку в письме → CLI увидит подтверждение
4
Первый push# git init и remote add уже выполнены CLI
git push -u origin master

Технологический стек

Go 1.26HTTP API (Gin) + SSH сервер
PostgreSQL 17pool: 20 conns, pgx/v5
Next.js 16Веб-интерфейс
Magic LinksСессионная архитектура
S3 / YandexОблачный бэкап
mqxx CLILinux / macOS / Windows

MQXX состоит из четырёх компонентов: SSH-сервер (Go, порт 2222), HTTP API (Gin, порт 8080), Next.js веб-интерфейс и PostgreSQL 17 для метаданных. Репозитории хранятся как bare git-репозитории на диске и синхронизируются в облако (Яндекс.Диск / S3) по запросу или автоматически.

Защита от ботов реализована через Token Bucket Rate Limiter (3 уровня политик) и Bot Scoring Engine на 8 факторах. Капча появляется только при высоком балле подозрительности — обычные пользователи её не видят.