Payload CMS: админка, которая живёт в вашем репозитории
Большинство CMS просят команду подстроиться под их модель данных. Payload просит её написать. Из этого решения следует всё остальное: и любовь разработчиков, и то, что он подходит не каждому клиенту.
Коротко
- Payload — CMS на TypeScript под лицензией MIT, которую вы настраиваете кодом и хостите сами.
- Схема — это файл: коллекции, поля, правила доступа и хуки лежат в репозитории.
- REST и GraphQL генерируются автоматически, плюс есть Local API, который обходится без HTTP.
- С Astro разделение чистое: Payload отдаёт контент, Astro предрендерит страницы на сборке.
- Плата — эксплуатация: Node‑сервис, база данных и человек, который за ними следит.
Что такое 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 } }),
})
Этот файл и есть продукт. Поля вкладываются друг в друга, собираются в блоки, переводятся, валидируются и защищаются функциями доступа, которые получают текущего пользователя. Ничего в модели контента не спрятано в интерфейсе, которым умеет пользоваться один человек.
Кому подходит
- Продуктовым командам на TypeScript, которым нужен контент и код в одном репозитории и один pull request на изменение.
- Проектам с настоящими правами доступа — редактор видит только свой язык, клиент — только свои записи.
- Тем, кому нужны свои эндпоинты рядом с контентом: CMS работает в том же процессе, что и серверный код.
- Студиям, которые передают клиенту кодовую базу, а не подписку.
Не подходит, когда в команде никто не хочет владеть сервером или когда публиковать надо послезавтра, а схема ещё обсуждается.
Как связать с 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 } }))
}
Две детали, которые делают работу приятной:
- Типы приходят из CMS. Запустите
payload generate:typesи импортируйтеPostизpayload-types.ts: переименованное в конфиге поле ломаетastro checkраньше, чем сайт. - Черновики идут вторым путём. Для предпросмотра добавьте маршрут по запросу, который запрашивает черновую версию с токеном; всё публичное остаётся статикой.
Rich text хранится структурированным документом, а не готовым HTML, поэтому вы раскладываете его по своим компонентам, а не доверяете разметке редактора. Сначала это лишняя работа, зато после редизайна результат заметно лучше.
Что получает редактор
Админка — обычный React, а не конструктор страниц: слева список коллекций, справа поля, панель предпросмотра, если её подключить. Тот, кто работал в WordPress, узнает ритм за десять минут. Чего не будет — свободного перетаскивания блоков: схема решает, какой может быть страница. Именно поэтому фронтенд остаётся предсказуемым.
Сильные стороны
- Владение. Лицензия MIT, ваша база, ваш сервер, ваш репозиторий.
- Один язык. Конфигурация, хуки, права и фронтенд — всё на TypeScript.
- Типы, которые переживают рефакторинг. Они генерируются из схемы.
- Local API. Серверный код обращается к базе напрямую, без HTTP.
- Редакторские функции. Черновики, версии, живой предпросмотр, локализация, загрузка файлов с ресайзом.
Слабые стороны
- Эксплуатация на вас. Деплой, бэкапы, обновления базы и мониторинг — ваши.
- В третьей версии приезжает Next.js. Админка — это Next.js‑приложение, поэтому рядом со статикой появляется Node‑сервис.
- Экосистема плагинов меньше, чем у WordPress или Strapi: часть интеграций придётся написать.
- Изменение схемы — изменение кода. Хорошо для ревью, медленно для маркетолога, которому поле нужно «сейчас».
Последний пункт — не недостаток, а следствие. Но он меняет ответ на вопрос «кто у нас двигается быстро».
Сколько это стоит в работе
Денег вендору — ноль, времени — вполне конкретно. Нужен сервер с Node, база с бэкапами, обновления зависимостей и кто‑то, кто разберётся, если сборка упала в пятницу. Для студии это обычная работа. Для компании без разработчика в штате — отдельная статья расходов, которую лучше обсудить до, а не после запуска.
Когда выбирать Payload
Выбирайте, когда CMS — часть продукта, а не отдельный инструмент: нужны свои правила доступа, бизнес‑логика рядом с контентом или модель, которую не покроет готовый шаблон. И когда команда готова обслуживать Node‑сервис и предпочитает отлаживать свой код, а не чужой чёрный ящик.
Не выбирайте, если сайт — визитка с тремя редакторами и без серверных задач: Keystatic доведёт до результата за вечер, а Sanity избавит от сервера совсем.
Итог
Payload — вариант, к которому мы идём, когда клиенту нужна CMS, которой он владеет, на языке, на котором уже говорят его разработчики. Это не самый дешёвый в эксплуатации и не самый быстрый старт, зато через три года он остаётся понятным.
Дальше: сравнение со всеми вариантами — в материале какая headless CMS лучше для Astro, облачная альтернатива — в руководстве по Sanity, общая картина — на хабе headless CMS. Если хотите, чтобы это построили и аккуратно передали, — это наша разработка сайтов.
Скриншоты в этой серии — план; мы заменим их собственными, снятыми на реальных проектах.
Юрий Осипов
Основатель, SEO и аналитика
Руководит Take the Space. Специализируется на техническом SEO, измеримой аналитике и видимости в ИИ‑поиске.