Что такое Strapi CMS
Привет! Я Артем, fullstack разработчик в evilUnion. В этой статье расскажу про Strapi на примере реального проекта: как мы перенесли сервис с WordPress на Strapi и Astro, какие возможности Strapi для этого пригодились и что получилось в итоге.
Strapi это CMS с открытым исходным кодом на Node.js. По сути это готовый бэкенд для контента: вы описываете сущности и поля, а Strapi создаёт под них таблицы в базе, админку для редактирования и API. В качестве базы можно использовать PostgreSQL, MySQL, MariaDB или SQLite.
В отличие от WordPress и других классических CMS, Strapi не занимается внешним видом сайта. Шаблонов и тем здесь нет, он только хранит контент и отдаёт его по API. Фронтенд пишется отдельно на любом стеке, а к тем же данным могут обращаться мобильное приложение, CRM или любой другой сервис.
Что есть из коробки:
Content-Type Builder: визуальный конструктор коллекций и полей в админке
компоненты и динамические зоны: переиспользуемые блоки, из которых редакторы сами собирают страницы
админ панель для редакторов с черновиками и публикацией
система пользователей, ролей и прав доступа
REST и GraphQL API, которые генерируются автоматически по модели данных
Все роуты API по умолчанию закрыты, доступ к каждой коллекции открывается явно для конкретной роли. Для сторонних сервисов есть API токены с ограниченным доступом, а пароли и служебные поля в ответ API не попадают.
Дисклеймер: примеры кода в статье упрощены, чтобы показать сами инструменты Strapi, и в таком виде не подходят для продакшена.
Почему мы выбрали Strapi
Это расширяемый и лёгкий в освоении фреймворк. Создаёшь коллекции в админке и сразу получаешь рабочий API, а дальше постепенно добавляешь свою логику, не переписывая то, что уже есть. Поэтому мы используем Strapi не только как CMS, но и как полноценный бэкенд в своих проектах.
Внутри Strapi работает на Koa, и расширить можно практически любой его уровень, от API до админки. База, авторизация, права и админка уже готовы, остаётся только бизнес-логика. У Strapi большое комьюнити, больше 73 тысяч звёзд на GitHub, и много готовых плагинов, а если нужного нет, можно написать свой.
Развернуть Strapi можно в облаке или на своём сервере. Во втором случае код, база и данные пользователей полностью под вашим контролем.
Кейс: переезд сервиса для врачей с WordPress на Strapi
Возможности Strapi покажу на примере нашего кейса: переезда с WordPress на Strapi и Astro. Это сервис с платной подпиской на медицинские материалы для врачей: статьи, клинические рекомендации, гайды в PDF и курсы. Аудитория большая, контента много, часть материалов открыта всем, остальное доступно по подписке.
Сайт работал на WordPress, подписки и оплаты были сделаны на плагинах. Со временем начались проблемы:
сайт медленно грузился, на мобильных Lighthouse показывал 44 балла
админка работала медленно, открытие и сохранение материалов занимало много времени
были взломы
данным во встроенной CRM сложно было доверять: цифры в разных разделах не сходились из-за внутренних фильтров, логику которых было трудно понять
Контент у проекта сложный: статьи с аккордеонами, таблицами и всплывающими пояснениями, страницы курсов из множества секций. А вокруг него своя бизнес-логика: оплаты и автосписания, промокоды, реферальная программа, личный кабинет, вход через соцсети. Поэтому нужна была не просто CMS, а бэкенд, где всё это собрано в одном месте.
Решили переезжать на Strapi для бэкенда и Astro для фронта. Переезд нужен был полный, со всеми данными, чтобы никто не потерял доступ к своим подпискам и платному контенту.
Забегая наперёд: Lighthouse на мобильных вырос с 44 до 100, а выручка по подпискам выросла на 225% к тому же периоду прошлого года.
Как устроен Strapi
Коллекции, schema.json и REST API в Strapi
Разберём на простом примере: коллекция «Статья» с заголовком, текстом и категорией. Модель можно создать в Content-Type Builder или описать вручную в schema.json, это одно и то же. Strapi по этой схеме создаёт таблицу в базе и поля в админке:

