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

Уся конфігурація виконується через змінні середовища. Кожна змінна має розумне значення за замовчуванням, тож SnapOtter працює «з коробки» без задання жодної з них.

Змінні середовища

Сервер

Змінна	За замовчуванням	Опис
PORT	1349	Порт, який слухає сервер.
RATE_LIMIT_PER_MIN	1000	Максимальна кількість запитів за хвилину на одну IP. Задайте 0, щоб вимкнути обмеження частоти запитів.
CORS_ORIGIN	(порожньо)	Розділені комами дозволені джерела для CORS або порожньо лише для того самого джерела.
LOG_LEVEL	info	Детальність журналювання. Одне з: fatal, error, warn, info, debug, trace.
TRUST_PROXY	true	Довіряти заголовкам X-Forwarded-For від зворотного проксі. Задайте false, якщо не за проксі.

Автентифікація

Змінна	За замовчуванням	Опис
AUTH_ENABLED	false	Задайте true, щоб вимагати входу. Образ Docker за замовчуванням має true.
DEFAULT_USERNAME	admin	Ім'я користувача для початкового облікового запису адміністратора. Використовується лише під час першого запуску.
DEFAULT_PASSWORD	admin	Пароль для початкового облікового запису адміністратора. Змініть його після першого входу.
MAX_USERS	0 (необмежено)	Максимальна кількість зареєстрованих облікових записів користувачів. Задайте 0 для необмеженої кількості.
SESSION_DURATION_HOURS	168	Тривалість сеансу входу в годинах (за замовчуванням 7 днів).
SKIP_MUST_CHANGE_PASSWORD	-	Задайте будь-яке непорожнє значення, щоб обійти примусовий запит на зміну пароля під час першого входу

Сховище

Змінна	За замовчуванням	Опис
STORAGE_MODE	local	local або s3. S3/MinIO вимагає ліцензії з функцією s3_storage.
DATABASE_URL	postgres://snapotter:snapotter@postgres:5432/snapotter	Рядок підключення до PostgreSQL.
REDIS_URL	redis://redis:6379	Рядок підключення до Redis (використовується для черг завдань BullMQ).
WORKSPACE_PATH	./tmp/workspace	Каталог для тимчасових файлів під час обробки. Очищується автоматично.
FILES_STORAGE_PATH	./data/files	Каталог для постійних файлів користувача (завантажені зображення, збережені результати).

Вбудований режим

Запустіть образ без DATABASE_URL і без REDIS_URL, і він запустить власні PostgreSQL 17 і Redis усередині контейнера, прив'язані до loopback, з усіма даними на томі /data. Це відновлює однокомандний досвід docker run для швидкого старту, домашньої лабораторії та оновлень з 1.x. Це шлях для зручності, а не продакшн-розгортання: для продакшну запускайте стек Compose з 3 контейнерів з окремими PostgreSQL і Redis. Вбудований режим вимагає запуску контейнера від root і несумісний із середовищами з довільним UID (OpenShift, Kubernetes runAsNonRoot); там використовуйте Compose.

Змінна	За замовчуванням	Опис
EMBEDDED	auto	Автоматично вмикається, коли і DATABASE_URL, і REDIS_URL не задано. Задайте 0, щоб вимкнути (тоді застосунок швидко завершує роботу, якщо не задано зовнішні DATABASE_URL/REDIS_URL, замість тихого запуску бази даних усередині контейнера).
REDIS_MAXMEMORY	512mb	Обмеження пам'яті для вбудованого Redis (лише вбудований режим). Знизьте його на хостах з обмеженою пам'яттю, як-от Raspberry Pi.

Оновлення з 1.x: покладіть вашу стару snapotter.db за адресою /data/snapotter.db у томі, і вбудований режим імпортує її у вбудований PostgreSQL під час першого запуску. Імпорт виконується один раз; наступні запуски його пропускають.

Примітка про телеметрію: вбудований режим успадковує стандартну аналітику образу, як і будь-яка інша конфігурація. Опублікований образ постачається з увімкненою аналітикою; збирайте з --build-arg SNAPOTTER_ANALYTICS=off або скористайтеся адміністративним відмовленням у застосунку, щоб її вимкнути.

Обмеження обробки

