S.O.K Server

Установите S.O.K на NAS или домашний сервер с Docker и упорядочивайте загрузки через веб-страницу.

S.O.K Server — это тот же движок, что и в приложении, в образе Docker с веб-интерфейсом. Установите его на NAS или домашний сервер, укажите папки с загрузками и упорядочивайте их из любого браузера: он распознаёт каждый файл, показывает новые имена в таблице и переименовывает всё сразу или построчно. Или позвольте ему самому раскладывать новые загрузки и уведомлять Discord, Jellyfin или Plex.

По умолчанию он использует жёсткие ссылки: переименованный файл и загрузка — один и тот же файл на диске, поэтому торренты продолжают раздаваться без лишнего места.

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

Установка

S.O.K Server работает на любом компьютере с Docker, на Intel/AMD и ARM (amd64, arm64). Создайте файл docker-compose.yml:

services:
  sok-server:
    image: ghcr.io/sokteam/sok-server:latest
    container_name: sok-server
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Moscow
    volumes:
      - /srv/sok/config:/config
      - /mnt/storage:/data
    ports:
      - 8080:8080
    restart: unless-stopped

Затем запустите его командой docker compose up -d и откройте http://<ваш-сервер>:8080.

Параметр Назначение
/config Настройки, база данных, история и журналы. Храните его на диске с резервным копированием.
/data (или любая нужная папка) Ваши загрузки и библиотека в том виде, в каком их видит сервер.
PUID, PGID Пользователь и группа, от имени которых работает сервер: создаваемые им файлы принадлежат им. Укажите значения своего пользователя NAS (id в терминале).
TZ Ваш часовой пояс, для отображаемых дат.
8080:8080 Порт интерфейса. Измените первое число, чтобы использовать другой.

Монтируйте одну общую родительскую папку для жёстких ссылок

Жёсткая ссылка работает только внутри одного монтирования. Если загрузки лежат в /mnt/storage/downloads, а библиотека — в /mnt/storage/media, смонтируйте /mnt/storage один раз (/mnt/storage:/data), а в настройках используйте /data/downloads и /data/media.

Раздельное монтирование (/mnt/storage/downloads:/downloads и /mnt/storage/media:/media) создаёт два монтирования: жёсткие ссылки между ними не работают, даже на одном диске. Настройки сообщат об этом до любого переименования.

Первый визит

Первая страница предлагает создать учётную запись: имя пользователя и пароль не короче 8 символов. Интерфейс берёт язык вашего браузера; изменить его можно в разделе Настройки → Внешний вид.

Сеанс в этом браузере длится 30 дней. После 5 неверных паролей следующие попытки ждут 30 секунд.

Забыли пароль? Добавьте SOK_RESET_PASSWORD=1 и новый пароль в SOK_PASSWORD в раздел environment файла compose, затем перезапустите контейнер (docker compose up -d). Войдите с новым паролем и удалите обе строки. Ваши настройки, история и выбор сохранятся.

Настройки

Откройте Настройки внизу боковой панели. У них пять вкладок, и каждое изменение сохраняется сразу.

  • Папки: ваши исходные папки (загрузки) и папки назначения для каждого типа (фильмы, сериалы, музыка, книги, игры). Нажмите Добавить папку… и введите путь так, как его видит сервер (/data/downloads, а не путь на вашем NAS), или нажмите Обзор…, чтобы выбрать его среди папок сервера. Если у типа несколько папок назначения, каждая строка его вкладки может выбрать одну из них. Ниже — режим файлов: Жёсткая ссылка (по умолчанию), Копировать или Перемещать. Если в режиме жёсткой ссылки добавленная папка (или сам режим) делает жёсткую ссылку невозможной, окно объяснит причину и что изменить, с кнопкой для перехода на Копировать; строка под вариантами снова открывает его, пока проблема не решена.
  • Автоматизация: автоматическая сортировка и уведомления.
  • Переименование: поведение и форматы вывода, как в приложении (см. Настройки).
  • API ключи: в отличие от приложения, в образе нет встроенного ключа. TMDB (фильмы и сериалы) нужен ваш собственный ключ, бесплатный на themoviedb.org. Deezer, MusicBrainz и Open Library работают без ключа. Вставьте ключ, нажмите Сохранить, затем Тест. Ключи хранятся в зашифрованном виде и больше не показываются. У каждого типа вверху его группы есть свой предпочитаемый API.
  • Внешний вид: язык и тема: Светлая (белая, как в macOS), Оранжевая (как в Windows и Linux) или Тёмная. Тема запоминается в каждом браузере; Системная (по умолчанию) следует светлому или тёмному режиму устройства: белая на Mac и оранжевая на остальных.

Ключи можно задать и переменными окружения, например API_KEY_TMDB_V4: тогда они отображаются как Задан переменной окружения и не меняются из интерфейса.

Анализ загрузок

На странице Анализ нажмите Анализировать. S.O.K сортирует файлы исходных папок по типу, а затем ищет каждый из них; ход работы виден в реальном времени, и страницу можно закрыть.

