Начало работы

Попробуйте перед установкой

Изучите весь интерфейс на demo.snapotter.com, без регистрации и установки.

Быстрый старт

docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data snapotter/snapotter:latest

Этот единственный контейнер выполняет все, что ему нужно: без установленного DATABASE_URL он запускает свои собственные PostgreSQL и Redis на интерфейсе обратной связи (встроенный режим) и сохраняет все данные в томе SnapOtter-data. Это самый быстрый способ опробовать SnapOtter или самостоятельно разместить его в домашней лаборатории. Для производства используйте канонический стек Docker Compose, который хранит PostgreSQL и Redis в отдельных контейнерах. Встроенный режим запускается от имени пользователя root (по умолчанию) и автоматически отключается, как только вы устанавливаете DATABASE_URL.

Устанавливаете SnapOtter на Raspberry Pi, старый ноутбук или небольшой VPS? В разделе Установка на маломощном оборудовании есть пошаговое руководство с подобранными лимитами и описание того, чего ожидать от ограниченного оборудования.

При первом входе вам будет предложено сменить пароль.

Анонимная продуктовая аналитика

SnapOtter по умолчанию включает анонимную продуктовую аналитику. Чтобы отключить её, откройте Settings → System → Privacy и выключите Anonymous Product Analytics. Она останавливается немедленно для всего экземпляра.

Вы также можете установить переменную окружения SNAPOTTER_TELEMETRY=0 (false и off тоже работают), чтобы отключить всю телеметрию для экземпляра без пересборки.

Мониторинг ошибок работает на базе Sentry, который спонсирует SnapOtter через свою программу для открытого исходного кода.

Подробнее о том, что собирается, см. Что собирает SnapOtter.

Ускорение NVIDIA CUDA

Добавьте --gpus all для NVIDIA CUDA-ускоренного удаления фона, масштабирования, улучшения лица и восстановления. OCR остается на базе ЦП и работает в том же образе с доступом к GPU или без него:

docker run -d --name SnapOtter -p 1349:1349 --gpus all -v SnapOtter-data:/data snapotter/snapotter:latest

Требуется NVIDIA Container Toolkit. Автоматически переключается на процессор, когда CUDA недоступна. Ускорение Intel/AMD iGPU через VA-API, Quick Sync или OpenCL сегодня не поддерживается для вывода AI. См. Docker Tags для ознакомления с тестами. Если инструменты ИИ работают на ЦП, несмотря на --gpus all, см. Проверка ускорения графического процессора.

Также на GHCR

docker run -d --name SnapOtter -p 1349:1349 -v SnapOtter-data:/data ghcr.io/snapotter-hq/snapotter:latest

Оба реестра публикуют один и тот же образ при каждом релизе.

Docker Создать

Используйте рабочий файл, поддерживаемый и тестируемый с каждым выпуском, вместо копирования сокращенного примера Compose с этой страницы:

install -d -m 700 snapotter && cd snapotter
curl --proto '=https' --tlsv1.2 -fsSLo docker-compose.yml \
  https://raw.githubusercontent.com/snapotter-hq/SnapOtter/v2.2.0/docker/docker-compose.yml

# Keep generated service credentials out of shell history and world-readable files.
umask 077
POSTGRES_PASSWORD="$(openssl rand -hex 32)"
REDIS_PASSWORD="$(openssl rand -hex 32)"
printf 'POSTGRES_PASSWORD=%s\nREDIS_PASSWORD=%s\n' \
  "$POSTGRES_PASSWORD" "$REDIS_PASSWORD" > .env

docker compose -f docker-compose.yml pull
docker compose -f docker-compose.yml up -d --no-build

Канонический docker/docker-compose.yml включает все четыре тома среды выполнения, проверки работоспособности, ограничения ресурсов, устойчивую конфигурацию Redis, закрепленные образы базы данных/кэша и текущее усиление защиты контейнера. Измените пароль администратора по умолчанию сразу после первого входа в систему. Для воспроизводимого развертывания прикрепите образ приложения SnapOtter к проверенному вами тегу выпуска или дайджесту вместо того, чтобы следовать latest.

См. Конфигурация для всех переменных среды и Безопасность и усиление для секретов, сетевой политики и инструкций по резервному копированию.

Сборка из исходников