Змінна	За замовчуванням	Опис
MAX_UPLOAD_SIZE_MB	100	Максимальний розмір файлу на одне завантаження в мегабайтах. Задайте 0 для необмеженого.
MAX_BATCH_SIZE	100	Максимальна кількість файлів в одному пакетному запиті. Задайте 0 для необмеженого.
CONCURRENT_JOBS	0 (авто)	Кількість пакетних завдань, що виконуються паралельно. Задайте 0 для автовизначення на основі доступних ядер CPU.
MAX_MEGAPIXELS	0 (необмежено)	Максимальна дозволена роздільна здатність зображення в мегапікселях. Задайте 0 для необмеженого.
MAX_WORKER_THREADS	0 (авто)	Максимальна кількість робочих потоків для обробки зображень. Задайте 0 для автовизначення на основі доступних ядер CPU.
PROCESSING_TIMEOUT_S	0 (без обмеження)	Максимальний час обробки на один запит у секундах. Задайте 0 для відсутності таймауту.
MAX_PIPELINE_STEPS	20	Максимальна кількість кроків у конвеєрі. Задайте 0 для відсутності обмеження.
MAX_CANVAS_PIXELS	0 (без обмеження)	Максимальний розмір полотна в пікселях для вихідних зображень. Задайте 0 для відсутності обмеження.
MAX_SVG_SIZE_MB	0 (необмежено)	Максимальний розмір файлу SVG у мегабайтах. Задайте 0 для необмеженого.
MAX_SPLIT_GRID	100	Максимальний розмір сітки для інструмента розділення зображення.
MAX_PDF_PAGES	0 (необмежено)	Максимальна кількість сторінок PDF для конвертації PDF-у-зображення. Задайте 0 для необмеженого.

Очищення

Змінна	За замовчуванням	Опис
FILE_MAX_AGE_HOURS	72	Як довго незбережені результати обробки (сирі завантаження та виводи інструментів) зберігаються перед автоматичним видаленням. Файли, які ви явно зберегли до бібліотеки Files, не зачіпаються й лишаються, доки ви їх не видалите.
CLEANUP_INTERVAL_MINUTES	60	Як часто виконується завдання очищення.

Зовнішній вигляд

Змінна	За замовчуванням	Опис
DEFAULT_THEME	light	Типова тема для нових сеансів. light або dark.
DEFAULT_LOCALE	en	Типова мова інтерфейсу.
DEFAULT_TOOL_VIEW	sidebar	Типове компонування інструментів. sidebar або fullscreen.

Дозволи Docker

Змінна	За замовчуванням	Опис
PUID	999	Запускати процес контейнера з цим UID. Задайте відповідно до вашого хост-користувача для монтувань bind (id -u).
PGID	999	Запускати процес контейнера з цим GID. Задайте відповідно до вашої хост-групи для монтувань bind (id -g).

Приклад Docker

services:
  SnapOtter:
    image: snapotter/snapotter:latest
    ports:
      - "1349:1349"
    volumes:
      - SnapOtter-data:/data
      - SnapOtter-workspace:/tmp/workspace
    environment:
      - AUTH_ENABLED=true
      - DEFAULT_USERNAME=admin
      - DEFAULT_PASSWORD=changeme
      - DATABASE_URL=postgres://snapotter:snapotter@postgres:5432/snapotter
      - REDIS_URL=redis://redis:6379
      - MAX_UPLOAD_SIZE_MB=200
      - CONCURRENT_JOBS=4
      - FILE_MAX_AGE_HOURS=12
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy
    restart: unless-stopped

  postgres:
    image: postgres:17-alpine
    environment:
      POSTGRES_USER: snapotter
      POSTGRES_PASSWORD: snapotter
      POSTGRES_DB: snapotter
    volumes:
      - SnapOtter-pgdata:/var/lib/postgresql/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U snapotter"]
      interval: 10s
      timeout: 5s
      retries: 12

  redis:
    image: redis:8-alpine
    command: ["redis-server", "--maxmemory-policy", "noeviction", "--appendonly", "yes"]
    volumes:
      - SnapOtter-redisdata:/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 5s
      retries: 12

volumes:
  SnapOtter-data:
  SnapOtter-workspace:
  SnapOtter-pgdata:
  SnapOtter-redisdata:

Томи

Стек Docker Compose використовує чотири томи:

• /data (app) - моделі AI, Python venv і файли користувача. Змонтуйте його, щоб зберігати завантажені файли та встановлені пакети AI між перезапусками.
• /tmp/workspace (app) - тимчасове сховище для файлів, що обробляються. Воно може бути ефемерним, але монтування уникає заповнення записуваного шару контейнера.
• SnapOtter-pgdata (postgres) - каталог даних PostgreSQL. Він містить усі реляційні дані (користувачі, налаштування, конвеєри, завдання, журнал аудиту). Робіть резервну копію через pg_dump або знімок тому.
• SnapOtter-redisdata (redis) - файл append-only Redis для стійких черг завдань.