Розгортання Intlayer на власному сервері

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

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

Інсталятор завантажує docker-compose.yml та .env, автоматично генерує необхідні секрети та запускає всі контейнери за допомогою docker compose up -d.

Зміст

Архітектура

                ┌─────────────────────────────┐ browser ──────▶ │  app  (TanStack Start)  :3000│ ──┐                └─────────────────────────────┘   │ VITE_BACKEND_URL                ┌─────────────────────────────┐   │                │  backend (Fastify/Bun)  :3100│ ◀─┘                └──────────────┬──────────────┘          ┌──────────┬─────────┼──────────┬───────────┐          ▼          ▼         ▼          ▼           ▼     mongo:27017  redis:6379  minio:9000  mailpit:1025  Chromium     (1-node RS)             (S3 API)     (SMTP)        (in-image)                             minio:9001   mailpit:8025                             (console)    (web UI)

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

Передумови

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

Швидкий старт

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.

Змінні середовища

Інсталятор генерує готовий до використання файл .env. Таблиця нижче описує кожну змінну.

Обов'язкові (автоматично генеруються або запитуються)

Необов'язкові (функції погіршуються, якщо відсутні)

Підключення вашого проекту 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, // наприклад, http://localhost:3000

    /**
     * URL самостійно розгорнутого бекенд API.
     * За замовчуванням: https://back.intlayer.org
     */
    backendURL: process.env.INTLAYER_BACKEND_URL, // наприклад, http://localhost:3100
  },
};

export default config;

Встановіть змінні середовища у файлі .env вашого проекту:

INTLAYER_CMS_URL=http://localhost:3000INTLAYER_BACKEND_URL=http://localhost:3100INTLAYER_CLIENT_ID=<ваш-client-id>INTLAYER_CLIENT_SECRET=<ваш-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

Використання зворотного проксі (Nginx / Caddy)

Для виробничих розгортань розмістіть зворотний проксі перед контейнерами застосунку та бекенду замість прямого їх виставлення.

Приклад Nginx

server {    listen 80;    server_name cms.example.com;    location / {        proxy_pass http://localhost:3000;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}server {    listen 80;    server_name api.example.com;    location / {        proxy_pass http://localhost:3100;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;    }}

Оновіть наступні змінні .env, щоб вони відповідали вашим публічним доменам:

BACKEND_URL=https://api.example.comAPP_URL=https://cms.example.comDOMAIN=example.comVITE_BACKEND_URL=https://api.example.comVITE_DOMAIN=example.com

Змінні VITE_* вбудовуються в образ дашборду під час збірки. Якщо ви зміните їх після збірки образу, вам потрібно перезібрати образ app (docker compose build app) або використовувати ін'єкцію конфігурації під час виконання.

Усунення несправностей

Бекенд циклічно перезапускається під час першого запуску

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

Електронні листи не надсилаються

За замовчуванням усі вихідні електронні листи захоплюються Mailpit. Відкрийте http://localhost:8025, щоб побачити надіслані повідомлення. Щоб надсилати реальні електронні листи, встановіть MAIL_PROVIDER=resend та RESEND_API_KEY=<ваш-ключ> у .env, а потім перезапустіть бекенд:

docker compose restart backend

Відсутній кошик MinIO

Якщо одноразовий сервіс minio-init не запустився (або запустився до того, як MinIO був готовий), створіть кошик вручну:

docker compose run --rm minio-init

Корисні посилання

• Документація Intlayer CMS
• Довідка щодо конфігурації
• CMS SDK — @intlayer/api