Самостоятельный хостинг Intlayer

Intlayer может полностью работать на вашей собственной инфраструктуре — аккаунт Intlayer Cloud не требуется. Одна команда запускает готовый к production стек:

curl -fsSL https://intlayer.org/install.sh | sh

Установщик загружает docker-compose.yml и .env, автоматически генерирует необходимые секреты и запускает все контейнеры с помощью docker compose up -d.

Оглавление

Архитектура

                ┌─────────────────────────────┐ браузер ──────▶ │ приложение  (TanStack Start)  :3000│ ──┐                └─────────────────────────────┘   │ VITE_BACKEND_URL                ┌─────────────────────────────┐   │                │  бэкенд (Fastify/Bun)  :3100│ ◀─┘                └──────────────┬──────────────┘          ┌──────────┬─────────┼──────────┬───────────┐          ▼          ▼         ▼          ▼           ▼     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium     (RS из 1 узла)          (API S3)     (SMTP)        (в образе)                             minio:9001   mailpit:8025                             (консоль)    (веб-интерфейс)

Chromium (используемый для генерации скриншотов Puppeteer) включен в образ бэкенда — отдельный контейнер не требуется.

Предварительные требования

• Docker ≥ 24 и Docker Compose ≥ v2. Если что-либо из этого отсутствует, установщик выведет ссылку для установки и завершит работу.
• Порты 3000, 3100, 8025, 9000 и 9001 должны быть доступны на хосте.
• Хост на Linux или macOS (или WSL2 на Windows).

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

Извлеките и запустите опубликованный образ, указав учетные данные и секреты MongoDB Atlas:

docker run -d --name intlayer \  -p 3000:3000 \  -p 3100:3100 \  -p 9000:9000 \  -p 9001:9001 \  -v intlayer-data:/data \  -e DB_ID="<atlas-user>" \  -e DB_MDP="<atlas-password>" \  -e DB_CLUSTER="<cluster>.xxxxx.mongodb.net" \  -e BETTER_AUTH_SECRET="$(openssl rand -hex 32)" \  -e S3_SECRET_ACCESS_KEY="$(openssl rand -hex 16)" \  -e RESEND_API_KEY="<your-resend-key>" \  aymericzip/intlayer-selfhost

Затем откройте http://localhost:3000.

Dashboard доступен на localhost. См. Ограничения — опубликованный образ не поддерживает пользовательские домены.

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

curl -fsSL https://intlayer.org/install.sh | sh

Что делает установщик:

1. Проверяет наличие docker и docker compose.
2. Загружает docker-compose.yml и .env.example в ./intlayer/.
3. Если файл .env отсутствует, копирует пример и генерирует случайные секреты для BETTER_AUTH_SECRET, S3_ACCESS_KEY_ID и S3_SECRET_ACCESS_KEY с помощью openssl rand.
4. Запускает docker compose pull + docker compose up -d.
5. Выводит URL: панель управления :3000, API :3100, интерфейс электронной почты :8025, консоль MinIO :9001.

После запуска стека откройте http://localhost:3000 и создайте свою первую учетную запись.

Сервисы

Внутренние порты (mongo, redis) по умолчанию не открыты на хосте.

Порт MinIO 9000 должен быть доступен из браузера, поскольку загруженные активы (аватары, скриншоты) загружаются непосредственно из S3_PUBLIC_URL=http://localhost:9000/intlayer.

Переменные окружения

Обязательно

Обязательные (автоматически генерируемые или запрашиваемые)

Необязательные (функции работают с ограничениями, если отсутствуют)

Глобальная почтовая система

По умолчанию все транзакционные письма отправляются через Resend с использованием RESEND_API_KEY. Самостоятельно размещенные развертывания могут вместо этого маршрутизировать все письма — включая письма, не связанные с организацией, такие как сброс пароля и магические ссылки — через глобальную почтовую систему, настроенную с помощью переменных окружения.

Установите MAIL_PROVIDER для её активации. Если она не установлена, используется почтовая система Resend по умолчанию.

Приоритет: собственная почтовая система организации (настроенная из панели управления Organization) имеет приоритет над глобальной почтовой системой, которая, в свою очередь, имеет приоритет над стандартным ключом Resend.

Подключение вашего проекта Intlayer

После запуска стека направьте свой проект на самохостинговый бэкенд и панель управления вместо intlayer.org.

Конфигурация проекта

