Файловый браузер Quantum: Революционное решение для самостоятельного хостинга с интеграцией OnlyOffice

Введение: Будущее облачного хранилища под вашим контролем

В эпоху, когда облачные сервисы монополизируют рынок персональных данных, многие организации и частные пользователи стремятся к независимости. Централизованные решения вроде Google Drive, Dropbox и OneDrive предоставляют удобство, но ценой теряется контроль над конфиденциальностью информации. Если вы ищете мощный, лёгкий, современный веб-менеджер файлов для собственного сервера, который при этом поддерживает редактирование документов офисных форматов прямо в браузере, то FileBrowser Quantum представляет собой идеальное решение.

FileBrowser Quantum — это не просто обновлённая версия классического FileBrowser. Это полностью переработанный форк, переосмыслены архитектура, добавлены десятки новых функций, и всё это упаковано в невероятно компактный исполняемый файл, занимающий всего 15 мегабайт в облегченной версии. В этой подробной статье мы рассмотрим все аспекты этого инструмента: от исторического контекста и архитектурных решений до практического развертывания и интеграции с популярным офис-пакетом OnlyOffice.

История и эволюция: От FileBrowser к Quantum

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

В этой ситуации появился разработчик Graham Steffaniak, создавший форк под названием FileBrowser Quantum. Это было не простое обновление кода — это была кардинальная переработка. Quantum привнёс инновационные функции, которые опытные администраторы просили годами: реальное время поиска с индексированием, поддержка нескольких источников хранилищ, модернизированный интерфейс, интеграция с современными стандартами безопасности и полная поддержка редактирования офисных документов.

Название «Quantum» выбрано неслучайно. Оно символизирует огромное количество функционала, упакованного в ничтожно малый размер приложения. Подумайте об этом: функциональность, которая требует сотни мегабайт у Nextcloud или OwnCloud, здесь реализована за счёт оптимизированного Go кода в объёме 15-60 мегабайт. Это результат чистого, продуманного дизайна и отказа от ненужного функционала.

Архитектура и философия проектирования

Понимание архитектуры FileBrowser Quantum критически важно для понимания того, почему он работает столь эффективно и почему его стоит выбрать для вашей инфраструктуры.

Использование языка Go

FileBrowser Quantum написан на Go — языке программирования, разработанном компанией Google специально для создания высокопроизводительных, масштабируемых приложений. Go предоставляет встроенную поддержку многопоточности через горутины, которые потребляют на порядки меньше памяти, чем традиционные потоки операционной системы. Это означает, что Quantum может обслуживать тысячи одновременных соединений, используя при этом меньше ресурсов, чем приложение на Python или Node.js обслуживало бы сотню.

Компилируемая природа Go обеспечивает ещё одно преимущество: конечный бинарный файл самодостаточен. Ему не требуется интерпретатор, виртуальная машина или дополнительные зависимости во время выполнения. Вы просто загружаете бинарник на сервер и запускаете его. Это резко упрощает развертывание, обновление и управление приложением.

Концепция множественных источников (Multi-Source Architecture)

Одно из ключевых архитектурных решений в Quantum — поддержка нескольких источников хранилищ одновременно. Традиционный файловый менеджер привязан к одной локальной файловой системе. FileBrowser Quantum позволяет вам монтировать несколько источников в единый интерфейс:

• Локальная файловая система сервера (любой раздел, любая директория)
• Amazon S3 бакеты (и совместимые сервисы вроде MinIO, DigitalOcean Spaces)
• WebDAV серверы
• FTP/SFTP серверы
• Потенциально другие источники в будущих версиях

Эта архитектура позволяет вам спроектировать гибкую систему хранения данных. Например, горячие данные (часто используемые файлы) могут храниться на локальном SSD, данные — на S3 совместимом хранилище, а резервные копии — на удалённом SFTP сервере. Всё это может быть доступно пользователю через единый интерфейс, словно всё находится в одном месте.

Real-Time Indexing: Революция в поиске

Классический FileBrowser использует простой поиск по названию файла. Если у вас есть тысячи файлов, поиск может занять несколько секунд. FileBrowser Quantum внедряет мощную систему real-time индексирования, которая мониторит файловую систему в режиме реального времени.