{
"kind": "collectionType",
"info": { "singularName": "article", "pluralName": "articles" },
"options": { "draftAndPublish": true },
"attributes": {
"title": { "type": "string", "required": true },
"content": { "type": "richtext" },
"category": {
"type": "relation",
"relation": "manyToOne",
"target": "api::category.category"
}
}
}
После этого у статьи сразу появляются стандартные эндпоинты: GET /api/articles, GET /api/articles/:id, POST, PUT, DELETE. Писать для них ничего не нужно, достаточно открыть доступ нужной роли.

Когда приходит запрос, он проходит такой путь:
запрос → роут → middleware и policies → контроллер → сервис → Document Service API → база
Каждый шаг можно переопределить: middleware и policies проверяют запрос до контроллера, контроллер формирует ответ, а сервис содержит саму логику. Как добавлять свою логику, разберём в разделе про бэкенд.
Повторяющиеся блоки выносятся в компоненты, например «Вопрос и ответ» или «Карточка преподавателя». А динамическая зона позволяет редактору самому собирать страницу из разрешённых компонентов в нужном порядке.
Модель данных в Strapi: коллекции и компоненты
Всё разделили на две группы: контент и пользовательские данные. Всё, что живёт само по себе и на что можно сослаться, сделали коллекциями. Всё, что существует только внутри другой записи, сделали компонентами. Например, аккордеон внутри статьи это компонент, а категория статьи это отдельная коллекция со связью.
Для пользователей сделали отдельную коллекцию профиля, а не стали расширять стандартного пользователя из плагина users-permissions. От профиля идут связи к подпискам, платежам, купленным гайдам, промокодам, сессиям и избранному, а подписка связана с тарифом и платежами. Так по любой записи легко восстановить цепочку: кто купил, по какому тарифу, каким платежом и с каким промокодом.
Strapi и Astro: фронтенд для контентного сайта
Astro это фреймворк для быстрых сайтов, ориентированных на контент. В отличие от Next.js или Nuxt, которые отправляют в браузер JavaScript всего приложения, Astro по умолчанию отдаёт чистый HTML. Интерактивными становятся только отдельные компоненты, так называемые острова, и только они загружают свой код. Острова можно писать на React, Vue, Svelte и других библиотеках, а SSG или SSR выбирается для каждой страницы отдельно.
Сейчас Astro один из самых быстрорастущих фреймворков для контентных сайтов. Меньше JavaScript означает более быструю загрузку и хорошие показатели Core Web Vitals почти без дополнительной оптимизации, а это напрямую влияет на SEO. Синтаксис компонентов близок к обычному HTML, поэтому порог входа низкий, а готовые компоненты на React или Vue можно переиспользовать без переписывания.
Как мы используем Astro со Strapi: SSR, кэш и prefetch
На сайте много страниц, и ведут они себя по-разному. Одни меняются редко, другие, например статьи и каталоги материалов, редакторы обновляют постоянно. В Astro это можно контролировать на уровне каждой страницы: основные страницы отдаются как статика, а часто меняющиеся рендерятся на сервере через SSR и кэшируются в nginx.
---
// страница, которая собирается при билде
export const prerender = true;
---
Страница собирается на сервере из данных Strapi, а интерактивные части подключаются как React острова:
---
const { data } = await fetchApi({ endpoint: 'articles', query: { filters: { slug } } });
---
<ArticleHeader title={data.title} />
<ArticleBody content={data.content} />
<FavouriteButton client:visible articleId={data.documentId} />
На сервере рендерится только открытый контент, а всё, что зависит от пользователя, догружается на клиенте: закрытые материалы, личный кабинет, уведомления. Поэтому страницы одинаковые для всех и их можно кэшировать в nginx, а если правку нужно показать сразу, кэш сбрасывается из админки Strapi.
Кэшированная страница отдаётся без обращения к Strapi, а prefetch в Astro начинает её загружать, как только пользователь наводит курсор на ссылку. Сейчас переход между страницами занимает около 0,5 секунды, на старом сайте он занимал 2,5.

Работа с контентом глазами редактора
Для редакторов главное, чтобы с материалами было удобно работать и не приходилось звать разработчика по каждой мелочи.
Динамические зоны: конструктор страниц в Strapi
Вся работа с контентом идёт в Content Manager: слева список коллекций, внутри таблица записей с поиском, фильтрами и сортировкой. Запись открывается как форма с полями из модели.
Самое интересное начинается на страницах, которые собираются из секций. Например, на странице курса редактор нажимает «Добавить компонент» в динамической зоне и выбирает секцию: программа, преподаватели, тарифы, отзывы, FAQ. Секции можно перетаскивать, сворачивать и удалять, так что страница любой структуры собирается без разработчика. Связи с другими записями выбираются из списка с поиском: если преподаватель поменял фото, оно обновится на всех страницах, где он указан.

