Appearance

FAQ — Часто задаваемые вопросы ​

Здесь собраны ответы на частые вопросы пользователей и администраторов NextBox. Раздел пополняется на основе обращений в техподдержку и кейсов из практики внедрения.

Общие сведения ​

Что такое NextBox? ​

NextBox — это корпоративная платформа для совместной работы с файлами, устанавливаемая on-premise (в инфраструктуре заказчика). Платформа включает файловое хранилище, совместный доступ, версионирование, интеграцию с OnlyOffice, подключение внешних хранилищ (S3, WebDAV, SFTP, Яндекс.Диск), LDAP/AD, проверку файлов антивирусом и DLP, а также систему расширений.

Обзор архитектуры — Обзор, полный список сервисов — Сервисы.

Какая сейчас актуальная версия платформы? ​

Актуальная релизная версия — 1.10 (alder), выпущена 2 апреля 2026 года. В разработке — 1.11.

Полный список версий доступен на странице Версии платформы.

Какие версии платформы существуют? ​

ВерсияКодовое имяДата релиза
1.11—в разработке
1.10alder02.04.2026
1.9thuja01.02.2026
1.8.1elm01.10.2025
1.8elm01.10.2025
1.7lilac30.06.2025
1.6.1pine21.04.2024
1.6pine03.04.2024
1.5willow24.12.2024
1.4.1poplar05.09.2024
1.4poplar19.09.2024
1.3.2elder06.08.2024
1.3.1elder26.07.2024
1.2spruce27.03.2024
1.1chestnut09.01.2024
1.0maple24.09.2023

Актуальные даты и список обновлений — Версии.

Как посмотреть установленную версию платформы? ​

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

Как понять, каким способом установлена платформа? ​

Самый быстрый способ:

  • Если на хосте есть docker-compose.yaml и запущены контейнеры nextbox-* — установка через Docker Compose.
  • Если контейнер один и запущен как nextbox/nextbox-all-in-one:<версия> — установка Docker all-in-one.
  • Если пакеты ставились через apt/dnf/apt-get и есть файл /etc/nextbox/config.yml — пакетная установка.

Для точной диагностики приложите к обращению в поддержку: версию NextBox, операционную систему и способ установки.

Установка и системные требования ​

Какой способ установки рекомендуется? ​

Docker Compose — рекомендуемый (RECOMMENDED) способ. Пакетные установки для Debian/Ubuntu, CentOS/RHEL/Fedora, Astra и Alt Linux помечены как DEPRECATED и не являются приоритетными. Docker all-in-one помечен как EXPERIMENTAL — он удобен для быстрых тестовых стендов.

Обзор методов — Установка.

  • RECOMMENDED — рекомендованный к промышленному использованию способ (Docker Compose).
  • DEPRECATED — устаревший способ, поддержка сохраняется, но новые возможности могут быть недоступны (пакетные установки).
  • EXPERIMENTAL — способ доступен для ознакомления, не рассчитан на промышленное использование (Docker all-in-one).

Какие минимальные системные требования для Docker Compose? ​

  • Архитектура: amd64 (x86_64) или aarch64 (arm64)
  • Процессор: от 2 ГГц
  • Оперативная память: не менее 3 ГБ
  • Свободное место на диске: не менее 40 ГБ
  • Установленный Docker

Подробнее — Docker Compose.

Какие минимальные системные требования для Docker all-in-one? ​

  • Архитектура: amd64 (x86_64) или aarch64 (arm64)
  • Процессор: от 2 ГГц
  • Оперативная память: не менее 2 ГБ
  • Свободное место на диске: не менее 5 ГБ
  • Установленный Docker

Подробнее — Docker all-in-one.

Какие минимальные системные требования для пакетной установки? ​

  • Архитектура: amd64 (x86_64) или aarch64 (arm64) — в зависимости от ОС
  • Процессор: от 2 ГГц
  • Оперативная память: не менее 2 ГБ
  • Свободное место на диске: не менее 40 ГБ

Точные требования для каждой ОС — в соответствующих разделах установки.

Какие операционные системы поддерживаются? ​

Метод установкиПоддерживаемые ОС
Docker Compose (RECOMMENDED)Любая ОС с Docker, amd64 / aarch64
Docker all-in-one (EXPERIMENTAL)Любая ОС с Docker, amd64 / aarch64
Debian / Ubuntu (DEPRECATED)Debian 12+, Ubuntu 18.04+
CentOS / RHEL / Fedora (DEPRECATED)RHEL, CentOS Stream 9, Fedora 40+
Astra Linux (DEPRECATED)Astra Linux SE 1.7.5 (amd64/aarch64)
Alt Linux (DEPRECATED)Alt Linux Server 10 (amd64)

Как установить NextBox через Docker Compose? ​

  1. Подготовьте два файла: docker-compose.yaml и default.conf — в одной директории.
  2. Запустите:
bash
docker compose up -d
  1. Откройте веб-интерфейс по адресу http://<адрес_сервера>:8095.

Полная инструкция — Docker Compose.

Как быстро развернуть NextBox для ознакомления (Docker all-in-one)? ​

bash
docker run -d -p 8095:80 \
  -v ./data:/var/nextbox \
  nextbox-docker.ptnl.moscow/nextbox/nextbox-all-in-one:1.10.0

Веб-интерфейс откроется на http://<адрес_сервера>:8095.

Способ помечен как EXPERIMENTAL и не рекомендуется для промышленной эксплуатации. Подробнее — Docker all-in-one.

Как установить NextBox на Debian/Ubuntu? ​

Используется установочный скрипт:

