SPZGate — создание собственного whitelabel

1Что такое whitelabel-раздача

Whitelabel-сайт — это ваш собственный «зеркальный» источник установки SPZGate: такой же однострочник curl … | sudo bash, как у spamorez.ru/spzgate, но под вашим доменом, с вашим брендом (логотип, название сервиса) и вашим прокси для выдачи лицензий — клиент нигде не увидит слова «Спаморез» или домен spamorez.ru.

Этот же сайт — spzgate.ru — работающий пример: раздел /onprem/ и есть такая whitelabel-точка, развёрнутая ровно по инструкции ниже.

2Требования

Сервер под Linux (Ubuntu/Debian) с публичным IP и доменом, указывающим на него
nginx + PHP-FPM (для статической раздачи файлов и прокси лицензии — сам SPZGate-шлюз для клиентов ставится отдельно, докером, необязательно на этом же сервере)
Открытые порты 80/443 (HTTP/HTTPS) — по ним клиенты будут скачивать дистрибутив и получать лицензию

3Быстрый старт

На сервере, который станет вашей whitelabel-точкой, выполните:

# интерактивный диалог настройки (можно на Enter — везде есть значение по умолчанию)
curl -fsSL https://devwww.spamorez.ru/spzgate/clone.sh | sudo bash -s -- --configure-site --no-deploy

Флаг --no-deploy означает «только подготовить файлы для раздачи» — ничего не разворачивается на этом сервере. Уберите его, если хотите сразу же поднять здесь же и сам шлюз (Docker, MySQL, qmail и т.д.).

4Что спросит диалог

Везде можно нажать Enter — предложен вменяемый вариант по умолчанию:

Вопрос	Значение по умолчанию
Название сервиса	`SPZGate`
Домен для размещения whitelabel	определяется автоматически (hostname сервера)
Путь на сайте для клона	`onprem` (т.е. `/var/www/<домен>/onprem`)
Путь на сайте для прокси сертификата	`cert` (внутри той же папки клона)

Без терминала (скрипт запущен не интерактивно) все вопросы молча берут значения по умолчанию — диалог не блокирует автоматизацию.

5Что происходит автоматически

Скачивается актуальный релиз SPZGate и шаблон бренда (whitelabel.tar.gz)
Генерируется случайный клиентский ID и регистрируется на https://spamorez.ru/spzgate/cert/ — вы сразу получаете настоящий подписанный лицензионный ключ на свой домен
В custom/whitelabel.conf прописываются SERVICE_NAME и SPZ_LICENSE_SERVER_URL=https://ваш-домен/путь-cert/
Прокси лицензии (custom/cert-proxy/index.php) разворачивается по указанному пути — он прозрачно пересылает запросы клиентов на настоящий CA Спаморез, подпись ключа остаётся подлинной, но клиент обращается только к вашему домену

6Структура результата

/var/www/<домен>/<путь-клона>/ # напр. onprem/ ├── install.sh # bootstrap для ваших клиентов — curl … | sudo bash ├── deploy.sh # локальный установщик (если ставите шлюз тут же) ├── whitelabel.tar.gz # упакованный бренд: логотип, favicon, whitelabel.conf ├── build/ # web.tar.gz / control.tar.gz релиза ├── custom/ # наложенный бренд (уже применён к build/) │ ├── images/logo.png, favicon.ico │ ├── cert-proxy/index.php │ └── whitelabel.conf ├── docker-compose.yml, php/, nginx/, qmail/, mysql/ └── <путь-cert>/index.php # прокси лицензии, напр. onprem/cert/

7Как клиенты ставят шлюз с вашего домена

Публикуете свой однострочник вместо spamorez.ru:

curl -fsSL https://ваш-домен/путь-клона/install.sh | sudo bash

Клиент получит установку с вашим логотипом и названием сервиса, а его панель будет запрашивать лицензию через ваш домен — так же, как это устроено на spzgate.ru/onprem/install.sh (рабочий пример).

8Донастройка бренда позже

Логотип/favicon и название сервиса можно поменять в любой момент — не пересобирая всё заново:

cp мой-логотип.png /var/www/домен/путь-клона/custom/images/logo.png
$EDITOR /var/www/домен/путь-клона/custom/whitelabel.conf

Если whitelabel уже развёрнут (не --no-deploy) — примените изменения командой docker compose up -d --force-recreate nginx php в каталоге установки.

Инструкция по установке шлюза На главную