DevOps и инфраструктура 15 мин чтения 2026-11-03

Платформа бронирования встреч и онлайн-записи Cal.com на VDS: развертывание открытой альтернативы Calendly в Docker Compose с PostgreSQL, интеграцией с сайтом и Telegram-алертами

Подробное инженерное руководство по установке открытой платформы онлайн-записи и планирования встреч Cal.com (Cal.diy) на собственном VDS в Docker Compose. Разбираем архитектуру приложения на Next.js, разделение Cal.com и открытого форка Cal.diy, тонкости сборки с переменной NEXT_PUBLIC_WEBAPP_URL, авторизацию NextAuth за Nginx, настройку PostgreSQL 16 и Redis, синхронизацию с Яндекс Календарем по CalDAV, встраивание виджета записи на сайт и соответствие 152-ФЗ.

Инженерная редакция SysKit Проверено инженерами SysKit.ru

1. Преимущества платформы Cal.com, переход к Cal.diy и сравнение с Calendly

Организация встреч с клиентами, демонстраций продуктов, консультаций и собеседований традиционно отнимает массу рабочего времени: стороны вынуждены обмениваться десятками сообщений в мессенджерах, чтобы согласовать подходящее окно в расписании. Популярный облачный сервис Calendly годами решал эту проблему, однако в текущих реалиях российский бизнес столкнулся с непреодолимыми барьерами:

  • Блокировка зарубежных платежей: оплатить подписку Calendly (от $12 на тарифе Standard до $16–20 на Teams в месяц за каждого сотрудника) российскими банковскими картами напрямую невозможно. Для команды из 5 человек базовые $60–80 в месяц выливаются в $720–960 в год, что с учетом наценок платежных посредников и комиссий виртуальных карт (15–25%) превышает 100 000 рублей в год.
  • Ограничения бесплатного тарифа: бесплатный план Calendly урезан до 1 типа событий (например, только 30-минутный звонок), не позволяет убрать чужой логотип и жестко запрещает привязку собственного корпоративного домена.
  • Риски нарушения 152-ФЗ: при бронировании встреч клиенты вводят персональные данные — фамилию, имя, телефон, email и тему обращения. Хранение этой информации в зарубежных дата-центрах США несет прямые юридические риски для компаний в РФ.

Лицензионная эволюция: закрытие ядра Cal.com и появление открытого форка Cal.diy

При выборе self-hosted решения важно понимать ключевое изменение ландшафта: весной 2026 года компания Cal.com официально перевела основной коммерческий продукт в категорию Closed Source (мотивируя это рисками автоматического AI-сканирования уязвимостей в открытом коде). Одновременно с этим для независимых разработчиков и энтузиастов был выделен официальный открытый форк — Cal.diy (репозиторий calcom/cal.diy, насчитывающий свыше 49 600 звёзд на GitHub под свободной лицензией MIT).

В открытом Cal.diy сохранено всё необходимое ядро: система индивидуального бронирования, публичные страницы записи, API v2 и протокол CalDAV. Из него были исключены тяжелые корпоративные надстройки (enterprise multi-tenant организации, round-robin распределение лидов между отделами, интеграции с SAML/SSO и AI-телефония).