Media Library в Strapi
Изображения и файлы хранятся в Media Library. Её можно открыть отдельно или прямо из поля записи, файлы раскладываются по папкам, у изображений есть alt, подпись и обрезка. При загрузке Strapi сам создаёт копии нескольких размеров, чтобы на телефоне не грузить оригинал.

Редактор текста: Markdown, Blocks и CKEditor 5
Встроенных редакторов Strapi, Markdown и Blocks, для сложных статей не хватало, например в них нет полноценной работы с таблицами. Поэтому мы поставили плагин с CKEditor 5: таблицы, выравнивание, индексы, спецсимволы, медиа и редактирование HTML.
CKEditor можно расширять своими плагинами. Мы дописали метки УДД и УУР для клинических рекомендаций, скрытие изображений и текста, горячие кнопки со всплывающими пояснениями и обработку Tab для вложенных списков. А выбор шрифта, размера и цвета текста убрали, чтобы оформление статей оставалось единым.

Draft & Publish: черновики и редиректы
У всех основных коллекций включены черновики: опубликованная версия и черновик хранятся отдельно, и на сайте остаётся старый вариант, пока редактор не нажмёт «Опубликовать».
Черновики пригодились и для редиректов. Если у статьи меняется адрес, старая версия остаётся в черновиках с полем redirect_url, и фронт делает по нему редирект. Так редактор управляет редиректами в той же админке.
Превью в Strapi 5
В Strapi 5 появилось встроенное превью, и это одна из самых полезных функций для редакторов. Кнопка «Открыть превью» показывает страницу прямо внутри админки так, как она будет выглядеть на сайте, а между черновиком и опубликованной версией можно переключаться.
Strapi сам не знает, как выглядит ваш сайт, поэтому превью нужно связать с фронтом. В конфиге админки указывается функция, которая по типу записи возвращает адрес страницы превью:
// config/admin.js
preview: {
enabled: true,
config: {
allowedOrigins: [env('PREVIEW_URL')],
async handler(uid, { documentId, status }) {
const pathname = getPreviewPathname(uid, documentId);
if (!pathname) return null;
return `${env('PREVIEW_URL')}${pathname}?token=${env('PREVIEW_SECRET')}&status=${status}`;
},
},
},
На фронте страница превью проверяет секретный токен и рендерит запись теми же компонентами, что и сайт, без кэша, так что редактор всегда видит актуальную версию. Рядом с записью мы ещё добавили кнопки «Открыть страницу» и «Обновить кэш», чтобы срочную правку редактор мог выкатить сам.
Условные поля в Strapi
Чтобы форма записи не превращалась в простыню, часть полей показывается только по условию. Например, цена и пробная версия появляются у гайда, только если он отмечен как платный:
"price": {
"type": "decimal",
"conditions": {
"visible": { "==": [{ "var": "isPremium" }, true] }
}
}