Когда файл добавляется, изменяется или удаляется, индекс обновляется почти мгновенно. Поиск теперь работает так же, как поиск в профессиональных IDE вроде Visual Studio Code или JetBrains инструментов. Вы начинаете печатать, и рекомендации появляются во время набора текста. Индексирование происходит автоматически в фоне и не требует запланированных переиндексирований.

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

Стратегия безопасности: Многоуровневая защита

Квантум реализует многоуровневую стратегию безопасности:

Аутентификация OIDC (OpenID Connect): Это современный стандарт аутентификации, который позволяет интегрировать Quantum с корпоративными системами управления идентификацией. Вы можете связать его с Keycloak, Okta, Google Workspace, Microsoft Entra ID и другими провайдерами. Пользователи используют единый вход (SSO), а их права управляются централизованно.

Локальная аутентификация с 2FA: Если вы не хотите использовать корпоративный провайдер, Quantum поддерживает локальные учётные записи с двухфакторной аутентификацией на основе TOTP (Time-based One-Time Password). Это то же самое, что используется Google Authenticator, Microsoft Authenticator и другими приложениями.

Аутентификация через прокси: Для продвинутых пользователей существует режим прокси-аутентификации. Вы размещаете Quantum за обратным прокси (Traefik, Nginx), который обрабатывает аутентификацию, и Quantum доверяет заголовкам, переданным прокси. Это позволяет реализовать сложные сценарии безопасности.

Контроль доступа на уровне директорий: После аутентификации пользователя, система проверяет, какие директории ему разрешены. Каждый пользователь может иметь область (scope) — корневую директорию, выше которой он не может подняться. Это идеально для многопользовательских сценариев.

OnlyOffice: Интеграция редактирования документов

Один из самых впечатляющих аспектов FileBrowser Quantum — его интеграция с OnlyOffice. Это позволяет редактировать документы прямо в браузере без необходимости загружать их на локальный компьютер.

Что такое OnlyOffice Document Server

OnlyOffice — это бесплатный, открытый офис-пакет, разработанный Ascensio System. Document Server — это компонент, который работает как веб-сервис и обеспечивает редактирование документов в браузере. В отличие от Google Docs или Microsoft Office Online, OnlyOffice Document Server вы можете установить на собственном сервере.

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

Поддерживаемые форматы

После интеграции OnlyOffice с FileBrowser Quantum вы получаете поддержку редактирования следующих форматов:

Текстовые документы: .doc, .docm, .docx, .dot, .dotm, .dotx, .epub, .fb2, .fodt, .htm, .html, .mht, .mhtml, .odt, .ott, .rtf, .stw, .sxw, .txt, .wps, .wpt, .xml

Электронные таблицы: .csv, .et, .ett, .fods, .ods, .ots, .sxc, .xls, .xlsb, .xlsm, .xlsx, .xlt, .xltm, .xltx

Презентации: .dps, .dpt, .fodp, .odp, .otp, .pot, .potm, .potx, .pps, .ppsm, .ppsx, .ppt, .pptm, .pptx, .sxi

Другие форматы: .djvu, .docxf, .oform, .oxps, .pdf, .xps

Как работает интеграция

Интеграция между FileBrowser Quantum и OnlyOffice работает через JWT (JSON Web Token) токены. Вот как процесс выглядит:

1. Пользователь открывает документ в FileBrowser Quantum
2. Quantum генерирует JWT токен, содержащий информацию о пользователе и файле
3. Браузер отправляет запрос на OnlyOffice с этим токеном
4. OnlyOffice проверяет подпись токена, используя общий секрет
5. Если токен действителен, OnlyOffice загружает файл с Quantum и открывает редактор
6. При сохранении документа OnlyOffice отправляет изменённый файл обратно на Quantum

Эта схема гарантирует, что только авторизованные пользователи могут редактировать файлы. OnlyOffice не может просто так получить доступ к файлам — каждый запрос должен быть подписан.

Развертывание OnlyOffice

Развертывание OnlyOffice можно осуществить несколькими способами:

Docker-вариант (рекомендуется): Самый простой способ — запустить OnlyOffice в Docker контейнере. Одна команда, и сервис готов к работе. Docker образ «onlyoffice/documentserver» официально поддерживается и регулярно обновляется.