Официальный дисклеймер авторов Cal.diy: В файле README.md репозитория calcom/cal.diy разработчики прямо указывают: «Cal.diy is intended for personal, non-production use» (проект ориентирован на персональное использование и сообщество), а крупным корпоративным командам с требованиями к SLA они рекомендуют платную подписку Cal.com. Однако с юридической точки зрения кодовая база Cal.diy опубликована под свободной лицензией MIT, которая безоговорочно разрешает бесплатное коммерческое использование. Для соло-практиков, репетиторов и небольших компаний это отличная рабочая замена, но ответственность за надежность инфраструктуры ложится на системного администратора.
Параметр / Функция Calendly (Облачный SaaS) Cal.com / Cal.diy на VDS (Self-Hosted)
Стоимость для команды (5 человек) ~$720–960/год (~75 000–96 000 ₽) + 15–25% комиссий посредников Только стоимость VDS: от ~600–900 ₽/мес (~8 000–11 000 ₽/год) без лимита пользователей
Оплата картами РФ Заблокирована (требуются зарубежные карты) Да: стандартная оплата российского хостинга по карте или счету юрлица
Собственный домен и White-Label Только на дорогих платных тарифах Полный White-Label: свой поддомен (meet.yourdomain.ru) и свой брендинг
Количество типов событий 1 тип на Free-тарифе, лимиты на стандартных планах Без ограничений: 15-мин знакомство, часовая сессия, групповые вебинары
Локализация данных и 152-ФЗ Серверы в США и Европе (нарушение закона) 100% соблюдение: база данных размещена в ЦОД на территории РФ
Интеграция с отечественными сервисами Ограничена зарубежными Google / Outlook CalDAV: бесшовная синхронизация с Яндекс Календарем и корпоративной почтой

Архитектура приложения Cal.com

Платформа построена на современном технологическом стеке и состоит из трех основных компонентов, объединенных в сеть Docker:

  • calcom (Next.js Core): движок веб-приложения и API. Отвечает за генерацию публичных страниц записи, расчет свободных тайм-слотов с учетом часовых поясов, отправку подтверждений и личный кабинет. В простое контейнер потребляет около 350–500 МБ оперативной памяти (суммарно со стеком — около 600–850 МБ; замеры сняты на тестовом стенде SysKit через системную команду docker stats calcom_app calcom_postgres calcom_redis).
  • calcom-postgres (PostgreSQL 16): основная реляционная база данных. Хранит учетные записи, календари событий, графики доступности, историю бронирований и зашифрованные токены интеграций.
  • calcom-redis (Redis 7): легковесный сервер кэширования в оперативной памяти и обработчик очередей фоновых задач (отправка писем, вебхуки, синхронизация внешних календарей).

2. Системные требования и подготовка VDS-сервера

Благодаря компиляции Next.js в оптимизированный production-бандл и использованию легковесных alpine-образов базы данных, стек Cal.com не требует дорогого серверного железа.

Конфигурация Минимальные требования Рекомендуемые параметры
Процессор (vCPU) 1 ядро (от 2.4 ГГц) 2 ядра (от 3.0 ГГц NVMe)
Оперативная память (RAM) 2 ГБ RAM 4 ГБ RAM
Файл подкачки (Swap) 4 ГБ Swap (обязательно) 4 ГБ Swap
Дисковое пространство 25 ГБ NVMe SSD 50 ГБ NVMe SSD
Операционная система Ubuntu 22.04 / 24.04 LTS (x86_64) Ubuntu 24.04 LTS (x86_64)
Назначение Соло-специалисты, до 50 бронирований/день Команды до 15 сотрудников, синхронизация CalDAV
Защита от OOM Killer: Node.js и Prisma в моменты тяжелых миграций базы данных или сборки страниц могут кратковременно потреблять до 1.5 ГБ RAM. На серверах с 2 ГБ оперативной памяти наличие настроенного файла подкачки 4 ГБ Swap критически важно, чтобы системный механизм Linux OOM (Out-of-Memory) Killer не перезагружал контейнер приложения.
Критическая деталь сборки Next.js (Build-time переменные): Во фреймворке Next.js переменные окружения с префиксом NEXT_PUBLIC_ (включая публичный адрес сайта NEXT_PUBLIC_WEBAPP_URL) встраиваются непосредственно в клиентский JavaScript-бандл на этапе сборки образа (Build Time), а не считываются на лету при старте (Runtime). Если запускать сторонний предварительно собранный образ, клиентский JS виджета может ссылаться на дефолтный адрес сборки. Ниже мы разберем как запуск готового образа с корректными переменными NEXTAUTH_URL и ALLOWED_HOSTNAMES, так и сборку собственного контейнера с флагом --build-arg NEXT_PUBLIC_WEBAPP_URL=https://meet.yourdomain.ru.

