Справочник по конфигурации

Ниже представлен справочник всех поддерживаемых опций конфигурации Astro. Подробнее о настройке читайте в руководстве Настройка Astro.

astro.config.mjs

import { defineConfig } from 'astro/config'

export default defineConfig({
  // ваши настройки здесь...
})

Основные опции

site

Тип: string

Ваш итоговый URL после развертывания. Astro использует его для генерации карты сайта (sitemap) и канонических URL.

base

Тип: string

Базовый путь для развертывания. Например, если сайт находится по адресу example.com/docs, установите base: '/docs'.

trailingSlash

Тип: 'always' | 'never' | 'ignore'
По умолчанию: 'ignore'

Определяет поведение слеша в конце URL.

output

Тип: 'static' | 'server'
По умолчанию: 'static'

Определяет тип сборки: статический сайт или серверный рендеринг (SSR).

adapter

Конфигурация адаптера для развертывания на конкретную платформу (Vercel, Netlify, Node.js и др.).

integrations

Массив установленных интеграций (React, Tailwind, MDX и др.).

root

Путь к корню проекта (по умолчанию текущая рабочая директория).

srcDir

Путь к папке с исходным кодом (по умолчанию ./src).

publicDir

Путь к папке со статическими ресурсами (по умолчанию ./public).

outDir

Путь к папке итоговой сборки (по умолчанию ./dist).

compressHTML

Минификация HTML-вывода (по умолчанию true).

Опции сборки (build)

build.format

Управляет форматом имен файлов (например, page.html или page/index.html).

Опции сервера (server)

server.port

Порт для запуска сервера разработки (по умолчанию 4321).

server.host

Настройка сетевых адресов, которые слушает сервер.

server.open

Автоматически открывать сайт в браузере при запуске.

Опции изображений (image)

Настройки сервиса оптимизации изображений и списки разрешенных доменов для удаленных картинок.