Роли и права редакторов
Редакторы работают под ролями с ограниченным доступом. Есть нюанс: на новое поле у кастомных ролей нет прав, и вместо него в форме появляется «No permissions to see this field». Права нужно выдавать вручную, об этом легко забыть.
Бэкенд на Strapi: своя бизнес-логика
Наш кейс это не только статьи и гайды, а полноценная платформа: личный кабинет, подписки и автосписания, покупки, промокоды, рефералка, вход через соцсети, уведомления и письма. Для такого проекта нужен бэкенд со своей бизнес-логикой, и Strapi закрывает и эту часть. Ниже основные инструменты, которые для этого есть.
Покажем их на одном сквозном примере: у статьи есть время чтения и счётчик просмотров, а раз в неделю отмечаются популярные материалы.
Кастомные роуты, контроллеры и сервисы
Если стандартных эндпоинтов не хватает, рядом с ними добавляются свои. Стандартный контроллер расширяется новым методом, а встроенные find, findOne и остальные продолжают работать. Саму логику лучше держать в сервисе: он доступен из любого места приложения, от контроллеров до крон задач.
// src/api/article/routes/custom.js
module.exports = {
routes: [{ method: 'POST', path: '/articles/:documentId/view', handler: 'article.view' }],
};
// src/api/article/controllers/article.js
module.exports = createCoreController('api::article.article', ({ strapi }) => ({
async view(ctx) {
await strapi.service('api::article.article').incrementViews(ctx.params.documentId);
ctx.status = 204;
},
}));
// src/api/article/services/article.js
module.exports = createCoreService('api::article.article', ({ strapi }) => ({
async incrementViews(documentId) {
const article = await strapi.documents('api::article.article').findOne({ documentId });
await strapi.documents('api::article.article').update({
documentId,
data: { views: (article.views ?? 0) + 1 },
});
},
}));
Middleware
Middleware в Strapi это обычная Koa функция. Она может выполнить что-то до контроллера, а после await next() получить готовый ответ и изменить его. Например, проставить заголовки кэширования для публичных ответов API:
// src/middlewares/cache-headers.js
module.exports = (config, { strapi }) => {
return async (ctx, next) => {
await next();
if (ctx.method === 'GET' && ctx.url.startsWith('/api/articles') && ctx.status === 200) {
ctx.set('Cache-Control', 'public, max-age=60');
}
};
};
Подключается он одной строкой в config/middlewares.js, глобально или только для нужных роутов. Это удобное место для проверок и правил, которые касаются сразу многих эндпоинтов.
Lifecycles
Lifecycles позволяют выполнить код до или после создания, обновления и удаления записи. Например, пересчитывать время чтения при каждом сохранении статьи:
// src/api/article/content-types/article/lifecycles.js
const getReadingTime = (html = '') => Math.ceil(html.replace(/<[^>]+>/g, ' ').split(/\s+/).length / 200);
module.exports = {
beforeCreate(event) {
event.params.data.readingTime = getReadingTime(event.params.data.content);
},
beforeUpdate(event) {
if (event.params.data.content) {
event.params.data.readingTime = getReadingTime(event.params.data.content);
}
},
};
Хуки можно задать для конкретной модели или подписаться на события сразу всех моделей в одном месте, например чтобы отправлять изменения в другую систему.
Cron задачи
Крон задачи описываются прямо в конфиге сервера, отдельный планировщик не нужен. Например, раз в неделю отмечать самые просматриваемые статьи:
// config/server.js
cron: {
enabled: true,
tasks: {
'0 3 * * 1': async ({ strapi }) => {
await strapi.service('api::article.article').markPopular({ limit: 10 });
},
},
},
Плагины Strapi
С плагинами возможностей Strapi становится ещё больше. Они ставятся через npm или из Marketplace в админке и настраиваются в config/plugins.js. Ниже то, что пригодилось в нашем кейсе.

CKEditor
Плагин заменяет встроенный редактор Strapi на CKEditor 5. В нём есть таблицы, медиа, редактирование HTML, а набор кнопок на панели настраивается в конфиге. К CKEditor можно писать свои плагины, так мы добавили в редактор кнопки под медицинский контент. Подробнее про это мы писали выше в пункте «Редактор текста».
Поиск в Strapi на Meilisearch
Материалов много, и искать нужно как по всему сайту, так и внутри раздела, например только по гайдам. При этом врачи часто пишут слово в другой форме, с опечаткой или описывают тему своими словами.
Для поиска мы взяли Meilisearch. Это самостоятельный open source движок, но в Strapi он легко подключается через плагин. В админке появляется страница, где выбирают, какие коллекции индексировать, и дальше индекс обновляется автоматически при каждом изменении записи.