Подготовка сервера и настройка Swap 4 ГБ

Подключаемся к чистому серверу Ubuntu 24.04 по SSH и настраиваем файл подкачки с низким приоритетом сброса памяти:

# Обновляем системные пакеты
sudo apt-get update && sudo apt-get upgrade -y

# Создаем файл подкачки размером 4 ГБ
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Закрепляем в /etc/fstab для автоподключения после перезагрузки
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Устанавливаем оптимальный swappiness (весовой коэффициент 10 по шкале 0-100: сброс в swap только при нехватке RAM)
sudo sysctl vm.swappiness=10
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf

Установка Docker и Docker Compose

Устанавливаем официальный современный стек Docker Engine:

# Устанавливаем зависимости
sudo apt-get install -y ca-certificates curl gnupg lsb-release

# Добавляем официальный GPG-ключ Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Подключаем официальный репозиторий Docker
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Устанавливаем Docker Engine и плагин Compose
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# Проверяем корректность версий
docker --version
docker compose version

3. Полный манифест Docker Compose для Cal.com

Разворачивать стек Cal.com мы будем в изолированном каталоге /opt/calcom. В соответствии с каноническими правилами сетевой безопасности все внутренние порты контейнеров (PostgreSQL 5432, Redis 6379 и веб-приложение 3000) привязаны строго к локальному интерфейсу 127.0.0.1. Это гарантирует, что сервисы останутся недоступны из внешнего интернета в обход системного фаервола. Проверить закрытие портов после запуска поможет онлайн-сканер портов SysKit.

Генерация секретов и файла переменных окружения .env

Для шифрования сессий пользователей и токенов внешних календарей в базе данных требуются криптографические ключи NEXTAUTH_SECRET и CALENDSO_ENCRYPTION_KEY. Сгенерировать надежные пароли для базы данных поможет генератор паролей SysKit.

# Создаем рабочую директорию
sudo mkdir -p /opt/calcom
cd /opt/calcom

# Генерируем 32-байтный base64 ключ сессий NextAuth
openssl rand -base64 32

# Генерируем 24-значный ключ шифрования CalDAV-токенов
openssl rand -hex 24

# Создаем файл переменных окружения
nano .env

Заполняем файл /opt/calcom/.env следующей конфигурацией. Замените meet.yourdomain.ru на ваш реальный рабочий поддомен:

# /opt/calcom/.env

# Окружение
NODE_ENV=production

# Публичный URL вашего сервиса бронирования
NEXT_PUBLIC_WEBAPP_URL=https://meet.yourdomain.ru
WEB_APP_URL=https://meet.yourdomain.ru

# Критически важно: адрес авторизации NextAuth при работе за Nginx Reverse Proxy
NEXTAUTH_URL=https://meet.yourdomain.ru/api/auth

# Разрешенный домен для корректной маршрутизации страниц бронирования
ALLOWED_HOSTNAMES=meet.yourdomain.ru

# Согласие с условиями лицензии (обязательно для запуска)
NEXT_PUBLIC_LICENSE_CONSENT=agree
LICENSE=agree

# Отключение сбора телеметрии
CALCOM_TELEMETRY_DISABLED=1

# Секретный ключ NextAuth для подписи JWT-токенов сессий
NEXTAUTH_SECRET=СГЕНЕРИРУЙТЕ_СВОЙ_32_БАЙТНЫЙ_BASE64_КЛЮЧ

# Ключ шифрования учетных данных CalDAV и интеграций в базе данных
CALENDSO_ENCRYPTION_KEY=СГЕНЕРИРУЙТЕ_СЛУЧАЙНЫЙ_24_ЗНАЧНЫЙ_КЛЮЧ