Нативная установка на Linux: OnlyOffice может быть установлен напрямую на Ubuntu/Debian через официальный репозиторий. Это требует больше шагов, но работает стабильно в продакшене.

Облако: Если вы не хотите самостоятельно хостить OnlyOffice, существуют облачные версии, хотя это уменьшает преимущества самостоятельного хостинга.

Для локальной сети или VPN рекомендуется использовать HTTP (по крайней мере изначально, для тестирования). Для интернета необходимо настроить HTTPS с действительным SSL сертификатом.

Развертывание: От нуля к работающей системе

Требования

Минимальные требования к системе для FileBrowser Quantum удивительно скромны:

• Процессор: Любой современный процессор x86_64 или ARM64. Даже давно снятый с производства Intel i3, AMD a6, a8,a10, ryzen, или ARM Cortex-A53 справятся отлично.
• Оперативная память: 512 МБ для базовой работы, 1-2 ГБ при интеграции с OnlyOffice.
• Хранилище: Зависит от размера индекса и кэша. Обычно достаточно 100 МБ свободного места для самого приложения.
• Операционная система: Linux (Debian/Ubuntu/Alpine), macOS или Windows. Quantum работает везде.
• Сетевое подключение: Для работы в локальной сети или доступа через интернет.

Развертывание с Docker

Docker развертывание — это самый простой и рекомендуемый способ:

Шаг 1: Создание Docker Compose файла

Создайте файл docker-compose.yaml со следующим содержимым:

text version: '3'
services:
  filebrowser:
    image: gtstef/filebrowser:latest
    container_name: filebrowser
    ports:
      - "80:80"
    volumes:
      - /path/to/your/files:/srv
      - ./config:/config
      - ./database:/database
    environment:
      FILEBROWSER_CONFIG: /config/config.yaml
    restart: unless-stopped

  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice
    ports:
      - "8080:80"
    environment:
      JWT_SECRET: YOUR_JWT_SECRET_HERE
    volumes:
      - ./onlyoffice_logs:/var/log/onlyoffice
      - ./onlyoffice_data:/var/www/onlyoffice/Data
    restart: unless-stopped

Шаг 2: Получение JWT секрета

JWT секрет используется для подписи токенов между Quantum и OnlyOffice. Получите его следующей командой (после запуска контейнера OnlyOffice):

bash docker exec onlyoffice /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json 'services.CoAuthoring.secret.session.string'

Шаг 3: Создание конфигурационного файла

Создайте файл ./config/config.yaml:

text server:
  bind: ":80"
  baseURL: "/"
  sources:
    - path: "/srv"
      denyByDefault: false

log:
  level: info
  file: "/config/filebrowser.log"

auth:
  method: password
  password:
    enabled: true
    minLength: 5
    adminPassword: SECURE_PASSWORD_HERE

integrations:
  office:
    url: "http://onlyoffice:80"
    secret: "JWT_SECRET_FROM_STEP_2"
    internalUrl: "http://onlyoffice"

Шаг 4: Запуск контейнеров

bash docker compose up -d

Через несколько секунд FileBrowser Quantum будет доступен по адресу http://your-server-ip, а OnlyOffice — по адресу http://your-server-ip:8080.

Развертывание на Linux без Docker

Если вы предпочитаете нативное развертывание на Linux:

Шаг 1: Загрузка бинарника

Перейдите на https://github.com/gtsteffaniak/filebrowser/releases и загрузите последнюю версию для вашей архитектуры (обычно Linux x86_64):

bash wget https://github.com/gtsteffaniak/filebrowser/releases/download/v0.x.x/filebrowser_linux_amd64
chmod +x filebrowser_linux_amd64

Шаг 2: Создание конфигурационного файла

text server:
  bind: ":8080"
  baseURL: "/"
  sources:
    - path: "/home/user/files"
      denyByDefault: false

auth:
  method: password
  password:
    adminPassword: "secure_password"

Шаг 3: Создание systemd сервиса

Создайте /etc/systemd/system/filebrowser.service:

text[Unit]
Description=FileBrowser Quantum
After=network.target

[Service]
Type=simple
User=filebrowser
Group=filebrowser
WorkingDirectory=/opt/filebrowser
ExecStart=/opt/filebrowser/filebrowser_linux_amd64 -c config.yaml
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Шаг 4: Активация сервиса

