Whitelabel

Автоматически: clone.sh разворачивает продукт с вашим брендом

Продукт уже умеет подставлять свой логотип, favicon и весь брендовый текст интерфейса через каталог custom/. Логотип и favicon монтируются файлами поверх стоковых (см. docker-compose.yml); текст — это одна переменная SERVICE_NAME в whitelabel.conf, которую читает прямо внутри контейнера getenv('SERVICE_NAME') в app/lang/lang-{ru,en,es,jp}.php — никаких отдельных файлов с текстом редактировать не нужно. Скрипт clone.sh — обёртка над install.sh, которая раскладывает custom/ в целевой директории до первого запуска Docker:

Без дополнительных параметров команда сама скачивает актуальный релиз SPZGate, наш дефолтный шаблон custom/ (стоковые логотип и SERVICE_NAME=SPZGate) и запускает обычную установку install.sh — на выходе рабочий инстанс с каталогом /opt/spzgate/custom/, готовым к правке.

• Замените custom/images/logo.png и custom/images/favicon.ico на свои файлы того же формата
• В custom/whitelabel.conf смените SERVICE_NAME на своё название — это переименует продукт сразу везде в интерфейсе: заголовок панели, тему писем, сообщения об ошибках лицензии и т.д.
• Разверните custom/cert-proxy/index.php на своём веб-сервере как https://ваш-домен/cert/ и укажите его в SPZ_LICENSE_SERVER_URL (см. ниже) — клиент получает лицензионный ключ через ваш домен вместо spamorez.ru
• Примените изменения: docker compose up -d --force-recreate nginx php

Скачайте страницу установки

Страница установки — это один самодостаточный файл index.html (без внешних скриптов и картинок логотипа: логотип нарисован текстом и CSS) плюс скрипт-бутстраппер install.sh. Скачайте оба файла с продакшн-сайта:

Выберите название и путь для своего бренда

Слово «spzgate» встречается на странице не только в логотипе, но и в путях — /spzgate/install.sh, /spzgate/releases/… и т.д. Для полноценного whitelabel это тоже часть бренда и его тоже нужно заменить: клиент не должен видеть «spzgate» ни в тексте, ни в адресной строке. Придумайте два варианта названия:

Разместите файлы в каталоге своего веб-сервера под этим слагом вместо spzgate:

Страница станет доступна по адресу вида https://ваш-сайт.ru/mailguard/ — без единого «spzgate» в URL.

Замените логотип, название и путь на свой бренд

В index.html название встречается в двух формах: «SPZGate» (заголовок, логотип, текст) и «spzgate» (пути к install.sh, к релизам, футер) — нужно заменить обе:

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

Проверьте результат вручную — в файле остаётся домен spamorez.ru (см. шаг 4) и ссылка на офлайн-пакет вида spzgate-2.0.1-offline-amd64.tar.gz в футере: это реальное имя файла на наших серверах, его трогать не нужно, если вы не зеркалируете релизы сами (шаг 5).

Обновите команду установки для клиентов

В трёх местах страницы показана команда установки с явным доменом spamorez.ru и путём /spzgate/ — замените их на свой домен и слаг, чтобы клиенты копировали ссылку на вашу страницу, а не на наш сайт:

→ заменяется на:

Проверьте также заголовок-комментарий Usage: в начале файла install.sh — он не влияет на работу скрипта, но должен указывать на ваш домен и путь для консистентности документации.

Решите, откуда скрипт будет брать сами пакеты

Внутри install.sh есть переменная RELEASE_BASE — она определяет, откуда загружаются архивы SPZGate и файл версии:

Рекомендуемый вариант — оставить RELEASE_BASE без изменений, с путём /spzgate/ на нашей стороне. Это внутренний технический адрес — клиент его не видит (видит только вашу страницу и вашу команду установки из шага 4), а пакеты и обновления по-прежнему приходят с наших серверов: вам не нужно вручную зеркалировать релизы при каждом обновлении.

Если вместо этого вы хотите полностью раздавать пакеты со своей инфраструктуры (например, для закрытого контура клиента), измените RELEASE_BASE на свой URL и синхронизируйте туда содержимое каталога releases/ (манифест + .tar.gz) при выходе каждой новой версии — тогда и здесь можно использовать свой слаг вместо spzgate.