# Параметры реляционной базы данных PostgreSQL 16
POSTGRES_USER=calcom_user
POSTGRES_PASSWORD=СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД
POSTGRES_DB=calcom
DATABASE_URL=postgresql://calcom_user:СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД@calcom-postgres:5432/calcom
DATABASE_DIRECT_URL=postgresql://calcom_user:СГЕНЕРИРУЙТЕ_НАДЕЖНЫЙ_ПАРОЛЬ_БД@calcom-postgres:5432/calcom

# Параметры подключения к Redis
REDIS_URL=redis://calcom-redis:6379

# Настройки отправки почтовых уведомлений (SMTP)
EMAIL_FROM="Сервис встреч <booking@yourdomain.ru>"
EMAIL_SERVER_HOST=smtp.yandex.ru
EMAIL_SERVER_PORT=465
EMAIL_SERVER_USER=booking@yourdomain.ru
EMAIL_SERVER_PASSWORD=СГЕНЕРИРУЙТЕ_ПАРОЛЬ_ПРИЛОЖЕНИЯ_SMTP
Тонкость настройки NextAuth в Cal.com: В стандартной библиотеке NextAuth принято указывать только базовый домен. Однако внутренняя архитектура Cal.com явно требует указания полного пути к эндпоинту аутентификации: https://meet.yourdomain.ru/api/auth без завершающего слэша (что зафиксировано в официальном файле .env.example репозитория проекта). Если ошибочно указать адрес без суффикса /api/auth, обработчик авторизации при попытке входа в личный кабинет вернет ошибку CLIENT_FETCH_ERROR.

Манифест docker-compose.yml

Создаем файл /opt/calcom/docker-compose.yml. Все контейнеры снабжены строгими лимитами оперативной памяти (mem_limit) и процессора (cpus), а также проверками работоспособности (healthcheck):

# /opt/calcom/docker-compose.yml
services:
  # Основная реляционная база данных
  calcom-postgres:
    image: postgres:16-alpine
    container_name: calcom_postgres
    restart: always
    environment:
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: ${POSTGRES_DB}
      TZ: Europe/Moscow
    volumes:
      - calcom_pg_data:/var/lib/postgresql/data
    ports:
      - "127.0.0.1:5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 5
    mem_limit: 768m
    cpus: 1.0
    networks:
      - calcom_net

  # Сервер кэширования и фоновых очередей
  calcom-redis:
    image: redis:7-alpine
    container_name: calcom_redis
    restart: always
    command: redis-server --appendonly yes --maxmemory 192mb --maxmemory-policy allkeys-lru
    volumes:
      - calcom_redis_data:/data
    ports:
      - "127.0.0.1:6379:6379"
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 5s
      retries: 5
    mem_limit: 256m
    cpus: 0.5
    networks:
      - calcom_net

  # Основное веб-приложение Cal.com (Next.js)
  calcom:
    image: calcom/cal.com:v6.2.0
    container_name: calcom_app
    restart: always
    env_file:
      - .env
    environment:
      - NEXT_PUBLIC_WEBAPP_URL=${NEXT_PUBLIC_WEBAPP_URL}
      - WEB_APP_URL=${WEB_APP_URL}
      - NEXTAUTH_URL=${NEXTAUTH_URL}
      - ALLOWED_HOSTNAMES=${ALLOWED_HOSTNAMES}
    depends_on:
      calcom-postgres:
        condition: service_healthy
      calcom-redis:
        condition: service_healthy
    ports:
      - "127.0.0.1:3000:3000"
    healthcheck:
      test: ["CMD-SHELL", "node -e \"fetch('http://127.0.0.1:3000/api/health').then(r=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))\""]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 40s
    mem_limit: 1536m
    cpus: 1.5
    networks:
      - calcom_net

volumes:
  calcom_pg_data:
    driver: local
  calcom_redis_data:
    driver: local

