Конфигурация
Integ API использует runtime injection переменных окружения. Переменные читаются из process.env при запуске приложения.
Быстрый старт
Локальная разработка (с дефолтами)
Для быстрого старта можно запустить без настройки — используются дефолтные значения:
bash
# Запуск PostgreSQL
npm run docker:up
# Запуск приложения
npm startПриложение запустится с дефолтными значениями для локальной разработки.
С Doppler (рекомендуется)
bash
# Установка Doppler CLI
brew install dopplerhq/cli/doppler
# Логин
doppler login
# Настройка проекта
doppler setup --config local
# Запуск с injection
doppler run --config local -- npm startПеременные окружения
База данных (PostgreSQL)
| Переменная | Default | Описание |
|---|---|---|
POSTGRES_HOST | localhost | Хост базы данных |
POSTGRES_PORT | 5432 | Порт PostgreSQL |
POSTGRES_USERNAME | user | Имя пользователя |
POSTGRES_PASSWORD | password | Пароль |
POSTGRES_NAME | - | Имя базы данных |
POSTGRES_CERTIFICATE | - | Использовать SSL |
POSTGRES_CERTIFICATE_BASE64 | - | CA сертификат в base64 |
Безопасность
| Переменная | Default | Описание |
|---|---|---|
JWT_SECRET | - | JWT секретный ключ |
CRYPTO_KEY | - | Ключ шифрования AES-256 |
CRYPTO_SALT | - | Соль для PBKDF2 |
БЕЗОПАСНОСТЬ
В production используйте сильные уникальные секреты!
bash
openssl rand -hex 64Администратор
| Переменная | Default | Описание |
|---|---|---|
ADMIN_EMAIL | - | Email администратора |
ADMIN_PASSWORD | - | Пароль администратора |
TIP
Администратор создается автоматически при запуске миграций.
Приложение
| Переменная | Default | Описание |
|---|---|---|
PORT | 3000 | Порт сервера |
MODE | local | Режим (local/dev/prod) |
Cloudflare
| Переменная | Default | Описание |
|---|---|---|
CLOUDFLARE_ACCOUNT_ID | - | Account ID |
CLOUDFLARE_WORKERS_API_TOKEN | - | API Token |
CLOUDFLARE_INTEG_DB_ID | - | D1 Database ID |
CLOUDFLARE_INTEG_KV_ID | - | KV Namespace ID |
CLOUDFLARE_LOCAL_DATA_PATH | ../integ-core/data/miniflare | Путь к miniflare data |
Сервисы
| Переменная | Default | Описание |
|---|---|---|
INTEG_CORE_URL | http://localhost:3010 | URL integ-core |
INNGEST_URL | http://localhost:8288 | URL Inngest |
INNGEST_SIGNING_KEY | - | Ключ подписи Inngest |
Scalar (API Docs)
| Переменная | Default | Описание |
|---|---|---|
SWAGGER_INTERNAL_USERNAME | admin | Логин для внутренней доки |
SWAGGER_INTERNAL_PASSWORD | admin | Пароль для внутренней доки |
AI/Testing (опционально)
| Переменная | Default | Описание |
|---|---|---|
CLAUDE_API_KEY | - | Claude API ключ |
ELEVENLABS_API_KEY | - | ElevenLabs ключ |
ELEVENLABS_API_URL | https://api.elevenlabs.io/v1 | ElevenLabs URL |
SIP / Voice (опционально)
| Переменная | Default | Описание |
|---|---|---|
SIP_PROVIDER | - | SIP провайдер |
SIP_API_KEY | - | SIP API ключ |
SIP_API_URL | - | SIP API URL |
VOICE_ASSISTANT_URL | - | URL Voice Assistant |
VOICE_ASSISTANT_AUTH_TOKEN | - | Токен авторизации VA |
VOICE_ASSISTANT_TESTER_ASSISTANT_ID | - | ID тестового ассистента VA |
SaaS / Integ (опционально)
| Переменная | Default | Описание |
|---|---|---|
SAAS_URL | - | URL SaaS платформы |
SAAS_API_KEY | - | API ключ SaaS |
INTEG_DEFAULT_HOSTNAME | integ.happ.tools | Hostname по умолчанию |
Настройка в Doppler
1. Создание проекта
bash
doppler login
doppler projects create integ-api2. Добавление переменных
Через веб-интерфейс:
- Откройте проект
integ-apiв Doppler Dashboard - Выберите конфигурацию (local, dev, prod)
- Добавьте переменные
Или через CLI:
bash
doppler secrets set POSTGRES_HOST localhost --config local
doppler secrets set JWT_SECRET "your-secret" --config local3. Запуск приложения
bash
# С Doppler
doppler run --config local -- npm start
# Production build
doppler run --config local -- npm run start:prodРежимы работы
Local (без Doppler)
bash
npm run docker:up # PostgreSQL
npm start # Дефолтные значенияLocal (с Doppler)
bash
npm run docker:up
doppler run --config local -- npm startDevelopment
bash
doppler run --config dev -- npm run start:prodProduction
bash
doppler run --config prod -- npm run start:prodDocker
В Docker переменные передаются через DOPPLER_TOKEN:
bash
docker run -p 3000:3000 \
-e DOPPLER_TOKEN=dp.st.xxxx \
-e DOPPLER_CONFIG=local \
ghcr.io/happ-ai/integ-api:devПодробнее в Docker документации.
Генерация секретов
bash
# Для dev (32 символа)
openssl rand -hex 32
# Для prod (64 символа)
openssl rand -hex 64Проверка конфигурации
bash
# Просмотр переменных в Doppler
doppler secrets --config local
# Проверка конкретной переменной
doppler secrets get POSTGRES_HOST --config local --plainBest Practices
✅ DO:
- Используйте разные секреты для каждого окружения
- Генерируйте сильные пароли (32+ символов)
- Используйте Doppler для управления секретами
- Включите SSL в dev и prod
❌ DON'T:
- Не используйте одинаковые секреты
- Не коммитьте секреты в git
- Не используйте слабые пароли типа "password123"
Следующие шаги
- Архитектура проекта - Структура приложения
- API Guide - Работа с API
- Deployment - Деплой приложения