bash
curl -fsSL -o nextbox-install.sh 'https://nextbox-cloud.ptnl.moscow/api/v1/storage/files?share_token=7cd7d49f-e8b8-4c24-b583-e09ef31c2bb3&path=%2Fdebian%2Fstable.sh' \
  && sudo bash nextbox-install.sh

Установка устанавливает необходимые зависимости (PostgreSQL, RabbitMQ, Redis, Nginx) и сам NextBox.

Инструкция — Debian / Ubuntu.

Как установить NextBox на CentOS / RHEL / Fedora? ​

bash
curl -fsSL -o nextbox-install.sh 'https://nextbox-cloud.ptnl.moscow/api/v1/storage/files?share_token=7cd7d49f-e8b8-4c24-b583-e09ef31c2bb3&path=%2Fcentos%2Fstable.sh' \
  && sudo bash nextbox-install.sh

Подробнее — CentOS.

Как установить NextBox на Astra Linux? ​

bash
curl -fsSL -o nextbox-install.sh 'https://nextbox-cloud.ptnl.moscow/api/v1/storage/files?share_token=7cd7d49f-e8b8-4c24-b583-e09ef31c2bb3&path=%2Fdebian%2Fstable.sh' \
  && sudo bash nextbox-install.sh

Инструкция — Astra Linux.

Как установить NextBox на Alt Linux? ​

См. инструкцию — Alt Linux.

На каком порту доступен веб-интерфейс после установки? ​

По умолчанию — 8095 (HTTP через встроенный Nginx-прокси):

http://<адрес_сервера>:8095

Какие учётные данные по умолчанию? ​

  • Пользователь: admin
  • Пароль: nbadminpass

WARNING

Сразу после установки смените пароль администратора.

После установки на CentOS/RHEL получаю ошибку 502. Что делать? ​

Чаще всего причина — запрет SELinux на исходящие HTTP-соединения из Nginx. Выполните:

bash
sudo setsebool -P httpd_can_network_connect 1

Есть ли тестовый период и пробные ключи? ​

Да. Для ознакомления выдаётся временный лицензионный ключ. Оставьте заявку на сайте next-box.ru или напишите в отдел продаж.

Можно ли устанавливать дополнительные пакеты внутри Docker-контейнера NextBox? ​

Нет. Контейнер NextBox спроектирован как single-process: он не предназначен для установки дополнительных пакетов через apt/dnf внутрь. Любую кастомизацию делайте через docker-compose.yaml (переменные окружения, volume-монтирование, отдельные контейнеры), либо выбирайте пакетную установку на хостовой ОС.

Где посмотреть список контейнеров / сервисов в Docker-установке? ​

bash
docker compose ps

Основные сервисы, которые должны быть запущены: gateway, auth, license, discovery, file-storage, file-storage-router, file-storage-worker, share, webdav, notifications, connections, fca, logstash, proxy, static-storage и контейнеры зависимостей (postgres, rabbitmq, redis, nginx).

Конфигурация и запуск ​

Где находится основной конфигурационный файл? ​

В пакетной установке — /etc/nextbox/config.yml (YAML).

В Docker-установке отдельный конфиг-файл не обязателен: параметры передаются через переменные окружения в docker-compose.yaml.

Общее описание — Конфигурация.

Как переопределить параметры через переменные окружения? ​

Переменная окружения формируется по схеме:

POTENTIAL_<SERVICE_NAME>_<GROUP>_<PARAMETER>=<value>

Пример — задать порт HTTP для сервиса auth:

POTENTIAL_AUTH_HTTP_PORT=8080

Эквивалент в YAML:

yaml
auth:
  http:
    port: 8080

Переменные окружения имеют приоритет над значениями из конфиг-файла.

Как посмотреть текущие параметры сервиса? ​

Запустите исполняемый файл сервиса с командой echo:

bash
/usr/bin/<service_name> echo --format=yaml
# либо --format=json, --format=env

Как перевести NextBox на HTTPS? ​

HTTPS настраивается на уровне Nginx, который проксирует запросы к сервисам NextBox. Отредактируйте:

/etc/nginx/conf.d/nextbox.conf

Добавьте server { listen 443 ssl; ... }, укажите пути к сертификату и ключу, настройте редирект с 80 на 443. Общая документация — Настройка HTTPS в Nginx.

Затем перечитайте конфиг:

bash
systemctl reload nginx

Нужно ли перезагружать сервер после изменения конфигурации Nginx? ​

Нет, достаточно перечитать конфиг:

bash
systemctl reload nginx

Какой nginx-конфиг нужен для публичных ссылок (/l/)? ​

Для корректной работы публичных ссылок шаринга в nginx должен быть блок proxy для пути /l/:

nginx
location /l/ {
    proxy_pass http://127.0.0.1:9801/l/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Host $host;
    proxy_set_header Connection $proxy_connection;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_request_buffering off;
}

После изменений — systemctl reload nginx.

Обновление платформы ​

Как обновить NextBox, установленный через Docker Compose? ​

bash
cd <директория_установки>
cp /tmp/docker-compose.yaml ./docker-compose.yaml
docker load -i /tmp/nextbox.tar
docker compose up -d --pull never

Где docker-compose.yaml и nextbox.tar — файлы, полученные от NextBox или скачанные с дистрибутивного сервера.

Подробнее — раздел «Обновление» в Docker Compose.

Как обновить NextBox, установленный через пакет (Debian/Ubuntu)? ​

bash
apt update
apt install ptnl-nextbox

Для обновления расширений — аналогично, пакет соответствующего расширения (например, ptnl-nextbox-onlyoffice).

Как обновить Docker all-in-one? ​

Смените тег образа в команде запуска на актуальный, например:

nextbox-docker.ptnl.moscow/nextbox/nextbox-all-in-one:1.10.0

и перезапустите контейнер.

Нужно ли делать бэкап перед обновлением? ​

Рекомендация

Да. Сделайте резервную копию базы данных (PostgreSQL), каталога с файлами (file-storage-worker) и конфигурационных файлов перед обновлением.

При обновлении появляется ошибка «Failed to connect to nextbox-cloud.ptnl.moscow port 443». Что делать? ​

Ошибка означает, что сервер не может обратиться к инфраструктуре NextBox для получения обновления. Проверьте:

  1. Доступ с сервера до nextbox-cloud.ptnl.moscow:443 — пропинговать, проверить на firewall/VPN.
  2. Временная недоступность инфраструктуры — попробуйте повторить позже.
  3. Обходной путь — скачайте установочный файл вручную с другого компьютера и перенесите на сервер.

Если проблема повторяется — напишите в техподдержку.

После обновления слетела лицензия. Что делать? ​

Это может произойти, если у виртуальной машины изменились ТТХ (аппаратный хэш) в процессе обновления. Обратитесь в техподдержку — мы сгенерируем новый лицензионный ключ под актуальный hw_info_hash. Подробнее см. раздел Лицензирование.

Сколько времени занимает обновление? ​

Обычно обновление Docker Compose занимает минуты. Точное время зависит от скорости сети, размера образов и набора установленных расширений. Обновление без OnlyOffice проходит быстрее (OnlyOffice Docs Server — самый «тяжёлый» образ).

Лицензирование ​

Какие виды лицензий бывают? ​

NextBox поддерживает online и offline лицензии. Online-лицензия периодически сверяется с серверами NextBox, offline — работает в изолированных (закрытых) контурах без интернета.

Конфигурация сервиса лицензий — License.

Где хранится файл лицензии? ​

По умолчанию:

  • Файл ключа: /etc/nextbox/license.key (параметр license.filesystem.license_key_path)
  • Кеш информации о лицензии: /var/nextbox/license_info (параметр license.filesystem.license_key_info_path)

При изменении ТТХ виртуальной машины слетает лицензия. Что делать? ​

Лицензия привязана к аппаратному хэшу (hw_info_hash), который рассчитывается из характеристик сервера. При добавлении/изменении CPU, RAM, дисков хэш меняется и старый ключ становится невалидным.

Что делать:

  1. Зафиксируйте конечные ТТХ VM заранее.
  2. При изменении — запросите новый лицензионный ключ в техподдержке: support@next-box.ru, указав информацию об установке.

Я поделился файлом — выходит «Ошибка лицензии», хотя в меню лицензия активна. Что это? ​

Симптом: ссылки на расшаренные файлы перестают работать, перезагрузка помогает на ~10 минут, затем проблема возвращается.

Для диагностики соберите и направьте в техподдержку:

  • Версию NextBox
  • Способ установки
  • ОС и её версию
  • Логи сервисов license и share/links

Обращение — support@next-box.ru.

Лицензия периодически показывает ошибку — помогает обновление страницы. Это нормально? ​

Такое поведение указывает на то, что сервис шаринга/лицензий не всегда получает актуальное состояние лицензии. Если ошибка возвращается регулярно — соберите логи и обратитесь в поддержку (см. выше).

На какой адрес пробивать доступ из закрытого контура для онлайн-лицензии? ​

Для online-лицензии сервер NextBox периодически обращается к next-box.ptnl.ru. В закрытых контурах либо открывайте исходящий доступ к этому адресу, либо запрашивайте offline-лицензию.

Как получить offline-лицензию? ​

Напишите в техподдержку или отдел продаж, укажите способ установки, количество пользователей и сроки. Для offline-лицензии нужен hw_info_hash вашего сервера. Обращение — support@next-box.ru.

Аутентификация, LDAP/AD ​

Какие методы аутентификации поддерживаются? ​

  • Классическая аутентификация (логин/пароль)
  • Basic Authentication
  • LDAP / Active Directory

Управление методами — в настройках сервиса auth. Параметры — Auth.

Как настроить LDAP/AD через интерфейс? ​

Зайдите в настройки NextBox → раздел 🔒 AD / LDAP и заполните параметры (список ниже).

Подробное руководство — AD / LDAP для пользователей.

Какие параметры заполнять при подключении LDAP/AD? ​

ПараметрНазначениеПример
Адрес сервераURL LDAP-сервераldap://ldp.example.org
Шаблон авторизацииШаблон с LDAP: uid=,cn=users,cn=accounts,dc=example,dc=org
AD: @example.org
Ключ логинаАтрибут идентификацииLDAP: uid; AD: sAMAccountName
Base DNКорень поискаdc=example,dc=com
Ключ имениАтрибут имениgivenName
Ключ фамилииАтрибут фамилииsn
Ключ emailАтрибут почтыmail
Ключ телефонаАтрибут телефонаtelephoneNumber
Ключ группыАтрибут группmemberOf
Ключ ролиАтрибут ролиdescription

Полная справка — AD / LDAP.

Что такое Strict Groups и Strict Roles? ​

Два флага, которые ограничивают права пользователей содержимым каталога:

  • Strict Groups — пользователь получает доступ только к тем группам, в которых он состоит в LDAP/AD.
  • Strict Roles — роли пользователя ограничены теми, что определены в LDAP/AD.

Как часто синхронизируются данные из LDAP? ​

Членство в группах и ролях подтягивается автоматически при каждой попытке аутентификации пользователя. Поэтому права в NextBox всегда актуальны каталогу на момент логина.

В distinguishedName используется кириллица (ФИО с пробелами) — авторизация не проходит ​