networks:
  calcom_net:
    driver: bridge

Нюанс Build-time переменных и компиляция собственного образа

Готовый образ calcom/cal.com:v6.2.0 на Docker Hub является стабильным prebuilt-срезом, опубликованным мейнтейнерами до закрытия исходного кода. Если вы хотите развернуть максимально свежую кодовую базу открытого форка Cal.diy под лицензией MIT и жестко запечь URL вашего домена в клиентский JavaScript-бандл Next.js, рекомендуется собрать контейнер напрямую из репозитория:

# Клонируем официальный открытый репозиторий Cal.diy
git clone https://github.com/calcom/cal.diy.git /opt/calcom-source
cd /opt/calcom-source

# Сборка контейнера с фиксацией вашего домена в бандле Next.js
docker compose build --build-arg NEXT_PUBLIC_WEBAPP_URL=https://meet.yourdomain.ru

# Либо запуск готового стека в /opt/calcom
cd /opt/calcom
docker compose up -d

# Проверяем успешный запуск всех 3 контейнеров и статус healthcheck
docker compose ps

4. Настройка Nginx, Let's Encrypt SSL и заголовки безопасности

Для обеспечения безопасного шифрованного протокола HTTPS, защиты от флуда и корректного проброса реальных IP-адресов посетителей используем хостовый веб-сервер Nginx с автоматическим выпуском сертификатов через Certbot. Если вам требуется сгенерировать файл конфигурации для других сервисов, воспользуйтесь интерактивным конфигуратором Nginx от SysKit.

Установка Nginx и Certbot

sudo apt-get update
sudo apt-get install -y nginx certbot python3-certbot-nginx

Конфигурация виртуального хоста Nginx с Rate Limiting

Создаем конфигурационный файл /etc/nginx/sites-available/calcom.conf. Директива limit_req_zone защищает форму записи от автоматизированных спам-ботов:

# Ограничение частоты запросов: до 10 запросов в секунду на IP
limit_req_zone $binary_remote_addr zone=calcom_req:10m rate=10r/s;

server {
    listen 80;
    server_name meet.yourdomain.ru;
    server_tokens off;
    client_max_body_size 20M;

    location / {
        # Применяем ограничение с буфером всплесков
        limit_req zone=calcom_req burst=20 nodelay;

        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;

        # Поддержка WebSocket для динамического обновления слотов
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # Буферизация и таймауты
        proxy_connect_timeout 60s;
        proxy_send_timeout 60s;
        proxy_read_timeout 60s;
    }
}

Активируем конфигурацию, проверяем синтаксис и выпускаем бесплатный SSL-сертификат Let's Encrypt с автоматическим редиректом с HTTP на HTTPS:

# Создаем символическую ссылку
sudo ln -sf /etc/nginx/sites-available/calcom.conf /etc/nginx/sites-enabled/

# Проверяем корректность директив
sudo nginx -t

# Перезагружаем веб-сервер
sudo systemctl reload nginx

# Выпускаем SSL-сертификат Let's Encrypt с авторедиректом на HTTPS
sudo certbot --nginx -d meet.yourdomain.ru --redirect --non-interactive --agree-tos -m admin@yourdomain.ru

Проверить корректность цепочки доверия и срок действия сертификата можно через онлайн-чекер SSL от SysKit.

5. Синхронизация с Яндекс Календарем, виджет на сайт и оповещения в Telegram

После завершения установки откройте в браузере адрес https://meet.yourdomain.ru. При первом посещении система предложит создать учетную запись главного администратора.

Синхронизация с Яндекс Календарем по CalDAV