Предварительные требования: Node.js 22.22+, pnpm 9+, Docker (для Postgres + Redis), Python 3.11+ (для функций ИИ), Git.

git clone https://github.com/snapotter-hq/SnapOtter.git
cd SnapOtter
docker compose -f docker-compose.dev.yml up -d   # start Postgres + Redis
pnpm install
pnpm dev

• Фронтенд: http://localhost:1351
• Бэкенд: http://localhost:13490

Что вы можете делать

Обработка файлов (200+ инструментов)

Модальность	Количество	Примеры инструментов
Изображения	107	Изменение размера, Обрезка, Сжатие, Конвертация, Удаление фона, Апскейл, OCR, Водяной знак, Коллаж, Раскрашивание, Инструменты GIF, пресеты форматов
Видео	57	Обрезка, Кадрирование, Сжатие, Конвертация, Объединение, Извлечение аудио, Авто-субтитры, Видео в GIF, Изменение размера, Стабилизация, пресеты форматов
Аудио	27	Обрезка, Объединение, Конвертация, Нормализация, Шумоподавление, Транскрипция, Сдвиг высоты тона, Затухание, Создание рингтона, пресеты форматов
PDF / Документы	29	Объединение, Разделение, Сжатие, OCR, Водяной знак, Редактирование, Word в PDF, Excel в PDF, Поворот, Защита, Восстановление
Файлы	23	CSV в JSON, JSON в XML, Объединение CSV, Разделение CSV, Создание ZIP, Извлечение ZIP, Создание диаграмм, YAML/JSON

Конвейеры

Объединяйте инструменты в многошаговые рабочие процессы и применяйте их к одному изображению или целому пакету:

1. Откройте Pipelines в боковой панели.
2. Добавьте шаги (любой инструмент, любые настройки).
3. Запустите на одном файле или на целом пакете сразу.
4. Сохраните конвейер для повторного использования.

Конвейеры допускают 20 шагов по умолчанию. Установите MAX_PIPELINE_STEPS=0, чтобы сделать лимит неограниченным.

Библиотека файлов

Каждый обработанный вами файл может быть сохранён в вашу библиотеку Files. SnapOtter отслеживает полную историю версий, поэтому вы можете проследить каждый шаг обработки от исходной загрузки до финального результата.

Сохранение явное: результаты, которые вы сохраняете в библиотеку, хранятся, пока вы их не удалите, а результаты, которые вы обрабатываете и оставляете несохранёнными, автоматически очищаются через 72 часа (настраивается через FILE_MAX_AGE_HOURS).

REST API и API-ключи

Каждый инструмент доступен по HTTP:

curl -X POST http://localhost:1349/api/v1/tools/image/resize \
  -H "Authorization: Bearer si_<your-api-key>" \
  -F "file=@photo.jpg" \
  -F 'settings={"width":800,"height":600,"fit":"cover"}'

Создавайте API-ключи в разделе Settings → API Keys. См. справочник REST API для всех эндпоинтов или откройте http://localhost:1349/api/docs для интерактивного справочника.

Мультипользовательский режим и команды

Включите несколько пользователей с управлением доступом на основе ролей:

• Admin: полный доступ, управление пользователями, командами, настройками, всеми файлами/конвейерами/API-ключами
• User: использование инструментов, управление своими файлами/конвейерами/API-ключами

Создавайте команды в разделе Settings → Teams для группировки пользователей.

Установите AUTH_ENABLED=true (или false для однопользовательского/личного использования без входа).

Использование с телефона

SnapOtter работает в мобильных браузерах, и его можно установить как приложение. Откройте свой экземпляр на телефоне, затем:

• iPhone / iPad (Safari): нажмите «Поделиться», затем На экран «Домой».
• Android (Chrome): откройте меню браузера и нажмите Установить приложение.

Установленное приложение открывается в отдельном окне сразу с вашим экземпляром.

Один нюанс: браузеры предлагают установку только по HTTPS. Обычный HTTP-адрес в локальной сети по-прежнему открывается во вкладке браузера, но для настоящей установки разместите экземпляр за обратным прокси с сертификатом (см. руководство по развертыванию).

На телефонах и планшетах в инструментах для изображений рядом с кнопкой загрузки появляется кнопка Сделать фото. Сфотографируйте чек или доску, и снимок сразу окажется в инструменте.