Если в Active Directory CN представляет ФИО на кириллице с пробелами, подстановка в шаблон вида CN=,OU=... не работает: пользователь вводит логин (например, ivanov), а не ФИО.

Решение:

  • Использовать шаблон @<ваш_домен>
  • В поле «Ключ логина» указать sAMAccountName — это поле в AD соответствует логину пользователя.

Если структура каталога нестандартная — свяжитесь с техподдержкой, в ряде случаев требуется индивидуальная настройка шаблона.

Включил LDAP в конфиге, но метод не появляется. Что не так? ​

Проверьте, что в конфиге сервиса auth (/etc/nextbox/config.yml) указано:

yaml
auth:
  auth_methods:
    ldap: true

Эквивалент через env (для Docker):

POTENTIAL_AUTH_AUTH_METHODS_LDAP=true

После правки конфига перезапустите сервис:

bash
systemctl restart nextbox-auth

Для Docker — перезапустите контейнер auth.

После docker compose restart у пользователей пропадают токены. Почему? ​

Симптом: после перезапуска NextBox обычные пользователи (в т.ч. LDAP) теряют токены и должны залогиниться заново, а у администратора токен сохраняется. Это нештатное поведение — токены должны переживать перезапуск. Соберите логи сервиса auth и кеша (Redis), сообщите в техподдержку: support@next-box.ru.

Как настроить политику паролей? ​

В конфигурации сервиса auth доступны параметры:

  • auth.password.min_length — минимальная длина
  • auth.password.require_special_chars — требование спецсимволов
  • auth.password.require_uppercase — требование заглавных букв
  • auth.password.require_numbers — требование цифр
  • auth.password.update_notification_enabled — уведомление при смене пароля

Полный список — Auth.

Как ограничить количество неудачных попыток входа? ​

Параметры auth:

  • auth.login_attempts.max_failed_count — максимум неудачных попыток
  • auth.login_attempts.limit_period_minutes — период, за который считаются попытки

Как настроить блокировку неактивных пользователей? ​

Параметр auth.inactive_user.block_after_days — количество дней без входа, после которых учётная запись блокируется.

Как настроить блокировку экрана по неактивности? ​

Параметр auth.screen_lock_after_inactivity_minutes — время бездействия, после которого включается блокировка экрана.

Двухфакторная аутентификация (2FA) ​

Статус

В версии 1.10 (alder) 2FA уже реализована: одноразовый код (OTP) отправляется пользователю по SMS. Штатная интеграция выполнена с провайдером SMS.RU (sms.ru).

Как работает 2FA в NextBox? ​

После ввода логина и пароля пользователю дополнительно требуется ввести одноразовый код, присланный по SMS. Это снижает риск несанкционированного доступа, даже если пароль был скомпрометирован.

Как включить и настроить 2FA? ​

Настройка выполняется администратором в разделе Настройки → Двухфакторная аутентификация:

  1. Переведите переключатель «Включить блок настроек» в положение «Включено».
  2. Заполните параметры подключения к SMS.RU:
    • API-ключ — уникальный идентификатор для авторизации в API SMS.RU (получается в личном кабинете после регистрации).
    • Имя отправителя — например, NextBox (должно быть согласовано у операторов).
    • Базовый URL — https://sms.ru/sms/send.
    • Формат SMS — шаблон с подстановкой кода, например, Ваш код: {code}.
    • Количество цифр в OTP — обычно 6.
    • Время жизни OTP-кода — например, 1 минута.
    • Лимит запросов кода до блокировки — например, 5.
    • Минимальный интервал между лимитами — например, 5 минут.
    • Режим завершения сессий при включении 2FA:
      • soft — активные сеансы остаются, код из SMS будет запрошен при повторной авторизации;
      • hard — все активные сеансы сбрасываются, код требуется при следующем входе.
    • Системное уведомление о включении 2FA — оповещает всех пользователей о включении функции.
  3. Сохраните настройки.

Как зарегистрироваться в SMS.RU и получить имя отправителя? ​

  1. Регистрация. Перейдите на sms.ru и создайте аккаунт.
  2. API-ключ. Получите ключ в разделе «Программистам» и сохраните — он потребуется в настройках NextBox.
  3. Юридическое лицо. В разделе «Юридическим лицам» нажмите «Добавить юридическое лицо», заполните форму и отправьте данные на проверку.
  4. Буквенное имя (альфа-имя). В разделе «Отправители» нажмите «Создать буквенного отправителя» и заполните форму.
  5. Согласование у операторов. Направьте имя отправителя на согласование в МТС, Билайн, Мегафон, Tele2 и др. Срок рассмотрения — от 3 до 10 рабочих дней; операторы могут запросить дополнительные документы.
  6. После одобрения имя отправителя становится активным и доступно для использования в NextBox.

Хранение файлов и S3 ​

Где NextBox хранит файлы по умолчанию? ​

Файлы хранит сервис file-storage-worker. По умолчанию используется локальная файловая система (параметр file_storage_worker.storage.backend = native + file_storage_worker.storage.native_path). Метаданные хранятся в PostgreSQL через сервис file-storage.

Конфигурация — File Storage Worker, File Storage.

Как настроить S3-совместимое хранилище? ​

В конфигурации file-storage-worker укажите backend s3 и параметры подключения:

yaml
file_storage_worker:
  storage:
    backend: s3
    s3:
      endpoint: https://s3.example.com
      access_key_id: <KEY>
      secret_access_key: <SECRET>
      region: ru-central1
      bucket_prefix: nextbox-

Полный набор параметров — File Storage Worker.