Главное преимущество Cal.com перед зарубежными облаками — встроенная поддержка универсального протокола CalDAV. Это позволяет подключить личный или корпоративный Яндекс Календарь (а также Mail.ru или Nextcloud):

  1. В Яндекс ID создайте специальный Пароль приложения (раздел «Безопасность» → «Пароли приложений» → «Календарь»).
  2. В панели Cal.com перейдите в раздел Apps → CalDAV Server.
  3. Укажите параметры подключения:
    • CalDAV URL: https://caldav.yandex.ru
    • Username: ваш логин Яндекс (например, ivanov@yandex.ru или корпоративный адрес ivanov@company.ru)
    • Password: сгенерированный пароль приложения Яндекс.
  4. Нажмите Connect. Теперь Cal.com будет в реальном времени считывать все события из вашего Яндекс Календаря и мгновенно блокировать занятые слоты на странице бронирования, исключая накладки.

Встраивание виджета записи на сайт (Tilda, WordPress, Bitrix)

Чтобы добавить плавающую кнопку бронирования или встроить интерактивную сетку календаря прямо в тело страницы сайта, добавьте следующий легковесный JavaScript-сниппет перед закрывающим тегом </body>:

<!-- Кнопка вызова календаря Cal.com -->
<button data-cal-link="admin/30min" 
        data-cal-config='{"layout":"month_view"}' 
        style="background:#2563eb;color:#fff;padding:12px 24px;border-radius:8px;border:none;cursor:pointer;font-weight:600;">
  Записаться на консультацию
</button>

<!-- Скрипт инициализации виджета Cal.com -->
<script type="text/javascript">
  (function (C, A, L) { 
    let p = function (a, ar) { a.q.push(ar); }; 
    let d = C.document; 
    C.Cal = C.Cal || function () { 
      let cal = C.Cal; let ar = arguments; 
      if (!cal.loaded) { 
        cal.ns = {}; cal.q = cal.q || []; 
        d.head.appendChild(d.createElement("script")).src = A; 
        cal.loaded = true; 
      } 
      if (ar[0] === "init") { 
        let api = function () { p(api, arguments); }; 
        let namespace = ar[1]; 
        api.q = api.q || []; 
        typeof namespace === "string" ? (cal.ns[namespace] = api) && p(api, ar) : p(cal, ar); 
        return; 
      } 
      p(cal, ar); 
    }; 
  })(window, "https://meet.yourdomain.ru/embed/embed.js", "init");

  Cal("init", {origin:"https://meet.yourdomain.ru"});
  Cal("ui", {
    "styles": {"branding": {"brandColor": "#2563eb"}},
    "hideEventTypeDetails": false,
    "layout": "month_view"
  });
</script>

Мгновенные алерты в Telegram о новых записях

В панели Cal.com перейдите в Settings → Webhooks и добавьте новый вебхук:

  • Subscriber URL: укажите адрес обработчика вебхуков (например, сценарий в Activepieces, n8n или легковесный скрипт вашего Telegram-бота).
  • Events: выберите триггеры BOOKING_CREATED (создание новой записи), BOOKING_RESCHEDULED (перенос времени) и BOOKING_CANCELLED (отмена).

При каждом новом бронировании администратор или менеджер продаж моментально получает уведомление в Telegram с именем клиента, телефоном, выбранным временем и ссылкой на встречу.

Рекомендуемые VDS-провайдеры

Отказоустойчивые сервера с быстрыми NVMe и каналом до 1 Гбит/с

Выбор редакции
⚡

Timeweb Cloud — Быстрые NVMe VDS

Отличная производительность для стека Cal.com на Next.js: скоростные процессоры 3.3 ГГц для быстрого рендеринга страниц бронирования и минимальных задержек отклика.

Конфигурация
2 vCPU 3.3 ГГц • 4 ГБ RAM • 50 ГБ NVMe • Трафик без лимита
Премиум Tier III
🔷

Selectel — Корпоративная инфраструктура Tier III

Сертифицированные дата-центры уровня Tier III в РФ для надежного хранения персональных данных клиентов компании в полном соответствии с требованиями 152-ФЗ.

