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: тогда баннер напомнит, что сервер защищает прокси.