bash 
sudo useradd -r -s /bin/false filebrowser
sudo systemctl daemon-reload
sudo systemctl enable filebrowser
sudo systemctl start filebrowser

Практические сценарии использования

Сценарий 1: Персональное облако для семьи

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

Сценарий 2: Корпоративное хранилище документов

Компания интегрирует FileBrowser Quantum с корпоративной системой управления идентификацией (LDAP или OIDC провайдер). Сотрудники входят, используя корпоративные учётные данные, и автоматически получают доступ к своим проектным папкам. Руководители проектов используют OnlyOffice для редактирования документов прямо в веб-интерфейсе, без необходимости скачивать и переоткрывать файлы.

Сценарий 3: Архив больших данных

Исследовательская лаборатория использует FileBrowser Quantum для управления большим объёмом научных данных. Горячие данные (активные проекты) хранятся на локальном SSD, которым управляет Quantum. Холодные данные (завершённые проекты) хранятся на S3-совместимом хранилище (например, MinIO), также подключённом к Quantum. Исследователи видят все данные в едином интерфейсе и могут быстро искать нужные файлы.

Сценарий 4: Backup и восстановление

FileBrowser Quantum с API и CLI инструментами интегрируется в систему резервного копирования. Скрипты автоматически загружают важные документы на удалённый SFTP сервер (который также подключён как источник в Quantum), обеспечивая двойное резервирование. В случае потери данных, администратор может быстро найти и восстановить нужные файлы через единый интерфейс.

Сравнение с конкурентами

FileBrowser Quantum vs Nextcloud

Параметр	FileBrowser Quantum	Nextcloud
Размер приложения	15-60 МБ	300+ МБ
Требования памяти	256-512 МБ	2-4 ГБ
Время установки	< 5 минут	30+ минут
Real-time поиск	Да	Нет (только индексирование)
OIDC	Да	Да (с плагинами)
Редактирование документов	OnlyOffice/встроенный	Collabora/OnlyOffice
Кривая обучения	Мягкая	Крутая
Гибкость	Высокая	Средняя
Стоимость поддержки	Бесплатно (сообщество)	Платно ($600+/год)

Nextcloud — это полнофункциональная корпоративная платформа с календарями, контактами, видеоконференциями и сотней плагинов. Если вам нужны все эти функции, Nextcloud имеет смысл. Но если вам просто нужен надёжный, быстрый файловый менеджер — FileBrowser Quantum победит по эффективности.

FileBrowser Quantum vs OwnCloud

Параметр	FileBrowser Quantum	OwnCloud
Лицензия	Apache 2.0	AGPL v3 / Proprietary
Активная разработка	Да (2025)	Замедлена
Современный кодовый стек	Go	PHP/MySQL
Требования к ресурсам	Низкие	Высокие
Документация	Полная	Хорошая
Облачный хостинг	Нет	Да
Поддержка	Сообщество	Платная

OwnCloud — установилась на своих лаврах. Активная разработка практически остановилась, a её системные требования намного выше. Основные улучшения происходят в Nextcloud, их «младшем брате». FileBrowser Quantum представляет свежую альтернативу.

FileBrowser Quantum vs FileRun

FileRun — хороший выбор для тех, кто готов платить за поддержку. Он лёгче, чем Nextcloud, но тяжелее Quantum. Главный недостаток FileRun — он платный (от $50 в год). Для некоммерческого использования или когда каждый доллар на счету, FileBrowser Quantum имеет явное преимущество.

Администрирование и управление

Управление пользователями

FileBrowser Quantum предоставляет несколько способов управления пользователями:

Локальные учётные записи: Администратор создаёт пользователей через веб-интерфейс или CLI. Можно установить начальный пароль, который пользователь изменит при первом входе.

OIDC автоматическое создание: При первом входе через OIDC пользователь автоматически создаётся в системе с информацией из провайдера идентификации.

Управление ролями: Пользователи могут быть администраторами (полный доступ) или обычными пользователями (ограниченный доступ).

Область видимости (Scope)

Каждый пользователь имеет область видимости — директорию, выше которой он не может подняться. Это критически важно для многопользовательских систем. Например:

• Администратор: scope = /
• Пользователь1: scope = /home/user1
• Пользователь2: scope = /home/user2

