Files
quoter/docs/configuration.md
Untone 5baba346e0
Some checks failed
Deploy quoter Microservice on push / deploy (push) Failing after 39m16s
;### Changed
- 🔑 **JWT_SECRET → JWT_SECRET_KEY**: Используется `JWT_SECRET_KEY` для совместимости с `@core`, `@inbox`, `@presence`
  - Fallback на `JWT_SECRET` для обратной совместимости
  - Обновлена документация: README.md, configuration.md
  - **BREAKING**: Требует установки `JWT_SECRET_KEY` в production (или использование legacy `JWT_SECRET`)

### Fixed (Tests & Code Quality)
- 🧪 **Удален мертвый код**: Removed unused mock functions and structs from tests
- 🔧 **Исправлены async тесты**: Changed `#[test]` → `#[tokio::test]` для async функций
- 🧹 **Чистые warnings**: Все тесты компилируются без warnings
- 📝 **Префиксы unused полей**: `_field` вместо `#[allow(dead_code)]`
2025-09-30 21:46:47 +03:00

6.2 KiB
Raw Permalink Blame History

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

Переменные окружения

Quoter использует следующие переменные окружения для настройки:

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

Переменная Описание Пример
REDIS_URL URL для подключения к Redis redis://localhost:6379
STORJ_ACCESS_KEY Ключ доступа к Storj S3 your-storj-access-key
STORJ_SECRET_KEY Секретный ключ Storj S3 your-storj-secret-key
AWS_ACCESS_KEY Ключ доступа к AWS S3 (fallback) your-aws-access-key
AWS_SECRET_KEY Секретный ключ AWS S3 (fallback) your-aws-secret-key
JWT_SECRET_KEY Секрет для валидации JWT токенов (должен совпадать с @core) your-jwt-secret-key

Опциональные переменные

Переменная Описание По умолчанию
PORT Порт для запуска сервера 8080
STORJ_END_POINT Endpoint Storj S3 https://gateway.storjshare.io
STORJ_BUCKET_NAME Имя bucket в Storj discours-io
AWS_END_POINT Endpoint AWS S3 https://s3.amazonaws.com
RUST_LOG Уровень логирования info

Пример .env файла

# Redis (обязательно)
REDIS_URL=redis://localhost:6379

# JWT Authentication (обязательно)
JWT_SECRET_KEY=your-super-secret-jwt-key  # Должен совпадать с @core

# Storj S3 - основное хранилище (обязательно)
STORJ_ACCESS_KEY=your-storj-access-key
STORJ_SECRET_KEY=your-storj-secret-key
STORJ_END_POINT=https://gateway.storjshare.io
STORJ_BUCKET_NAME=discours-io

# AWS S3 - fallback хранилище (обязательно)
AWS_ACCESS_KEY=your-aws-access-key
AWS_SECRET_KEY=your-aws-secret-key
AWS_END_POINT=https://s3.amazonaws.com

# Server настройки
PORT=8080
RUST_LOG=info

# Security (опционально)
MAX_PAYLOAD_SIZE=524288000  # 500MB
MAX_PATH_LENGTH=1000
MAX_HEADERS_COUNT=50

Настройка Redis

Минимальная конфигурация Redis

# redis.conf
maxmemory 2gb
maxmemory-policy allkeys-lru
save 900 1
save 300 10
save 60 10000

Проверка подключения

redis-cli ping

Настройка S3

Storj S3

  1. Создайте аккаунт на Storj
  2. Создайте API ключи в консоли
  3. Создайте bucket для файлов
  4. Настройте CORS для bucket:
{
  "CORSRules": [
    {
      "AllowedOrigins": ["*"],
      "AllowedMethods": ["GET", "POST", "PUT", "DELETE"],
      "AllowedHeaders": ["*"],
      "ExposeHeaders": ["ETag"]
    }
  ]
}

AWS S3

  1. Создайте IAM пользователя с правами S3
  2. Создайте bucket для файлов
  3. Настройте CORS аналогично Storj

Логирование

Уровни логирования

  • error - только ошибки
  • warn - предупреждения и ошибки
  • info - информационные сообщения, предупреждения и ошибки
  • debug - отладочная информация
  • trace - максимальная детализация

Примеры

# Только ошибки
RUST_LOG=error cargo run

# Информационные сообщения
RUST_LOG=info cargo run

# Отладка
RUST_LOG=debug cargo run

Дополнительные настройки

Настройки безопасности

# Rate limiting (requests per window)
GENERAL_RATE_LIMIT=100          # Общие запросы: 100/мин
UPLOAD_RATE_LIMIT=10            # Загрузка: 10/5мин  
AUTH_RATE_LIMIT=20              # Аутентификация: 20/15мин

# Блокировка (секунды)
GENERAL_BLOCK_DURATION=300      # 5 минут
UPLOAD_BLOCK_DURATION=600       # 10 минут
AUTH_BLOCK_DURATION=1800        # 30 минут

Настройки квот

# Пользовательские квоты
MAX_USER_QUOTA_BYTES=12884901888    # 12 ГБ на пользователя
MAX_SINGLE_FILE_BYTES=524288000     # 500 МБ на файл

Vercel интеграция

# CORS для Vercel Edge Functions
ALLOWED_ORIGINS=https://discours.io,https://new.discours.io,https://vercel.app

# Health check endpoint
HEALTH_CHECK_ENABLED=true

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

Запустите сервер и проверьте логи:

RUST_LOG=info cargo run

Успешный запуск должен показать:

[INFO] Started
[INFO] Security config: max_payload=500 MB, upload_rate_limit=10/300s
[WARN] caching AWS filelist...
[WARN] cached 1234 files

Проверка endpoints

# User info (требует токен)
curl -H "Authorization: Bearer $TOKEN" http://localhost:8080/

# Upload test (требует токен)
curl -X POST -H "Authorization: Bearer $TOKEN" \
     -F "file=@test.jpg" http://localhost:8080/

Проверка безопасности

# Rate limiting test
for i in {1..110}; do curl http://localhost:8080/ & done

# Должно показать 429 после 100 запросов

Troubleshooting

Частые проблемы

1. Redis connection failed

# Проверьте Redis
redis-cli ping
# Должно вернуть: PONG

2. S3 credentials invalid

# Проверьте доступ к Storj
aws s3 ls --endpoint-url=https://gateway.storjshare.io \
    --profile storj

# Проверьте доступ к AWS
aws s3 ls --profile aws

3. JWT validation failed

# Проверьте JWT_SECRET_KEY
echo $JWT_SECRET_KEY
# Должен быть установлен и совпадать с core API

4. Rate limiting не работает

# Проверьте Redis keys
redis-cli KEYS "rate_limit:*"
# Должны появляться ключи при запросах