Вверху полоса показывает исходные папки, последний анализ и автоматическую сортировку; проблема (отсутствующий ключ, исчерпанная квота, ненайденная папка) появляется сразу под ней. Затем таблица показывает для каждого типа его файлы и сколько из них Готово, Выбрать и Не найдено: Открыть ведёт на его вкладку. Файлы для проверки — это файлы, тип которых лишь предполагается (образ диска, видео среди серий…): подтвердите тип или выберите другой: файл попадёт на свою вкладку и сразу будет найден, а следующие анализы это запомнят.

Каждый новый анализ сохраняет ваш выбор: совпадение, текст поиска и папку назначения строки, найденной снова.

Проверка и переименование

У каждого типа своя вкладка с режимом файлов и папкой назначения под заголовком. Строки образуют таблицу: постер, название и файл, новое имя (зелёным, когда Готово) и статус. Строка — это фильм, трек, книга или игра либо целый сериал или альбом со своими файлами; вкладки над таблицей показывают строки одного статуса.

Статус Значение
Готово Одно надёжное совпадение: название и год (или автор, исполнитель) совпадают.
Выберите Подходят несколько результатов. Нажмите на строку, чтобы увидеть их с постером и описанием, и выберите правильный.
Отсутствует Ничего не найдено. Нажмите на значок поиска и введите другое название.

Под новым именем указана его папка; разверните сериал, чтобы увидеть каждую серию с новым именем.

Нажмите Переименовать готовые вверху или отметьте строки (флажок в заголовке отмечает все) и нажмите Переименовать выбранное под таблицей. Подтверждение покажет число файлов и режим файлов. Переименованные строки исчезают из таблицы; файл, который не удалось переименовать, остаётся в своей строке с указанием причины.

Субтитры следуют за своим видео (Фильм.ru.srt становится Дюна (2021).ru.srt), как в приложении.

Автоматическая сортировка

S.O.K Server может делать всё это сам. В разделе Настройки → Автоматизация включите Сортировать новые файлы автоматически: сначала он попросит подтверждение, потому что строки Готово будут переименовываться без вас, включая те, что уже есть на вкладках.

  • Каждые 5 минут (можно изменить, от 1 до 1440) сервер просматривает исходные папки.
  • Файл берётся после окончания загрузки: когда его размер такой же, как при предыдущей проверке. Файлы, которые ещё загружаются (.part, .!qB, .crdownload…), пропускаются.
  • Новые завершённые файлы запускают анализ, затем строки Готово переименовываются. Строки для выбора, ненайденные и файлы для проверки ждут вас на вкладках, как после нажатия Анализировать.
  • Полоса на странице Анализ показывает, что сортировка включена, и её последний запуск (переименованные файлы; последняя проверка при наведении), а то, что её остановило, появляется ниже (тип без папки назначения, отсутствующий ключ…).

Всё, что она переименовывает, попадает в Историю с пометкой автоматически и отменяется так же, как остальное.

Уведомления

После каждого переименования, ручного или автоматического, S.O.K Server может оповещать другие приложения. Настройте их в разделе Настройки → Автоматизация, под автоматической сортировкой, затем нажмите Тест:

Получатель Что указать Что делает
Discord Адрес вебхука канала (настройки канала → Интеграция → Вебхуки) Публикует переименованные файлы
Jellyfin Его адрес (http://jellyfin:8096) и API ключ (Панель управления → API-ключи) Обновляет библиотеки
Plex Его адрес (http://plex:32400) и ваш токен Plex Обновляет библиотеки
Вебхук Любой адрес Отправляет данные переименования в JSON (Home Assistant, n8n…)

Адреса вебхуков, ключ и токен после сохранения больше не показываются.

Скрипт тоже может запускаться после каждого переименования: данные переименования в JSON подаются ему на вход, а SOK_MEDIA_TYPE, SOK_RENAMED и SOK_AUTO передаются в окружении. В целях безопасности его нельзя задать на веб-странице: положите скрипт в смонтированную папку и укажите путь к нему в разделе environment контейнера, например SOK_AFTER_RENAME=/config/after-rename.sh.

История и отмена

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

  • Жёсткая ссылка или копия удаляется: оригинал никуда не перемещался.
  • Перемещённый файл возвращается в прежнюю папку.

Отмена никогда не заменяет файл, как и в приложении (см. История и отмена).

Уже обработанные файлы

С жёсткими ссылками переименованный файл остаётся в загрузках. S.O.K запоминает его и пропускает при следующих анализах, пока он не изменится. Вкладка Уже обработаны на странице «История» показывает их список; отметьте файл и нажмите Проанализировать выбранное снова, чтобы переименовать его ещё раз. Файл, переименование которого отменено, тоже анализируется снова.

Обновление

docker compose pull
docker compose up -d

Ваши настройки, история и выбор сохраняются в /config.

За обратным прокси

S.O.K Server работает за Nginx, Traefik или Caddy. Если прокси уже запрашивает вход (Authelia, Authentik…), вход в S.O.K можно отключить с помощью SOK_AUTH=none: тогда баннер напомнит, что сервер защищает прокси.