import type { IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  editor: {
    clientId: process.env.INTLAYER_CLIENT_ID,
    clientSecret: process.env.INTLAYER_CLIENT_SECRET,

    /**
     * URL самохостинговой панели управления CMS.
     * По умолчанию: https://app.intlayer.org
     */
    cmsURL: process.env.INTLAYER_CMS_URL, // e.g. http://localhost:3000

    /**
     * URL самохостингового API бэкенда.
     * По умолчанию: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // e.g. http://localhost:3100
  },
};

export default config;

Установите переменные окружения в файле .env вашего проекта:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_CLIENT_ID=<your-client-id>INTLAYER_CLIENT_SECRET=<your-client-secret>

Создайте учетные данные доступа на вашей самохостинговой панели управления в разделе Проекты → Ключи доступа по адресу http://localhost:3000/projects.

SDK @intlayer/api

При программном использовании SDK @intlayer/api явно передайте backendURL:

import { createIntlayerCMS } from "@intlayer/api";import { dictionaryEndpoint } from "@intlayer/api/dictionary";const cms = createIntlayerCMS({  editor: {    clientId: process.env.INTLAYER_CLIENT_ID,    clientSecret: process.env.INTLAYER_CLIENT_SECRET,    backendURL: process.env.INTLAYER_BACKEND_URL, // http://localhost:3100  },});const { data: dictionaries } = await dictionaryEndpoint(cms).getDictionaries();

Обновление

Повторный запуск установщика на существующем развертывании выполняет скользящее обновление:

curl -fsSL https://intlayer.org/install.sh | sh

Это загружает последние образы и перезапускает контейнеры с помощью docker compose pull && docker compose up -d. Существующие тома (mongo-data, redis-data, minio-data) сохраняются — потери данных нет.

Для обновления вручную из директории ./intlayer/:

docker compose pulldocker compose up -d

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

Все постоянные данные хранятся в трех именованных томах Docker.

Резервное копирование

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/mongo-data.tar.gz /datadocker run --rm \  -v intlayer_redis-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/redis-data.tar.gz /datadocker run --rm \  -v intlayer_minio-data:/data \  -v "$(pwd)":/backup \  busybox tar czf /backup/minio-data.tar.gz /data

Восстановление

docker run --rm \  -v intlayer_mongo-data:/data \  -v "$(pwd)":/backup \  busybox tar xzf /backup/mongo-data.tar.gz -C /# Повторите для redis-data и minio-data

Ограничения

• MongoDB должна быть внешней (Atlas). Backend подключается только через mongodb+srv:// (собирается из DB_ID / DB_MDP / DB_CLUSTER), поэтому обычный mongodb://host:27017 — включая встроенный mongod контейнера — не может быть использован. Предоставьте кластер MongoDB Atlas.
• Нет пользовательского домена. Все URL-адреса VITE_*, обращенные к браузеру, встраиваются в приложение во время сборки, и опубликованный образ поставляется со значениями localhost. Доступ к панели управления должен осуществляться через http://localhost:3000; подача его на общедоступный домен потребует перестройки образа с встроенными целевыми URL-адресами и не поддерживается из коробки.
• Email требует работающего mailer. Начальная настройка требует проверки электронной почты, поэтому должны быть настроены либо RESEND_API_KEY, либо глобальный SMTP mailer (MAIL_PROVIDER=smtp + MAIL_SMTP_*). После входа первого администратора каждая организация также может настроить свой собственный SMTP или Resend mailer из панели управления.

Устранение неполадок

Бэкенд циклически перезапускается при первом запуске

MongoDB и Redis должны быть работоспособны до запуска бэкенда. Файл compose использует depends_on с condition: service_healthy. Если вы видите повторяющиеся перезапуски бэкенда, убедитесь, что проверки работоспособности mongo и redis проходят:

docker compose psdocker compose logs mongodocker compose logs redis

Панель управления не может связаться с API

Убедитесь, что VITE_BACKEND_URL соответствует URL, по которому бэкенд доступен из браузера (а не из сети Docker). Если вы изменили порт бэкенда или добавили обратный прокси, пересоберите образ панели управления:

docker compose build appdocker compose up -d app

Отсутствует корзина MinIO

Если одноразовый сервис minio-init не запустился (или запустился до того, как MinIO был готов), создайте корзину вручную:

docker compose run --rm minio-init

Полезные ссылки

• Документация Intlayer CMS
• Справочник по конфигурации
• CMS SDK — @intlayer/api
• Docker Image (aymercizip/intlayer-selfhost)