Какой максимальный размер файла можно загрузить? ​

  • В стандартной конфигурации Docker Compose Nginx ограничивает тело запроса до 8 ГБ (client_max_body_size 8192M).
  • Дополнительно действует ограничение на уровне сервисов (gateway.http.max_body_size_mb, file_storage.http.max_body_size_mb).

Чтобы увеличить лимит — правьте значения в nginx и параметрах сервисов.

Файл большого размера (десятки/сотни ГБ) прерывается при загрузке. Что делать? ​

  1. Увеличьте client_max_body_size в /etc/nginx/conf.d/nextbox.conf до нужного значения.
  2. Поднимите тайм-ауты Nginx (client_body_timeout, send_timeout, proxy_read_timeout) — по умолчанию 60 секунд мало для больших файлов.
  3. Увеличьте max_body_size_mb в конфиге gateway и file-storage.
  4. Перезагрузите Nginx:
bash
systemctl reload nginx

Если проблема сохраняется — приложите к обращению в поддержку логи сервисов gateway и file-storage-worker.

При массовой миграции получаю ошибку 429 (Too Many Requests). В чём дело? ​

В gateway включён rate limiter для защиты от избыточной нагрузки. Он срабатывает при большом количестве запросов подряд (например, миграция >1500 файлов).

Отрегулируйте параметры секции gateway.http.limiter.*:

  • gateway.http.limiter.enable — включение/отключение
  • gateway.http.limiter.max_requests — максимум запросов
  • gateway.http.limiter.period_seconds — период, за который они считаются

После правки перезапустите gateway. Справка — Gateway.

Можно ли подключить несколько разных хранилищ? ​

Через сервис Connections и FCA можно подключать внешние источники: SFTP, Яндекс.Диск, WebDAV, NextBox, NextCloud, S3.

Справка — Connections, FCA.

Можно ли подключить Яндекс.Диск 360 («Общий диск»)? ​

В разделе «Подключения» есть коннектор к обычному Яндекс.Диску.

Можно ли делиться файлами, которые лежат в подключённом S3? ​

На момент последних обновлений шаринг файлов, находящихся в подключённом внешнем хранилище (S3), не поддерживается. Для совместной работы файл нужно перенести во внутреннее хранилище NextBox.

Совместный доступ и ссылки ​

Пользователь переходит по ссылке общего доступа — его перебрасывает на страницу авторизации. Почему? ​

Возможные причины:

  1. Ссылка выдана только авторизованным пользователям — получатель должен быть заведён в системе и войти в аккаунт.
  2. Истёк срок действия ссылки — проверьте настройки срока в параметрах шаринга.
  3. Передан неправильный URL — см. следующий вопрос.

Скопировал URL открытого файла в браузере и передал коллеге — у него файл не открывается ​

Это наиболее частая причина «непоняток» с шарингом.

URL из адресной строки браузера — это не публичная ссылка. Если вы открываете файл у себя и копируете адрес из браузера, вы копируете внутренний маршрут, привязанный к вашей сессии.

Правильно:

  • В интерфейсе на файле/папке откройте «Доступ» / «Поделиться».
  • Настройте права (по ссылке, с редактированием или только на просмотр).
  • Скопируйте ссылку из окна шаринга — именно её отдавайте коллеге.

Получатель может также открыть файл через раздел «Доступные мне» — если ему уже выдали доступ, файл будет там.

Как правильно расшарить файл по публичной ссылке? ​

  1. Выделите файл/папку.
  2. Нажмите «Поделиться» (или значок шаринга).
  3. В окне доступа включите «Доступ по ссылке» и при необходимости — право на редактирование.
  4. Скопируйте появившуюся ссылку и передайте получателю.

Что за раздел «Доступные мне»? ​

Это раздел интерфейса, где пользователь видит все объекты (файлы/папки), к которым ему выдан доступ другими пользователями. Если коллега выдал вам доступ — откройте файл именно отсюда, а не по URL из браузера.

Как работает форма (Forms) и как ею делиться? ​

Возможны два сценария:

  • По ссылке — проще: в настройках формы включите доступ по ссылке и дайте право редактирования, передайте ссылку из окна шаринга.
  • Персональный доступ — пользователь открывает форму из раздела «Доступные мне» (важно: не по URL из браузера).

Можно ли передать владельца объекта другому пользователю? ​

На момент публикации передача владения автоматически выполняется при удалении пользователя: все объекты удаляемого переходят к указанному новому владельцу с сохранением всех ранее выданных доступов.

Ручная передача владения для активных учётных записей — в планах развития.

Реализованы ли «универсальные» ссылки на файлы? ​

Универсальные ссылки для общего доступа появились в версии 1.8 (elm). Подробнее — Changelog 1.8.

Что происходит с логами и объектами удалённого пользователя? ​

  • Все объекты (файлы/папки) переходят новому владельцу, выданные доступы сохраняются.
  • Логи действий удалённого пользователя сохраняются без изменений — их можно использовать для расследований.
  • В интерфейсе поиск по логам работает по существующим пользователям. Для анализа событий удалённых пользователей — выгрузите логи и анализируйте во внешних инструментах.

WebDAV ​

По какому адресу подключаться по WebDAV? ​

http://<адрес_сервера>:8095/api/v1/webdav

Логин/пароль — учётные данные пользователя NextBox. Для дополнительной безопасности в версии 1.8 появились application passwords — отдельные пароли для WebDAV-клиентов.

Как подключить NextBox по WebDAV в Windows? ​

Через Проводник: «Этот компьютер» → «Добавить сетевое расположение» → указать URL (см. выше) → ввести логин/пароль NextBox.

Как подключить NextBox по WebDAV в macOS? ​

Finder → меню «Переход» → «Подключение к серверу…» (⌘K) → ввести URL → логин/пароль.

