Юрий Осипов · Основатель, SEO и аналитика

Payload CMS: админка, которая живёт в вашем репозитории

Большинство CMS просят команду подстроиться под их модель данных. Payload просит её написать. Из этого решения следует всё остальное: и любовь разработчиков, и то, что он подходит не каждому клиенту.

Коротко

Что такое Payload на практике

Это headless CMS, написанная на TypeScript. Вы ставите её зависимостью, описываете контент в payload.config.ts и получаете сразу три вещи: админку, API на REST и GraphQL и сгенерированные TypeScript‑типы.

// payload.config.ts
import { buildConfig } from 'payload'
import { postgresAdapter } from '@payloadcms/db-postgres'

export default buildConfig({
  collections: [
    {
      slug: 'posts',
      fields: [
        { name: 'title', type: 'text', required: true },
        { name: 'slug', type: 'text', required: true, unique: true },
        { name: 'body', type: 'richText' },
      ],
    },
  ],
  db: postgresAdapter({ pool: { connectionString: process.env.DATABASE_URL } }),
})

Этот файл и есть продукт. Поля вкладываются друг в друга, собираются в блоки, переводятся, валидируются и защищаются функциями доступа, которые получают текущего пользователя. Ничего в модели контента не спрятано в интерфейсе, которым умеет пользоваться один человек.

Кому подходит

Не подходит, когда в команде никто не хочет владеть сервером или когда публиковать надо послезавтра, а схема ещё обсуждается.

Как связать с Astro

Интеграция нарочно скучная — в этом и смысл. Payload отдаёт /api/<коллекция>, Astro забирает данные на сборке.

// src/lib/payload.ts
const CMS = import.meta.env.PAYLOAD_URL

export async function getPosts() {
  const res = await fetch(`${CMS}/api/posts?limit=100&depth=1`)
  if (!res.ok) throw new Error(`Payload: ${res.status}`)
  return (await res.json()).docs
}

Дальше обычный маршрут Astro превращает это в страницы:

export async function getStaticPaths() {
  const posts = await getPosts()
  return posts.map((post) => ({ params: { slug: post.slug }, props: { post } }))
}

Две детали, которые делают работу приятной:

Rich text хранится структурированным документом, а не готовым HTML, поэтому вы раскладываете его по своим компонентам, а не доверяете разметке редактора. Сначала это лишняя работа, зато после редизайна результат заметно лучше.

Что получает редактор

Админка — обычный React, а не конструктор страниц: слева список коллекций, справа поля, панель предпросмотра, если её подключить. Тот, кто работал в WordPress, узнает ритм за десять минут. Чего не будет — свободного перетаскивания блоков: схема решает, какой может быть страница. Именно поэтому фронтенд остаётся предсказуемым.

Сильные стороны

Слабые стороны

Последний пункт — не недостаток, а следствие. Но он меняет ответ на вопрос «кто у нас двигается быстро».

Сколько это стоит в работе

Денег вендору — ноль, времени — вполне конкретно. Нужен сервер с Node, база с бэкапами, обновления зависимостей и кто‑то, кто разберётся, если сборка упала в пятницу. Для студии это обычная работа. Для компании без разработчика в штате — отдельная статья расходов, которую лучше обсудить до, а не после запуска.

Когда выбирать Payload

Выбирайте, когда CMS — часть продукта, а не отдельный инструмент: нужны свои правила доступа, бизнес‑логика рядом с контентом или модель, которую не покроет готовый шаблон. И когда команда готова обслуживать Node‑сервис и предпочитает отлаживать свой код, а не чужой чёрный ящик.

Не выбирайте, если сайт — визитка с тремя редакторами и без серверных задач: Keystatic доведёт до результата за вечер, а Sanity избавит от сервера совсем.

Итог

Payload — вариант, к которому мы идём, когда клиенту нужна CMS, которой он владеет, на языке, на котором уже говорят его разработчики. Это не самый дешёвый в эксплуатации и не самый быстрый старт, зато через три года он остаётся понятным.

Дальше: сравнение со всеми вариантами — в материале какая headless CMS лучше для Astro, облачная альтернатива — в руководстве по Sanity, общая картина — на хабе headless CMS. Если хотите, чтобы это построили и аккуратно передали, — это наша разработка сайтов.

Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.

Юрий Осипов

Юрий Осипов

Основатель, SEO и аналитика

Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.

Все статьи автора →
Payload бесплатный?
Да, Payload распространяется по лицензии MIT, и на своей инфраструктуре вы не платите за лицензию. Расходы — сервер, база данных и ваша поддержка; для тех, кто не хочет этим заниматься, есть облачный вариант.
Нужен ли Next.js, чтобы использовать Payload с Astro?
Технически нет, но понимать, что вы деплоите, нужно: в третьей версии админка Payload живёт внутри приложения Next.js. То есть появляется один Node‑сервис для CMS и отдельная сборка Astro для публичного сайта — фронтенд остаётся на Astro.
Какая база данных подходит для Payload?
PostgreSQL, MongoDB или SQLite — через адаптеры, которые указываются в том же файле конфигурации. Для продакшена чаще берут Postgres: понятные бэкапы, миграции и мониторинг.
Как редакторы смотрят черновики до публикации?
В Payload есть черновики, версии и панель живого предпросмотра, которую можно направить на сайт Astro. Обычно предпросмотр идёт отдельным маршрутом с токеном и тянет черновую версию, а публичный сайт продолжает отдавать предрендеренные страницы.
Можно ли потом уйти с Payload?
Да. Схема лежит в коде, данные — в обычной базе: коллекции — это таблицы, загрузки — файлы на диске или в объектном хранилище. Реальная привязка — не данные, а доработки админки, которые вы написали.

Нужен высокопроизводительный сайт?

Давайте обсудим, как мы можем помочь вашему бизнесу расти.