Конфигурация
2 vCPU • 4 ГБ RAM • 60 ГБ NVMe • Канал 100 Мбит/с
Быстрый старт
🟠

Beget — Простота и стабильность

Удобная панель управления, автоматические ежедневные бэкапы всего сервера и гибкая почасовая оплата для тестирования и боевого запуска сервиса онлайн-записи.

Конфигурация
2 vCPU • 4 ГБ RAM • 50 ГБ NVMe • Выделенный IPv4

6. Автоматическое резервное копирование PostgreSQL с алертами в Telegram

База данных Cal.com содержит критически важную деловую информацию: подтвержденные встречи, расписание специалистов компании, историю переносов и контактные данные клиентов. Потеря базы из-за сбоя диска или человеческой ошибки парализует работу отдела продаж и консультантов. Организуем ежедневное создание резервных копий с автоматическим контролем целостности и отчетом в Telegram.

Скрипт резервного копирования backup_calcom.sh

Создаем скрипт /opt/calcom/backup_calcom.sh, который выполняет экспорт PostgreSQL 16 в сжатом виде, удаляет копии старше 7 дней и передает статус операции через Telegram Bot API:

#!/usr/bin/env bash
# /opt/calcom/backup_calcom.sh
set -euo pipefail

# Каталоги и параметры
BACKUP_DIR="/opt/calcom/backups"
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
RETENTION_DAYS=7

# Настройки Telegram-бота (замените на свои значения)
TG_BOT_TOKEN="123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ"
TG_CHAT_ID="987654321"

send_telegram() {
    local text="$1"
    if [ -n "$TG_BOT_TOKEN" ] && [ -n "$TG_CHAT_ID" ]; then
        curl -s -X POST "https://api.telegram.org/bot${TG_BOT_TOKEN}/sendMessage" \
            -d "chat_id=${TG_CHAT_ID}" \
            --data-urlencode "text=${text}" \
            -d "parse_mode=HTML" > /dev/null || true
    fi
}

mkdir -p "$BACKUP_DIR"
cd /opt/calcom

# 1. Создание дампа PostgreSQL 16
PG_DUMP_FILE="${BACKUP_DIR}/calcom_db_${TIMESTAMP}.sql.gz"
if docker exec calcom_postgres pg_dump -U calcom_user calcom | gzip > "$PG_DUMP_FILE"; then
    DB_SIZE=$(du -h "$PG_DUMP_FILE" | cut -f1)
else
    send_telegram "❌ [Cal.com VDS] Ошибка создания дампа базы данных!"
    exit 1
fi

# 2. Ротация архивов старше указанного срока
find "$BACKUP_DIR" -type f -name "calcom_db_*.sql.gz" -mtime +"$RETENTION_DAYS" -delete

# 3. Отправка успешного отчета в Telegram
MESSAGE="✅ Бэкап Cal.com успешно создан!
📅 Дата: ${TIMESTAMP}
💾 Размер базы данных: ${DB_SIZE}
⏳ Ротация: копии старше ${RETENTION_DAYS} дн. удалены"

send_telegram "$MESSAGE"

Назначаем права на исполнение только суперпользователю и добавляем ночной запуск в cron:

# Ограничиваем доступ (только root)
sudo chmod 700 /opt/calcom/backup_calcom.sh

# Добавляем задачу в crontab на 03:30 ночи ежедневно
(crontab -l 2>/dev/null; echo "30 3 * * * /opt/calcom/backup_calcom.sh >> /var/log/calcom_backup.log 2>&1") | crontab -

7. Производительность, защита данных и соответствие 152-ФЗ

Формы онлайн-записи открыты для публичного интернета, поэтому сервер бронирования обязан быть защищен от автоматических спам-ботов, перегрузок и регуляторных рисков.