Как подключить NextBox по WebDAV в Linux (davfs2)? ​

  1. Установите davfs2:
bash
sudo apt install davfs2
  1. Создайте точку монтирования:
bash
mkdir ~/nextbox-webdav
  1. Добавьте строку в /etc/fstab:
http://<адрес>:8095/api/v1/webdav /home/<user>/nextbox-webdav davfs rw,user,auto 0 0
  1. Пропишите учётные данные в /etc/davfs2/secrets (права 600):
<адрес>:8095 <username> <password>
  1. Добавьте пользователя в группу:
bash
sudo usermod -aG davfs2 <username>
  1. Смонтируйте:
bash
mount ~/nextbox-webdav

Подробнее — WebDAV.

WebDAV медленно работает с десятками тысяч файлов. Можно ли использовать SMB? ​

Ограничения производительности WebDAV на больших объёмах — известная особенность протокола. Поддержка SMB (Samba) на момент публикации не реализована. Если кейс критичен — сообщите в техподдержку с описанием ожидаемого масштаба.

OnlyOffice ​

Зачем нужен OnlyOffice? ​

Расширение OnlyOffice добавляет в NextBox онлайн-редактирование офисных документов (docx, xlsx, pptx, odt и т. п.). Требуется отдельный OnlyOffice Docs Server и сервис интеграции NextBox.

Какие методы установки доступны? ​

МетодСтатус
Docker ComposeRECOMMENDED
Docker all-in-oneEXPERIMENTAL
Debian / UbuntuDEPRECATED
CentOS / RHEL / FedoraDEPRECATED
Astra LinuxDEPRECATED
Alt LinuxDEPRECATED

Инструкции — OnlyOffice: Установка.

Как обновить OnlyOffice отдельно от NextBox? ​

На пакетной установке (Debian/Ubuntu):

bash
apt update
apt install ptnl-nextbox-onlyoffice

В Docker Compose: смените теги образов OnlyOffice в docker-compose.yaml и выполните:

bash
docker compose up -d --pull never

Какие параметры настраиваются в сервисе OnlyOffice? ​

Ключевые параметры секции onlyoffice:

  • onlyoffice.http.port — порт сервиса
  • onlyoffice.server_address — адрес OnlyOffice Docs Server
  • onlyoffice.service.token — токен межсервисного взаимодействия
  • onlyoffice.discovery.url — адрес Discovery
  • onlyoffice.tokens.sign_key — ключ подписи JWT
  • onlyoffice.db.dsn — PostgreSQL DSN

Полная справка — OnlyOffice: Конфигурация.

Открываю файл в OnlyOffice — перекидывает на страницу авторизации. Что делать? ​

Чаще всего причина — попытка открыть файл по URL из браузера (скопированному другим пользователем). Откройте файл одним из способов:

  • Из своего «Моего диска».
  • Из раздела «Доступные мне» (если вам выдали доступ).
  • По правильной ссылке, скопированной из окна шаринга.

Если ошибка повторяется при корректном способе — пришлите в поддержку версию, ОС, способ установки и точный сценарий воспроизведения.

Какие типы файлов можно открыть в OnlyOffice? ​

Стандартные офисные форматы: docx, xlsx, pptx, odt, ods, odp, txt. Для нестандартных расширений потребуется уточнить поддержку.

Безопасная загрузка (Security extension) ​

Что такое «Безопасная загрузка файлов»? ​

Функция проверки загружаемых файлов внешними системами безопасности перед сохранением в хранилище. Каждый загружаемый файл помещается в карантин; после проверки он либо перемещается в основное хранилище, либо остаётся заблокированным.

Описание — Security: Описание.

Какие статусы могут быть у файла? ​

  • «На проверке» — файл в карантине, ждёт результата внешнего сканирования.
  • «Заблокировано» — внешняя система вернула отрицательный вердикт, файл не допущен в хранилище.

В интерфейсе нет настройки «Безопасная загрузка» — почему? ​

Настройка появляется только при установленном и запущенном сервисе Security и настроенной интеграции с внешней системой проверки. Установите расширение — Security: Установка — и настройте интеграцию с Kaspersky или InfoWatch.

Какие внешние системы поддерживаются? ​

Штатно поддерживаются:

  • Kaspersky Endpoint Security для Linux (KESL) 12.1
  • InfoWatch Traffic Monitor 7.8

Также поддерживается подключение произвольного HTTP-сканера через общий API (см. ниже).

Какие методы установки Security доступны? ​

МетодСтатус
Docker ComposeRECOMMENDED
Docker all-in-oneEXPERIMENTAL
Debian / UbuntuDEPRECATED
CentOS / RHEL / FedoraDEPRECATED
Astra LinuxDEPRECATED
Alt LinuxDEPRECATED

Инструкции — Security: Установка.

Как настроить интеграцию с Kaspersky KESL? ​

В конфигурации Security пропишите блок security.integrations.kesl:

yaml
security:
  integrations:
    kesl:
      scan_endpoint_url: http://kaspersky-server:8080/scan
      http_port: 8080
      security_service_url: http://127.0.0.1:6004

Требуется лицензированная установка Kaspersky KESL 12.1. Подробнее — Security: Конфигурация.

Как настроить интеграцию с InfoWatch? ​

yaml
security:
  integrations:
    infowatch:
      push_api_address: http://infowatch-server:8080
      export_api_domain: https://infowatch-server
      auth_token: <TOKEN>
      company_id: <COMPANY_ID>
      security_service_url: http://127.0.0.1:6004

Требуется лицензированная установка InfoWatch Traffic Monitor 7.8.

Можно ли подключить свой антивирус или DLP? ​

