Как развивать сайт на Astro + Cloudflare по функциям

Когда сайт начинается с Astro и Cloudflare Pages, обычно достаточно быстрой и безопасной статической публикации.

Со временем появляются новые задачи: редактирование из браузера, локализованные страницы, навигация через AI-чат, передача контекста услуги в форму и комментарии.

Эта статья служит индексом внедрения: помогает решить, к какому слою относится функция, в каком порядке ее добавлять и какую подробную статью читать дальше. Пример взят с сайта Acecore, но подход переносится на другие сайты Astro + Cloudflare.

Кратко

Роли разделены так:

Слой	Ответственность
Astro	Страницы, блог, OGP, RSS, sitemap и UI
Cloudflare	Pages, Pages Functions, D1 и Turnstile
GitHub	PR, CMS-diff, переводы и история
Sveltia CMS	Японский source, авторы, теги, изображения
OpenAI API	Ответы AI-чата
Pagefind	Индекс поиска для проверенного HTML

То, что можно сделать статическим, остается статическим. Runtime нужен только для небольших API.

Маленькие API на Cloudflare

AI-чат и комментарии используют один паттерн.

Astro рисует UI. Pages Functions держит API-границу. Secrets, D1 bindings, Turnstile, Origin checks и rate limits остаются на серверной стороне.

CMS как интерфейс редактирования

Sveltia CMS не является runtime-базой данных. Он создает Git-изменения.

Японские статьи, авторы, теги, изображения и JSON-тексты проходят через PR, build и review.

Перевод как статический контент

Локализация не сводится к переводу интерфейса в браузере.

Каждый язык получает URL, title, description, OGP, JSON-LD, RSS, sitemap и hreflang.

Каналы обращения разделены

AI-чат помогает выбрать услугу. CTA услуги сохраняет контекст. Форма фиксирует официальное обращение.

Вывод AI не является доверенным HTML

Markdown-ссылки из AI сначала валидируются.

Только ссылки из allowlist становятся DOM-элементами.

Комментарии остаются в Cloudflare

Комментарии не используют внешний виджет.

Pages Functions принимает GET/POST, D1 хранит комментарии, Turnstile защищает отправку.

Читать по цели

Не нужно сначала читать все подряд. Начните с функции, которую хотите добавить.

Цель	Что читать первым
Редактировать статьи и изображения из браузера	Руководство по внедрению Sveltia CMS
Публиковать индексируемые многоязычные страницы	Как вести многоязычный блог с Sveltia CMS
Направлять посетителей через AI-чат	Технический дизайн AI-чата для обращений
Безопасно рендерить ссылки в ответах AI	Безопасный рендеринг Markdown-ссылок в ответах AI-чата
Передавать контекст услуги в форму	Передача контекста CTA услуги в форму обращения
Добавить комментарии без внешнего сервиса	Комментарии блога Astro только на Cloudflare

Порядок внедрения

Для похожего сайта практичный порядок такой:

1. Закрепить статические страницы, блог, RSS, sitemap и OGP в Astro.
2. Добавить Sveltia CMS для редактирования японского source.
3. Генерировать локализованные страницы как статический HTML.
4. Добавить навигацию через AI-чат и CTA услуг.
5. Зафиксировать безопасные границы для Markdown-ссылок, prefill формы, Origin checks и rate limits.
6. Добавить комментарии внутри Cloudflare только тогда, когда они действительно нужны.

Итог

Astro + Cloudflare позволяют расширять корпоративный сайт, не теряя преимуществ статической доставки.

Используйте эту страницу как входную точку и добавляйте только те части, которые нужны вашему сайту, не ослабляя статическую основу.