В конфиге для каждой коллекции можно указать, какие связанные данные подтягивать в индекс и как преобразовать запись:
// config/plugins.js
meilisearch: {
config: {
host: env('MEILISEARCH_HOST'),
apiKey: env('MEILISEARCH_API_KEY'),
article: {
entriesQuery: {
populate: { content: { populate: { accordion: true } } },
},
transformEntry({ entry }) {
return {
...entry,
contentPlain: stripHtml(entry.content),
stemmedTitle: stemText(entry.title),
};
},
settings: {
embedders: {
default: {
source: 'huggingFace',
model: 'sentence-transformers/paraphrase-multilingual-MiniLM-L12-v2',
},
},
},
},
},
},
В индекс попадает весь текст статьи вместе с аккордеонами, а слова приводятся к основе. Опечатки Meilisearch прощает сам, а через открытую мультиязычную модель эмбеддингов работает ещё и поиск по смыслу. В итоге поиск гибридный: половина веса у совпадения слов, половина у смысла. Глобальный поиск ищет по нескольким индексам одним запросом, а поиск по разделу обращается к одному.
Очереди в Strapi на BullMQ
На фронте у нас работает модуль аналитики, который отправляет события: просмотры страниц, открытие аккордеонов, скачивания, клики по баннерам. Если записывать каждое событие в ClickHouse прямо в запросе, при большом трафике бэкенд начнёт тормозить.
Поэтому запись вынесли в очереди на BullMQ, библиотеке для фоновых задач поверх Redis. Для Strapi есть плагин, и очереди с воркерами доступны как обычный сервис:
// эндпоинт только ставит событие в очередь и сразу отвечает
const queue = strapi.plugin('bullmq').service('queue').get('analytics');
await queue.add('track', event, {
attempts: 3,
backoff: { type: 'exponential', delay: 2000 },
});
// воркер в фоне забирает события и пишет их в ClickHouse
strapi.plugin('bullmq').service('worker').create(queue, async (job) => {
await writeToClickHouse(job.data);
});
Если задача упала, она повторится сама. Через те же очереди у нас работают выгрузки и отмена зависших платежей. А чтобы видеть, что с ними происходит, подключили Bull Board, веб-интерфейс с очередями и ошибками, который открывается отдельной страницей на сервере Strapi.
Документация Strapi API: OpenAPI и Swagger
Официальный пакет OpenAPI генерирует документацию по всем роутам. Стандартные эндпоинты описываются автоматически, а описания своих роутов мы дописывали с помощью ИИ агентов. В итоге у фронта и интеграций всегда есть актуальный Swagger.
Кастомизация админки Strapi
Если готового плагина под задачу нет, админку можно доработать самим. Она написана на React и расширяется через src/admin/app.js: можно добавить панель на страницу записи, кнопку в список записей, поле или целую страницу. Благодаря дизайн-системе Strapi доработки выглядят как родная часть интерфейса.
// src/admin/app.js
export default {
bootstrap(app) {
const contentManager = app.getPlugin('content-manager');
// панель справа на странице редактирования записи
contentManager.apis.addEditViewSidePanel([ActionsPanel]);
// своя кнопка над списком записей
contentManager.injectComponent('listView', 'actions', {
name: 'category-order-sort',
Component: CategoryOrderSort,
});
},
};
Например, редакторам нужно было самим менять порядок категорий на сайте. Готовый плагин для drag-n-drop приходилось настраивать у каждого администратора отдельно, поэтому мы написали свою кнопку «Поменять порядок», где категории просто перетаскиваются.

CRM на Strapi API
В старой CRM на WordPress цифры в разных разделах не сходились. Поэтому новую CRM мы построили прямо на Strapi. Раз Strapi отдаёт всё через API, CRM не нужна своя база: это отдельное приложение на React и TypeScript, которое работает с тем же Strapi API, что и сайт. Пользователи, подписки и платежи в CRM и на сайте одни и те же, расхождений больше нет.
Для таблиц используются стандартные возможности REST API Strapi: фильтры, сортировка, пагинация на стороне сервера и выбор связей через populate. Поэтому CRM не загружает всех пользователей сразу, а запрашивает только нужную страницу, а колонки и фильтры менеджер настраивает под себя. Любую выборку можно выгрузить в Excel.
Вход в CRM работает через стандартный плагин Users & Permissions. Права настраиваются по разделам и действиям: кто может только смотреть пользователей, кто редактировать промокоды, кто запускать рекламу. Роли с наборами прав хранятся в обычной коллекции Strapi, поэтому новую роль администратор создаёт сам, без изменений в коде.
Фронтенд CRM писали с агентом Claude Code по спецификации: заранее описали в markdown типы данных, экраны и формат запросов к Strapi, разбили работу на этапы, а агент реализовывал их по очереди и вёл журнал изменений. У всех коллекций Strapi одинаковые эндпоинты, фильтры и пагинация, поэтому формат запроса хватило описать в спецификации один раз, а дальше агент применял его ко всем таблицам CRM.
В итоге в CRM на Strapi есть разделы пользователей, платежей, промокодов, рекламы, сегментов и аналитики. Ниже подробнее про самые интересные из них.

