Перейти к основному содержимому

Конфигурация

Полный справочник переменных окружения.

Обязательные переменные​

ПеременнаяОписание
JINA_API_KEYAPI ключ Jina AI для эмбеддингов
OPENROUTER_API_KEYAPI ключ OpenRouter для AI
DATABASE_URLURL подключения к PostgreSQL
JWT_SECRETСекрет для JWT токенов

База данных​

ПеременнаяПо умолчаниюОписание
DATABASE_URL-PostgreSQL connection string
DB_POOL_SIZE20Размер пула соединений

Пример:

DATABASE_URL=postgresql://user:password@localhost:5432/archicore

Кэш​

ПеременнаяПо умолчаниюОписание
REDIS_URLredis://localhost:6379URL Redis
CACHE_TTL3600TTL кэша в секундах

Векторная база​

ПеременнаяПо умолчаниюОписание
QDRANT_URLhttp://localhost:6333URL Qdrant
QDRANT_COLLECTIONarchicoreИмя коллекции

Безопасность​

ПеременнаяПо умолчаниюОписание
JWT_SECRET-Секрет JWT (обязательно!)
CORS_RESTRICTfalseВключить CORS whitelist
CORS_ORIGINS*Разрешённые origins
HELMET_ENABLEDfalseSecurity headers

Rate Limiting​

ПеременнаяПо умолчаниюОписание
RATE_LIMIT_WINDOW60000Окно в мс
RATE_LIMIT_MAX100Макс. запросов

GitHub​

ПеременнаяОписание
GITHUB_CLIENT_IDOAuth Client ID
GITHUB_CLIENT_SECRETOAuth Client Secret
GITHUB_CALLBACK_URLOAuth callback URL
GITHUB_WEBHOOK_SECRETСекрет для вебхуков

Пример .env​

# Сервер
NODE_ENV=production
PORT=3000

# База данных
DATABASE_URL=postgresql://archicore:secure_password@localhost:5432/archicore

# Кэш
REDIS_URL=redis://localhost:6379
QDRANT_URL=http://localhost:6333

# API ключи
JINA_API_KEY=jina_xxxxxxxxxxxx
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxx

# Безопасность
JWT_SECRET=your-very-long-random-secret-key
CORS_RESTRICT=true
CORS_ORIGINS=https://yourdomain.com

# GitHub
GITHUB_CLIENT_ID=xxxxx
GITHUB_CLIENT_SECRET=xxxxx
GITHUB_CALLBACK_URL=https://yourdomain.com/api/github/callback
GITHUB_WEBHOOK_SECRET=your-webhook-secret

Проверка конфигурации​

# Health check
curl http://localhost:3000/health

# Детальный статус
curl http://localhost:3000/health/detailed