Пользователи не могут видеть друг друга папки и не могут случайно (или намеренно) удалить чужие файлы.

Логирование и аудит

Все действия пользователей логируются в файле логов. Администраторы могут просмотреть историю: кто и когда загрузил/скачал/удалил/переименовал файлы. Это важно для соответствия нормативным требованиям (GDPR, HIPAA и т.д.).

Расшаривание файлов

FileBrowser Quantum позволяет создавать публичные ссылки на файлы и директории. При создании ссылки можно установить:

• Срок действия: Постоянная ссылка, или действующая N дней/часов
• Пароль: Дополнительная защита (опционально)
• Пермиссии: Только просмотр, или также загрузка/редактирование
• Ограничение по IP: Ссылка работает только с определённых IP адресов

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

API и автоматизация

REST API

FileBrowser Quantum предоставляет полный REST API для автоматизации. API документирована через Swagger UI, доступный по адресу /swagger на вашем сервере.

Основные эндпоинты:

• GET /api/v1/fs/list?path=/ — получить список файлов в директории
• POST /api/v1/fs/upload — загрузить файл
• DELETE /api/v1/fs?path=/file — удалить файл
• GET /api/v1/fs/download?path=/file — скачать файл
• POST /api/v1/share — создать расшариваемую ссылку
• GET /api/v1/users — получить список пользователей
• POST /api/v1/auth/login — получить токен для аутентификации

Примеры использования

Загрузка файла через curl:

bash
curl -X POST \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -F "path=/uploads" \
  -F "file=@/path/to/local/file.txt" \
  http://your-server/api/v1/fs/upload

Получение списка файлов через Python:

python
import requests

headers = {"X-Auth-Token": "YOUR_API_TOKEN"}
response = requests.get(
    "http://your-server/api/v1/fs/list?path=/",
    headers=headers
)
files = response.json()
for file in files:
    print(f"{file['name']} - {file['size']} bytes")

Автоматическое резервное копирование:

bash
#!/bin/bash
# Backup important files daily at 2 AM

TIMESTAMP=$(date +%Y%m%d_%H%M%S)
curl -X POST \
  -H "X-Auth-Token: $API_TOKEN" \
  -F "path=/backups/$TIMESTAMP" \
  -F "file=@/important/data/database.sql" \
  http://localhost:8080/api/v1/fs/upload

Генерирование API токенов

Токены создаются через веб-интерфейс (Profile → API Tokens) или через CLI:

bash./filebrowser_linux_amd64 -c config.yaml users create --admin api-user --password apipass

API токены могут иметь ограниченный срок действия и необходимые пермиссии, что даёт вам гибкость в управлении доступом.

Безопасность в глубину

Защита данных в покое (Data at Rest)

Файлы хранятся на файловой системе Linux со стандартными пермиссиями. FileBrowser Quantum соблюдает эти пермиссии. Если вам нужна дополнительная защита:

• Используйте шифрование файловой системы (LUKS на Linux)
• Используйте SELinux для дополнительного контроля доступа

Защита данных в пути (Data in Transit)

Все подключения к FileBrowser Quantum должны быть защищены SSL/TLS. Используйте обратный прокси (Nginx, Traefik) с Let’s Encrypt сертификатом для автоматического HTTPS.

Пример конфигурации Nginx:

text
server {
    listen 443 ssl http2;
    server_name files.example.com;

    ssl_certificate /etc/letsencrypt/live/files.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/files.example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Защита от атак

Защита от CSRF: FileBrowser Quantum автоматически проверяет CSRF токены.

Защита от XSS: Весь пользовательский ввод экранируется перед выводом.

Защита от SQL injection: Квант не использует SQL (это Go приложение с собственной базой данных), поэтому SQL injection невозможна.

Защита от переполнения буфера: Go автоматически управляет памятью и защищает от утечек.

Защита от brute-force: Можно интегрировать с fail2ban для блокировки IP после нескольких неудачных попыток входа.

Пример конфигурации fail2ban:

bash
sudo apt install fail2ban
sudo systemctl enable fail2ban

# Создать фильтр в /etc/fail2ban/filter.d/filebrowser.conf
[Definition]
failregex = ^<HOST>.*"POST /api/v1/auth/login HTTP/1.1" 401
ignoreregex =

# Создать jail в /etc/fail2ban/jail.d/filebrowser.conf
[filebrowser]
enabled = true
port = http,https
filter = filebrowser
logpath = /var/log/nginx/access.log
maxretry = 5
findtime = 10m
bantime = 1h

Оптимизация производительности

Кэширование

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

Индексирование больших директорий

При первом запуске с большой директорией (миллионы файлов), индексирование может занять время. Вы можете настроить параметры индексирования в config.yaml:

text
indexing:
  enabled: true
  caseSensitive: false
  ignorePatterns:
    - ".*"  # Игнорировать скрытые файлы
    - "node_modules"
    - ".git"
  batchSize: 1000
  debounceTime: "100ms"

Масштабирование

Если вам нужно обслуживать тысячи одновременных пользователей:

• Запустите несколько экземпляров FileBrowser Quantum за балансировщиком нагрузки
• Используйте распределённое хранилище (S3, NFS) для файлов
• Кэшируйте метаданные в Redis

Пример docker-compose с масштабированием:

text
version: '3'
services:
  lb:
    image: nginx:alpine
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - filebrowser1
      - filebrowser2
      - filebrowser3

  filebrowser1:
    image: gtstef/filebrowser:latest
    volumes:
      - shared-files:/srv
      - ./config:/config
  
  filebrowser2:
    image: gtstef/filebrowser:latest
    volumes:
      - shared-files:/srv
      - ./config:/config
  
  filebrowser3:
    image: gtstef/filebrowser:latest
    volumes:
      - shared-files:/srv
      - ./config:/config

volumes:
  shared-files:
    driver: local
    driver_opts:
      type: nfs
      o: addr=192.168.1.100,vers=4,soft,timeo=180,bg,tcp,rw
      device: ":/export/files"

Интеграция с другими системами

Интеграция с Syncthing

FileBrowser Quantum идеально дополняется Syncthing — децентрализованной системой синхронизации файлов. Вы можете синхронизировать директории между несколькими компьютерами через Syncthing, а затем получать доступ ко всем синхронизированным файлам через FileBrowser Quantum.

Интеграция с Immich (photo management)

Если у вас установлен Immich для управления фотографиями, вы можете подключить его хранилище как источник в FileBrowser Quantum для доступа к исходным файлам.

Интеграция с Jellyfin (media server)

FileBrowser Quantum может предоставить интерфейс для загрузки медиа-контента в медиа-сервер Jellyfin.

Интеграция с 1С или другими ERP системами

Через API, скрипты могут автоматически загружать документы из 1С в FileBrowser Quantum для архивирования и совместного доступа.

Решение проблем и диагностика

Проблема: «Empty preview screen» при открытии документов в OnlyOffice

Причина: OnlyOffice не может достичь сервер FileBrowser Quantum или неправильно сконфигурирован URL.

Решение:

1. Проверьте, что OnlyOffice контейнер может достичь Quantum контейнер: docker exec onlyoffice curl http://filebrowser:80
2. Проверьте логи OnlyOffice: docker logs onlyoffice
3. Убедитесь, что integrations.office.internalUrl в config.yaml указывает на правильный адрес (для Docker — имя сервиса)

Проблема: Медленный поиск в большой директории

Причина: Индексирование не завершено или игнорируются большие поддиректории.

Решение:

1. Проверьте статус индексирования в логах
2. Исключите ненужные директории из индексирования через ignorePatterns
3. Расширьте debounceTime для менее частых обновлений индекса
4. Перезагрузите приложение для перестроения индекса: переименуйте database файл

Проблема: «401 Unauthorized» при использовании API

Причина: API токен неправильный, истёк или не передан.

Решение:

1. Проверьте, что токен передан в заголовке: X-Auth-Token: YOUR_TOKEN
2. Проверьте в веб-интерфейсе, что токен активен
3. Создайте новый токен если нужно

Проблема: Высокое использование памяти при индексировании больших хранилищ

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

Решение:

1. Разбейте большое хранилище на несколько источников меньшего размера
2. Используйте более мощный сервер с большим объёмом оперативной памяти
3. Оптимизируйте ignorePatterns для исключения временных и ненужных файлов

Roadmap и будущее развития

На момент написания этой статьи (январь 2026), FileBrowser Quantum активно разрабатывается. В планах разработчика:

• Поддержка Collabora Online как альтернатива OnlyOffice
• Плагинная архитектура для расширения функциональности
• Мобильное приложение для iOS и Android
• Шифрование end-to-end для особо чувствительных данных
• Поддержка WebDAV сервера (размещение Quantum позади WebDAV протокола)
• Синхронизация в реальном времени между несколькими экземплярами Quantum

Проект находится на этапе между бета и стабильным релизом. Разработчик обещает стабильный v1.0 в 2026 году.

Выводы: Почему FileBrowser Quantum?

FileBrowser Quantum представляет собой идеальный баланс между простотой и функциональностью. Он не претендует быть полнофункциональной облачной платформой вроде Nextcloud, но в своей нише — управление файлами — он превосходит конкурентов по эффективности и удобству.

Ключевые преимущества:

1. Минималистичный, но мощный: Всё, что вам нужно для управления файлами, ничего лишнего
2. Быстрая установка: От нуля до работающей системы за 5 минут
3. Низкие требования к ресурсам: Работает даже на старом оборудовании
4. Безопасность первична: OIDC, 2FA, контроль доступа
5. Интеграция OnlyOffice: Редактирование документов прямо в браузере
6. Активная разработка: Регулярные обновления и улучшения
7. Открытый исходный код: Вы видите, что происходит с вашими данными
8. Бесплатно: Apache 2.0 лицензия, без скрытых платежей

Если вы администратор Linux, IT специалист, или просто человек, который ценит контроль над своими данными — FileBrowser Quantum достоин вашего внимания.

Практический чек-лист для развертывания

Если вы решили развернуть FileBrowser Quantum с OnlyOffice, используйте этот чек-лист:

Подготовка

•  Выбран сервер (облачный VPS, домашний сервер, NAS)
•  ОС установлена и обновлена (Ubuntu 22.04 LTS рекомендуется)
•  Docker и Docker Compose установлены
•  Зарезервировано хранилище для файлов
•  Зарезервировано место для базы данных Quantum и кэша OnlyOffice

Конфигурирование

•  Создан docker-compose.yaml с обоими сервисами
•  Получен JWT секрет от OnlyOffice
•  Создан config.yaml для Quantum с правильными настройками
•  Установлены SSL сертификаты (Let’s Encrypt)
•  Настроен обратный прокси (Nginx или Traefik)

Развертывание

•  Контейнеры запущены успешно
•  Quantum доступен по HTTPS
•  OnlyOffice доступен (внутренне для Quantum)
•  Создан администраторский аккаунт
•  Создано несколько тестовых пользователей

Тестирование

•  Вход администратором работает
•  Вход обычным пользователем работает
•  Загрузка файлов работает
•  Скачивание файлов работает
•  Просмотр файлов работает
•  Редактирование в OnlyOffice работает
•  Создание расшариваемых ссылок работает
•  API токены работают

Оптимизация

•  Настроены резервные копии (database и файлы)
•  Настроено логирование
•  Оптимизированы настройки индексирования
•  Настроена система мониторинга (опционально)
•  Документированы пароли в защищённом месте

Производство

•  Настроена 2FA для администраторских аккаунтов
•  Интегрирована OIDC (если требуется)
•  Настроены расходы на интернет-трафик (если применимо)
•  Обучены пользователи
•  Документация для пользователей подготовлена
•  Процедура резервного копирования автоматизирована
•  План восстановления при аварии разработан

Заключение

FileBrowser Quantum и OnlyOffice вместе составляют мощную систему для самостоятельного хостинга, которая соответствует потребностям современных организаций и частных пользователей. Эта комбинация предоставляет надёжную альтернативу коммерческим облачным сервисам, с полным контролем над данными, высокой безопасностью и минимальными требованиями к ресурсам.

Независимо от того, являетесь ли вы IT специалистом, администратором компании или просто пользователем, который хочет контролировать собственные файлы — FileBrowser Quantum готов помочь вам создать надёжную, быструю и безопасную систему управления данными. С его простотой развертывания, мощной функциональностью и активной разработкой, это инструмент, за которым будущее в мире самостоятельного хостинга.

Развертывайте сегодня, и освобождайтесь от зависимости от облачных гигантов завтра.