Сегменты пользователей
Самая важная часть CRM это сегменты, группы пользователей, отобранные по правилам. Например, «врачи с активной подпиской, которая заканчивается через неделю» или «пользователи, у которых не прошло автосписание».
Сервис живёт на подписке, и важно вовремя обращаться к нужным людям: напомнить о продлении, предложить скидку тем, кто давно не заходил, показать баннер курса врачам нужной специальности. Типов правил больше двадцати, от статуса подписки и специальности до посещённых страниц и событий аналитики. Их можно комбинировать через AND и OR, а сегменты строить и по зарегистрированным пользователям, и по анонимным посетителям.

Правила хранятся в JSON поле коллекции сегментов. Чтобы посчитать сегмент, дерево правил рекурсивно превращается в обычный фильтр Strapi:
async function evaluateNode(node) {
if (node.logic) {
const filters = await Promise.all(node.conditions.map(evaluateNode));
return node.logic === 'AND' ? { $and: filters } : { $or: filters };
}
return evaluators[node.type](node);
}
const filters = await evaluateNode(segment.conditions);
const users = await strapi.documents('api::profile.profile').findMany({ filters });
Свой язык запросов писать не пришлось, почти все правила сводятся к стандартным фильтрам Strapi. Сегменты пересчитываются в фоне каждые 30 минут через очередь, а для массовой вставки результата используется Knex, доступный через strapi.db.connection. Дальше сегменты синхронизируются со списками рассылок в Unisender и используются для показа рекламы.
Рекламный модуль
Реклама тоже управляется из CRM. Рекламная кампания это обычная коллекция в Strapi с тремя форматами: баннер в шапке, попап и баннер в личном кабинете. Баннер можно загрузить картинками, HTML5 архивом или собрать во встроенном конструкторе, в том числе в варианте для акций со скидкой и копируемым промокодом.
Перед запуском баннер смотрят в окне превью, которое растягивается и масштабируется под разные экраны. Для кампании задаётся, кому её показывать (всем или выбранным сегментам), на каких страницах и сколько раз за сессию. На сайте один эндпоинт Strapi определяет сегменты посетителя и отдаёт только подходящие баннеры, а показы и клики уходят в аналитику. В итоге маркетинг сам запускает рекламу на нужную аудиторию за несколько минут.
Аналитика: ClickHouse и Yandex DataLens
Дашборды собраны в Yandex DataLens поверх данных в ClickHouse и встроены прямо в CRM. Подписанный токен для встраивания выдаёт эндпоинт Strapi, поэтому ключ не попадает на фронт.
Миграция с WordPress на Strapi
Самой трудоёмкой частью переезда оказался не новый сайт, а данные: пользователи, подписки, платежи, купленные гайды, промокоды, избранное.
Как хранятся данные в WordPress
WordPress изначально задумывался как движок для блога. Почти всё, что не является пользователем, лежит в одной таблице wp_posts и различается полем post_type, а дополнительные поля хранятся в wp_postmeta и wp_usermeta в формате ключ и значение. Каждый плагин складывает туда данные по-своему, и чтобы просто собрать пользователя, приходится разворачивать десятки строк в одну:
SELECT
u.ID,
u.user_email,
MAX(CASE WHEN um.meta_key = 'first_name' THEN um.meta_value END) AS first_name,
MAX(CASE WHEN um.meta_key = 'telefon_lk' THEN um.meta_value END) AS phone,
MAX(CASE WHEN um.meta_key = 'user_registration_select_1667036325' THEN um.meta_value END) AS status,
MAX(CASE WHEN um.meta_key = 'user_registration_select_1667037133924' THEN um.meta_value END) AS specialty
FROM wp_users u
LEFT JOIN wp_usermeta um ON um.user_id = u.ID
GROUP BY u.ID;
Понять, что user_registration_select_1667036325 это статус пользователя, можно было только опытным путём, сопоставляя значения с сайтом.
За годы плагины ставились и удалялись, а таблицы и ключи оставались. Уже нельзя было сказать наверняка, какие данные актуальны, а документации к старой базе не было. После переезда без этого мусора объём базы уменьшился в 20 раз, с 1 ГБ до 50 МБ.
Проблемы данных WordPress при миграции
одно JSON поле в разных записях было то обычным JSON, то JSON внутри строки, то строкой с задвоенными кавычками
вместо пустых дат стояло
0000-00-00у части сущностей не было связей по ID, гайды и тарифы сопоставляли по названию
у части пользователей нашлись дубли с одинаковой почтой
пароли хранились в разных форматах хэшей
На каждый случай приходилось писать отдельную обработку, поэтому большая часть времени ушла не на сам перенос, а на то, чтобы понять, что где лежит.
Как это выглядит в Strapi
В Strapi такой проблемы нет. У каждой коллекции своя таблица с явными колонками, структура видна в schema.json и в Content-Type Builder, а связи заданы явно. Новый разработчик сразу видит, какие есть данные и как они связаны, и не гадает, что значит ключ с числом в названии.
Как переносили
Перенос шёл скриптами по шагам: пользователи, потом тарифы, подписки и платежи, затем гайды, промокоды и реферальные ссылки. На каждом шаге сохранялось соответствие старых и новых ID, чтобы правильно проставить связи. Старый ID пользователя мы оставили в профиле, он потом пригодился для интеграций.
Пользователи и авторизация в Strapi
Одна из главных задач переезда: пользователь заходит со старым паролем и видит всё как раньше, подписку, платежи, купленные гайды и избранное.
Своя авторизация: VK, Яндекс и пароли из WordPress
В Strapi есть встроенная система пользователей с регистрацией, JWT, ролями и входом через внешних провайдеров. Нам её оказалось мало, и мы сделали свою авторизацию. Strapi это позволяет: стандартный плагин можно расширить или написать свою логику рядом.
Причины:
пользователь у нас это профиль с десятками полей и связей, и удобнее держать его одной коллекцией
нужно было ограничить количество устройств, с которых входят в один аккаунт
вход через VK и Яндекс с привязкой к уже существующему аккаунту
проверка старых паролей из WordPress
Всё это обычные роуты, контроллеры, сервисы и коллекции Strapi.
Проверка данных после миграции в админке Strapi
После переноса важно было убедиться, что у всех всё на месте, и тут сильно помогла админка Strapi. Менеджерам не нужно лезть в базу или просить выборку у разработчиков: в записи пользователя сразу видны подписки, платежи, купленные гайды, избранное, промокоды и сессии. Если человек писал, что у него что-то пропало, менеджер сам открывал профиль и разбирался.
Другие возможности Strapi
В нашем кейсе мы использовали далеко не всё, что есть в Strapi.
MCP сервер в Strapi: подключение ИИ агентов
В Strapi 5 есть встроенный MCP сервер. MCP это открытый протокол, через который ИИ агенты работают с внешними сервисами. Если его включить, к Strapi можно подключить Claude, Cursor или другой MCP клиент, и агент сможет искать, создавать, редактировать и публиковать записи:
// config/server.js
module.exports = ({ env }) => ({
mcp: {
enabled: true,
},
});
Агент подключается через админ токен и получает ровно те права, что и владелец токена. Так ему можно поручить, например, разложить по категориям сотню статей, не давая лишнего доступа.
i18n, вебхуки, GraphQL, CLI и S3
Мультиязычность встроена в ядро: у записи появляются версии на разных языках, а какие поля переводить, выбирается отдельно
Вебхуки сообщают внешним сервисам о создании, изменении и публикации записей
GraphQL подключается официальным плагином, схема генерируется по моделям автоматически
CLI умеет экспортировать и импортировать данные вместе с файлами или переносить их напрямую между серверами, например с прода на стейджинг
Хранилище файлов можно заменить через провайдер на S3 или совместимое, медиатека при этом работает так же
Итоги
Strapi оказался удобным и для разработчиков, и для тех, кто работает с контентом. Разработчику он даёт готовую основу, в которой легко освоиться и постепенно наращивать логику, а контент-менеджеры сами собирают страницы, работают с медиа и публикуют материалы.
Скорость сайта на мобильных по Lighthouse:
Метрика | Было | Стало |
|---|---|---|
Performance | 44 | 100 |
First Contentful Paint | 5,4 с | 1,5 с |
Largest Contentful Paint | 6,1 с | 1,5 с |
Speed Index | 7,1 с | 2,1 с |

Переходы между страницами ускорились примерно с 2,5 до 0,5 секунды.
Бизнес показатели:
выручка по подпискам выросла на 225% к тому же периоду прошлого года
конверсия выросла на 90%
глубина просмотра выросла на 75%
Кроме цифр, у проекта появились своя CRM с сегментами и рекламой, своя аналитика и данные, которым можно доверять.

Комментарии 0