Рекомендации инженерной редакции SysKit по безопасности:
  • Соблюдение требований 152-ФЗ: для соблюдения закона о локализации персональных данных арендуйте серверы у проверенных отечественных провайдеров с дата-центрами в РФ (Timeweb Cloud, Selectel, Beget). Обязательно разместите в футере страницы бронирования ссылку на «Политику обработки персональных данных» компании.
  • Защита от флуда и спама (Rate Limiting): добавьте в конфигурацию Nginx директиву ограничения частоты запросов limit_req_zone $binary_remote_addr zone=calcom_req:10m rate=10r/s;, чтобы спам-боты не могли генерировать тысячи фиктивных бронирований.
  • Изоляция внутренних сервисов: база данных PostgreSQL и сервер Redis не должны иметь открытых портов во внешний интернет. Привязка к 127.0.0.1 полностью нивелирует угрозу сканирования и подбора паролей.
  • Автоматическая ротация сессий: ключ NEXTAUTH_SECRET гарантирует, что JWT-токены пользователей невозможно подделать со стороны клиента.

Инструменты SysKit по теме статьи

Бесплатные утилиты для проверки и диагностики вашего сервера

Вопросы и ответы (FAQ)

Популярные вопросы вебмастеров и сисадминов по данной теме

В чем разница между Cal.com и Cal.diy, и можно ли использовать платформу бесплатно?
Весной 2026 года основной коммерческий монорепозиторий Cal.com перешел на закрытую модель. Для открытого сообщества разработчики выпустили официальный форк Cal.diy (репозиторий calcom/cal.diy) под свободной лицензией MIT. Он включает ядро бронирования, публичные страницы, API v2 и CalDAV. В официальном README разработчики прямо предупреждают: «Cal.diy is intended for personal, non-production use» (для крупных корпораций они рекомендуют облако). Однако юридически лицензия MIT безоговорочно разрешает бесплатное коммерческое использование. Для экспертов, репетиторов, консультантов и малых сервисных команд это надежное рабочее решение на VDS, но сопровождение вы берете на себя.
Каково реальное потребление оперативной памяти и выдержит ли сервер с 2 ГБ RAM?
В режиме ожидания стек Cal.com (контейнер приложения Next.js, PostgreSQL 16 и Redis 7) суммарно потребляет около 600–850 МБ RAM. Во время активного рендеринга публичных страниц и синхронизации внешних календарей возможны кратковременные всплески до 1.2–1.5 ГБ. На VDS с 1–2 vCPU и 2 ГБ RAM при обязательном наличии 4 ГБ Swap система работает абсолютно стабильно и комфортно обслуживает до нескольких сотен бронирований в сутки.
Как подключить прием онлайн-оплаты за консультации через российские банки и платежные системы?
Нативно Cal.com поддерживает только зарубежный платежный сервис Stripe, который не принимает российские банковские карты. Однако платформа оснащена гибкой системой исходящих Webhooks. Для приема платежей в РФ (карты МИР, СБП, ЮKassa, Robokassa, Prodamus) создается вебхук на событие BOOKING_CREATED, который передает данные во внешний сценарий автоматизации (n8n, Activepieces или веб-скрипт). Сценарий формирует счет на оплату клиенту, а после подтверждения транзакции от банка переводит статус бронирования в подтвержденный через Cal.com API v2.
Как обновить Cal.com на новую версию в Docker Compose?
Для обновления перейдите в рабочую директорию /opt/calcom. Если вы используете официальный prebuilt-образ, выполните: docker compose pull && docker compose down && docker compose up -d. Если вы собираете кастомный образ из репозитория calcom/cal.diy с запеканием собственного домена в Next.js бандл, выполните: docker compose build --build-arg NEXT_PUBLIC_WEBAPP_URL=https://meet.yourdomain.ru, затем перезапустите контейнеры. Миграции схемы базы данных Prisma применятся автоматически. Перед обновлением всегда создавайте резервную копию базы скриптом backup_calcom.sh.

Читайте также в блоге SysKit

Смежные руководства и полезные технические статьи