Да. Security поддерживает пользовательские HTTP-сканеры:

  • NextBox отправляет JSON с идентификаторами bucket и файла.
  • Ваш сервис должен вернуть ответ вида {"status": "Allowed"} с HTTP 200 — файл допустят в хранилище. Иначе файл заблокируется.

Как настроить карантин? ​

В конфиге Security:

  • security.quarantine.enabled — включить/отключить карантин
  • security.quarantine.storage_duration_hours — сколько часов хранить заблокированные файлы (по умолчанию 720, т. е. 30 дней)
  • security.filesystem.repository_path — путь к репозиторию карантина

Что такое strict_secure_upload? ​

Параметр включает строгий режим: загрузка файлов допустима только при доступном Security-сервисе. Если сервис недоступен — загрузка блокируется. По умолчанию это обычно false (мягкий режим).

Как регулировать параллельность проверки? ​

Параметр security.security_rabbit_mq_num_workers — количество параллельных воркеров, обрабатывающих очередь на сканирование.

Прочая безопасность ​

Есть ли у NextBox встроенная защита WAF и от DDoS? ​

Встроенного WAF и DDoS-защиты на уровне приложения нет — это уровень сетевой инфраструктуры. Рекомендуемые подходы:

  • Reverse-proxy с фильтрацией (Cloudflare, Qrator, и др.)
  • Аппаратный или облачный WAF
  • Rate limiting и ограничение размера тела запроса в Nginx

На уровне приложения NextBox обеспечивает аутентификацию (в т. ч. LDAP/AD), управление правами доступа, аудит действий, сканирование файлов через Security.

Ведётся ли аудит действий пользователей? ​

Да. Аудит событий ведётся и сохраняется в системе. В версии 1.9 в интерфейс добавлена фильтрация аудита по типам событий. Логи старых действий сохраняются даже после удаления пользователя.

Как управлять сроком хранения логов? ​

За хранение логов отвечает сервис Logstash (в составе NextBox — не путать с Elastic Logstash). Параметр logstash.db.logs_retention_hours задаёт срок хранения (по умолчанию 720 часов). Справка — Logstash.

Расширения и интеграции ​

Какие официальные расширения поддерживаются? ​

  • OnlyOffice — онлайн-редактирование документов. См. OnlyOffice.
  • Security — проверка файлов через антивирус и DLP. См. Security.
  • Wiki — вики-движок для документации, c поддержкой AI (GIGACHAT). См. Wiki.
  • PDF — работа с PDF-документами. См. PDF.

Как устанавливать расширения? ​

Через админку NextBox: раздел расширений, кнопка «Установить» рядом с нужным. Для офлайн-сценариев — вручную, скачав дистрибутив.

Не устанавливаются расширения — нажимаю «Установить», ничего не происходит ​

Проверьте:

  1. Исходящий доступ в интернет с сервера и из контейнера NextBox — до next-box.ru.
  2. Firewall / reverse-proxy / VPN — не блокируют ли запросы.
  3. Ограничения в Nginx — client_max_body_size должен позволять загрузить дистрибутив.

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

Можно ли ставить расширения офлайн? ​

Да. Скачайте дистрибутив расширения с дистрибутивного сервера на машину с интернетом, перенесите на сервер NextBox и установите через админку.

Какие типы расширений бывают? ​

ТипНазначениеПример
FileРабота с отдельными файлами определённых форматовPDF-просмотрщик
WorkDirУправление директориями и их содержимымАрхиватор
AppАвтономное приложение в главном менюWiki, блокнот

Руководство — Создать своё расширение.

Как сделать своё расширение? ​

В репозиторий расширения добавьте config.json с полями:

  • uniq_key — уникальный идентификатор
  • локализованное название
  • тип (File / WorkDir / App)
  • entry point

Базовый шаблон — React + Vite, инициализация через пакет next-box:

js
const nextBox = new NextBox();
nextBox.init(...);

SDK — next-box (npm).

Как опубликовать своё расширение? ​

Отправьте пакет с расширением на info@next-box.ru — команда проведёт ревью и опубликует в магазине расширений.

Доступен ли DrawIO в закрытом контуре? ​

На момент публикации полноценный DrawIO в закрытых контурах не поддерживается: для этого нужен отдельный бэк-сервис (аналогично OnlyOffice Docs Server) и доработка фронта. Приоритет уточняйте в техподдержке.

Поддерживается ли почтовый клиент внутри NextBox? ​

Встроенного почтового клиента в продуктовой поставке нет. Обсуждалась интеграция сторонних клиентов (Afterlogic WebMail Lite, SnappyMail, Roundcube) через отдельный сервис, аналогично OnlyOffice. Статус уточняйте в техподдержке.

Поддерживается ли интеграция с Wiki / AI? ​

Да, есть встроенное расширение Wiki с интеграцией Sber GIGACHAT. Требования: сертификаты Министерства цифрового развития должны быть установлены на уровне ОС. Подробнее — Wiki.

Поддерживается ли ALMI Office? ​

Интеграция с ALMI Office на момент публикации не реализована.

Архитектура и масштабирование ​

Из каких сервисов состоит платформа? ​

Основные сервисы:

СервисНазначение
GatewayВходная точка для всего API платформы
AuthУправление пользователями, группами, ролями, LDAP
LicenseУправление лицензией (онлайн и оффлайн)
DiscoveryРеестр сервисов
NotificationsУведомления (WebSocket, email)
File StorageМетаданные файловой системы
File Storage RouterМаршрутизация операций с файлами
File Storage WorkerХранение содержимого (локальное / S3)
Share / LinksПубличные ссылки, общий доступ
WebDAVДоступ по WebDAV
ConnectionsКонфигурации внешних подключений
FCAДоступ к внешним хранилищам (SFTP, Yandex Disk, WebDAV, NextCloud, S3)
SecurityПроверка файлов антивирусом/DLP
LogstashХранение логов
Static StorageСтатические активы (расширения, аватары)
ProxyПрокси-сервис

Полное описание — Сервисы.

Зачем сервис Discovery? ​

Discovery — внутренний реестр сервисов: каждый сервис регистрируется в Discovery и узнаёт адреса других сервисов через него. Обычно слушает порт 6001.

Зачем сервис Gateway? ​

Gateway — единая точка входа для клиентских запросов. Он маршрутизирует HTTP-запросы к нужным сервисам, проверяет токены, применяет rate limiting.

Как масштабировать Gateway? ​

Для каждого инстанса Gateway:

  • уникальный POTENTIAL_GATEWAY_SERVICE_INSTANCE_NUMBER (начиная с 1)
  • отдельная база PostgreSQL
  • балансировка через nginx upstream

Подробнее — Масштабирование.

Как масштабировать File Storage? ​

Масштабируются два сервиса: file-storage-router и file-storage-worker. Распределение — Round Robin.

Для каждого инстанса worker:

  • уникальный instance_number
  • отдельный том монтирования
  • индивидуальная конфигурация discovery и RabbitMQ

Поток: Gateway → File Storage Router → File Storage Worker.

Можно ли разнести сервисы на разные хосты? ​

Да, архитектура это допускает: каждый сервис имеет свой адрес и порт, взаимодействуют они через Discovery и RabbitMQ. Для правильной настройки обратитесь в техподдержку с описанием целевой схемы развёртывания.

Уведомления ​

Какие виды уведомлений есть? ​

  • WebSocket — уведомления в реальном времени в интерфейсе.
  • Email — уведомления по почте (настройка на стороне сервиса notifications).

Конфигурация — Notifications.

Мониторинг и администрирование ​

Как посмотреть состояние сервисов? ​

В интерфейсе — раздел «Информация системы»: отображается список сервисов и их статус (зелёные галочки / красные крестики).

Где находятся логи сервисов? ​

  • В пакетной установке логи сервисов пишутся в путь, заданный параметром <service>.log.path (например, /var/log/nextbox/auth.log).
  • В Docker-установке логи доступны через docker logs <container> или docker compose logs <service>.

Сервисные логи также агрегируются в сервисе Logstash — срок хранения задаётся параметром logstash.db.logs_retention_hours (по умолчанию 720 часов). Справка — Logstash.

Изменения по версиям ​

Что нового в версии 1.10 (alder)? ​

Релиз 02.04.2026. Ключевые изменения:

  • Теги — система тегов на объектах (до 20 тегов, 1–50 символов, 7 цветов).
  • Виртуальные папки — группировка объектов по тегам.
  • Управление группами — массовый выбор при настройке ограничений.
  • Группы по умолчанию — новые пользователи автоматически добавляются в указанные группы.
  • Уведомления об обновлениях — админ видит, когда доступна новая версия платформы.
  • Форма обратной связи — в профиле пользователя.
  • Окно загрузок — опции «открыть в новой вкладке», «перейти к файлу», «поделиться»; выделена отдельная иконка.
  • Раздел «Shared by Me» — «Мой общий доступ».
  • Мобильные исправления: Notification Center, «Информация системы», «Ограничения и квоты»; сортировка по типу.

Полный список — Changelog 1.10 (alder).

Что нового в версии 1.9 (thuja)? ​

Релиз 01.02.2026. Ключевые изменения:

  • Пакетная загрузка папок в ZIP.
  • Save As для любых версий файлов.
  • Real-time прогресс копирования через WebSocket.
  • Визуализация «стека» при drag-and-drop нескольких объектов.
  • Переработанная панель расширений — фильтрация по тегам, чекбокс «Hide installed», поиск, прогресс-спиннер при установке, блок рекомендованных расширений.
  • Версионирование изображений — полная история версий, комментарии к версиям.
  • ZIP, PDF, EPUB более не поддерживают версионирование.
  • Dropdown аватара: профиль, смена пароля, выход.
  • Массовый выбор членов группы.
  • Фильтрация аудита по типам событий.
  • Исправлена ошибка OnlyOffice с заменой содержимого документа.

Полный список — Changelog 1.9 (thuja).

Что нового в версии 1.8 (elm)? ​

Релиз 01.10.2025. Ключевые изменения:

  • Поиск по названиям файлов и директорий.
  • ZIP-архивы: загрузка папок в ZIP, создание/просмотр/распаковка.
  • Универсальные ссылки общего доступа.
  • Управление ограничениями загрузок через роли.
  • Application passwords — отдельные пароли для подключений по WebDAV.
  • Квоты хранилища на пользователя.
  • Настраиваемый дашборд — перетаскиваемые виджеты.
  • Клавишные сокращения: Delete (Windows), Cmd+Backspace (macOS).
  • Переработанная секция Settings.
  • Переключатель видимости системных файлов.
  • WebSocket-прогресс для копирования папок.
  • Блокировка версии файла во время редактирования в OnlyOffice.
  • Корректная обработка отзыва доступа при комментариях.
  • Auto-resolution конфликтов при копировании в ту же директорию.

Полный список — Changelog 1.8 (elm).

Куда обратиться, если ответа нет ​

При обращении в поддержку приложите:

  • Версию NextBox (раздел «Информация системы»)
  • Способ установки (Docker Compose, Docker all-in-one, пакетная)
  • Операционную систему и её версию
  • Описание проблемы и логи сервисов