SSD Nodes Learn Hosting plans →
Руководства Matt ConnorАвтор: Matt Connor · Обновлено 2026-10-17

Обзор self-hosted файловых менеджеров для сервера

Сравнение FileBrowser, Filestash, SFTPGo и Cloud Commander по поддержке протоколов, авторизации и безопасности. Узнайте, как безопасно настроить доступ к файлам на VPS.

Что такое self-hosted файловый менеджер и чем он не является

Self-hosted файловый менеджер — это веб-интерфейс для дерева каталогов, которое уже существует на вашем VPS (виртуальном выделенном сервере). Вы авторизуетесь, видите /srv/files в том же виде, в каком они хранятся на диске, и можете загружать, переименовывать, скачивать файлы или передавать кому-либо ссылку на них. Никакие данные не копируются во вторую систему, поэтому файл, который вы загрузили через браузер, будет виден в ls уже через секунду.

Результаты поиска часто смешивают это понятие с программами для других задач. Инструменты синхронизации хранят копию каждого файла на каждом устройстве — именно для этого предназначена self-hosted альтернатива Dropbox. Объектное хранилище строится вокруг бакетов и API, а не вокруг каталога на вашем диске, поэтому запуск MinIO для S3-совместимого объектного хранилища решает другую задачу. Панели администрирования сервера управляют самой машиной, а не файлами, и это относится к сравнению Cockpit и Webmin.

Файловый менеджер нужен, когда коллеге требуется скачать с сервера архив объемом 300 MB или когда вы хотите исправить опечатку в конфигурационном файле с телефона. Задача проста, и инструменты для неё тоже.

Учитывайте один факт при чтении. Это веб-приложение с доступом на чтение и запись к вашей файловой системе, которое слушает порт. Каждый вариант ниже — это, по сути, выбор того, к какой части вашего диска этот процесс получит доступ.

Проект FileBrowser переведен в архив, ознакомьтесь с этим перед установкой

FileBrowser, проект filebrowser/filebrowser, остается решением, которое предлагают большинство руководств. Его README теперь начинается с уведомления:

Проект File Browser переведен в архив 2026-09-01. Последний запланированный релиз уже выпущен. Дальнейших релизов, исправлений ошибок или обновлений безопасности не будет.

Код под лицензией Apache 2.0 продолжит работать. Обновления безопасности прекращены. Для данной категории ПО это критично, так как основная задача программы — предоставление доступа на запись к файловой системе по протоколу HTTP.

Разработчики описали рекомендации по дальнейшему использованию, и им стоит следовать при выборе любого аналогичного инструмента: не открывайте доступ к приложению напрямую из интернета, размещайте его за reverse proxy, который выполняет TLS termination (transport layer security) и собственную аутентификацию, держите функцию выполнения команд (command runner) отключенной и запускайте приложение с ограниченными правами в контейнере, подключив только ту директорию, которую необходимо обслуживать.

Одна строка в этом README важнее остальных. Сессии представляют собой автономные JWT (JSON web tokens), а не идентификаторы на стороне сервера, поэтому их невозможно отозвать. Утекший токен сессии остается валидным до истечения срока действия, и смена пароля не аннулирует его. Если вы продолжаете использовать FileBrowser, именно внешний уровень аутентификации берет на себя основную задачу по обеспечению безопасности.

FileBrowser Quantum: форк, который продолжает развиваться

Активная разработка перешла в форк FileBrowser Quantum (gtsteffaniak/filebrowser), который публикуется как образ gtstef/filebrowser на Docker Hub и как ghcr.io/gtsteffaniak/filebrowser в реестре GitHub. В нем конфигурация перестроена вокруг единого файла config.yaml вместо прежнего сочетания флагов командной строки и настроек базы данных. Документированный способ быстрого запуска:

docker run -d \
  -v $(pwd):/srv \
  -p 80:80 \
  ghcr.io/gtsteffaniak/filebrowser:stable

Эта команда открывает текущую директорию по адресу http://localhost. Начиная с версии 2.0.0, учетные данные для первого входа больше не admin / admin: если вы не задали adminPassword в конфигурации, отличный от admin, контейнер генерирует случайный пароль администратора, выводит его в лог один раз (прочитать его можно через docker logs) и требует смены пароля при первом входе. Выполните смену пароля до того, как контейнер станет доступен извне, кроме как с вашей локальной машины.

Для постоянного экземпляра используйте Compose, монтируйте директорию с данными, а не отдельный файл базы данных, и привязывайте порт к localhost:

services:
  filebrowser:
    image: gtstef/filebrowser:stable
    user: "1000:1000"
    volumes:
      - /srv/files:/folder
      - ./data:/home/filebrowser/data
    ports:
      - 127.0.0.1:8080:80
    restart: unless-stopped

Конфигурация находится в /home/filebrowser/data/config.yaml, а база данных — в /home/filebrowser/data/database.sqlite. В версии 2.0.0 формат базы данных был изменен и выполняется однократная миграция, поэтому документация требует монтирования директории: при монтировании одного файла миграции некуда сохранить новый файл. Пути внутри config.yaml — это пути внутри контейнера, поэтому источник в конфигурации должен быть указан как /folder, а не /srv/files. Ошибка в этом приведет к пустому списку файлов без сообщений об ошибках, так как директория фактически отсутствует.

Проект публикует latest и stable размером около 60 МБ с включенными FFmpeg и предпросмотром документов, а также stable-slim размером около 15 МБ, содержащий только ядро. Это показатели со страницы установки на октябрь 2026 года. Фиксируйте выбранный тег. latest меняется без уведомления, а файловый менеджер, меняющий формат конфигурации в работающем контейнере, — это плохой сценарий для начала дня.

Для этой задачи это самый мощный из компактных инструментов. Он обслуживает несколько источников с правилами включения и исключения, поэтому один экземпляр может предоставлять доступ к /srv/media и /srv/docs с разными областями видимости. Общие ссылки имеют время истечения и могут быть анонимными или ограниченными для конкретного пользователя. Аутентификация поддерживает OIDC (OpenID Connect), LDAP (lightweight directory access protocol), пароль с двухфакторной аутентификацией и режим прокси-заголовков. Этот режим прокси позволяет разместить сервис за единой системой входа (SSO) от собственного сервера Authentik вместо ведения отдельного списка пользователей.

Filestash: единый интерфейс для уже имеющегося хранилища

Filestash имеет иную архитектуру. Это фронтенд, который подключается к бэкенду, причем список поддерживаемых бэкендов обширен: FTP, SFTP (SSH file transfer protocol), S3, SMB, WebDAV, IPFS и еще около двадцати других. Это решение подходит, если файлы находятся не на том сервере, где запущен интерфейс.

mkdir -p /srv/filestash && cd /srv/filestash
curl -O https://downloads.filestash.app/latest/docker-compose.yml
docker compose up -d

Образ называется machines/filestash:latest. Откройте http://your_domain:8334, и на первом экране потребуется задать пароль администратора. Установите его немедленно, так как до этого момента консоль администратора доступна любому, кто обнаружит порт.

Разберитесь в модели идентификации, прежде чем строить на ней свою систему. По умолчанию Filestash не хранит базу данных пользователей в привычном понимании. Учетные данные сохраняются в вашем браузере с помощью файлов cookie, которые зашифрованы, аутентифицированы и доступны только по протоколу HTTP. На стороне сервера ничего не сохраняется, если вы не используете функцию общего доступа (share) — в этом случае Filestash хранит постоянную зашифрованную версию ваших учетных данных. В такой конфигурации по умолчанию «пользователи» — это учетные записи хранилищ: идентификация происходит на стороне бэкенда, в учетной записи SFTP или ключе S3, а не в Filestash. Это не единственный вариант. Плагин plg_authenticate_local, который поставляется в составе репозитория с открытым исходным кодом, позволяет Filestash самому выступать в роли провайдера идентификации с экраном для управления пользователями.

Такой дизайн архитектуры лаконичен, но имеет свою цену. На странице с тарифами указано, что бесплатная self-hosted версия распространяется по лицензии AGPL v3 (GNU Affero General Public License) и поддерживает до 3 пользователей, а SSO (SAML, OIDC и LDAP) с управлением доступом на основе ролей (RBAC) доступно в платной self-hosted версии по цене от 50 долларов в месяц по состоянию на октябрь 2026 года. Если ваш план заключался в использовании Filestash поверх корпоративного SSO на бесплатной основе, проверьте эту страницу, прежде чем проектировать систему вокруг этого решения.

SFTPGo: сервер протоколов с веб-интерфейсом

SFTPGo — наиболее функциональное решение в этом обзоре, которое часто рекомендуют по неверным причинам. Оно поддерживает SFTP, HTTP/S, FTP/S и WebDAV, работая с локальными файловыми системами (в том числе зашифрованными), S3-совместимыми объектными хранилищами, Google Cloud Storage, Azure Blob Storage или другими SFTP-серверами.

Бинарные файлы, пакеты для Debian и Ubuntu, а также образ контейнера доступны для загрузки. Актуальная строка для APT-репозитория и ключ подписи находятся на странице установки в документации SFTPGo. Использование контейнера — самый быстрый способ запуска; замените tag на нужную версию:

docker run --name some-sftpgo -p 8080:8080 -p 2022:2022 -d "drakkan/sftpgo:tag"

SFTP слушает порт 2022, а веб-интерфейсы — 8080. Подключите /srv/sftpgo как том (volume), иначе учетные записи и файлы исчезнут при пересоздании контейнера, так как домашние директории пользователей по умолчанию находятся в /srv/sftpgo/data/<username>.

Существует два веб-интерфейса, и разница между ними — это то, что часто упускают в обзорах. WebAdmin, доступный по адресу /web/admin, предназначен для администрирования: здесь создаются пользователи, группы, виртуальные папки и правила событий, а также настраиваются квоты, лимиты пропускной способности и ограничения по времени доступа. WebClient, доступный по адресу /web/client, предназначен для конечных пользователей: здесь можно просматривать файлы, изменять свои учетные данные, настраивать двухфакторную аутентификацию и создавать общие ссылки (shares).

Эти общие ссылки — лучшие в данном сравнении. Пользователь может создавать HTTP/S-ссылки для доступа к файлам и папкам, ограничивать количество загрузок и выгрузок, защищать ссылку паролем, ограничивать доступ по IP-адресу источника и устанавливать дату автоматического истечения срока действия.

Почему же стоит проявлять осторожность? Основной фокус системы — модель учетных записей и сервер протоколов, а не удобство просмотра файлов. Выбирайте SFTPGo, если другим пользователям нужны полноценные учетные записи с квотами, если данные загружаются по SFTP или FTPS из систем, которые вы не контролируете, или если один бакет должен отображаться в домашних директориях нескольких пользователей. Виртуальные папки решают последнюю задачу: папка, размещенная на локальном диске, S3, GCS, Azure Blob, SFTP или HTTP, монтируется в несколько учетных записей с индивидуальной квотой для каждого пользователя на общую папку. Если вам нужна просто страница для просмотра файлов через /srv/files, это решение будет избыточным.

Еще два факта, которые стоит знать. Community-версия распространяется по лицензии AGPL-3.0 с дополнительными условиями; также существует коммерческая Enterprise-версия. В открытой сборке доступен вход через OIDC, который сопоставляет пользователей провайдера идентификации с администраторами и пользователями SFTPGo для обоих веб-интерфейсов. Вы также можете глобально отключить клиентский интерфейс с помощью параметра enable_web_client в конфигурационном файле httpd или для конкретного пользователя, добавив HTTP в список запрещенных протоколов этого пользователя. Таким образом, файловый менеджер может быть доступен одному человеку, но не всем остальным.

Cloud Commander: две панели и консоль для одного пользователя

Cloud Commander — это файловый менеджер на Node.js с лицензией MIT, выполненный в двухпанельном стиле, со встроенным редактором и консолью. Терминал доступен как опция, но по умолчанию он отключен и не установлен: для его работы требуется отдельный пакет gritty (npm i gritty -g), а также параметры --terminal и --terminal-path. Установите Cloud Commander глобально с помощью npm i cloudcmd -g или запустите готовый контейнер:

docker run -it --rm -v ~:/root -v /:/mnt/fs -w=/root -p 8000:8000 coderaiser/cloudcmd

Прочитайте эту команду перед запуском. -v /:/mnt/fs монтирует всю файловую систему хоста в контейнер, а пример ~/.cloudcmd.json поставляет "root": "/", "auth": false и "console": true. Такая комбинация означает, что любой, кто получит доступ к порту 8000, получит доступ ко всему вашему диску и командной консоли на сервере. Это разумное решение для ноутбука, но опасное для VPS.

Ограничьте область доступа. Контейнер считывает /root/.cloudcmd.json, который опубликованная команда предоставляет путем монтирования вашей домашней директории, поэтому оставьте монтирование конфигурации, а остальное уберите:

docker run -d --name cloudcmd \
  -v ~/.cloudcmd.json:/root/.cloudcmd.json \
  -v /srv/files:/srv/files \
  -w=/srv/files \
  -p 127.0.0.1:8000:8000 \
  coderaiser/cloudcmd

В этом файле конфигурации установите "root" в /srv/files, "auth" в true с использованием "username" и "password" (файл хранит пароль в виде хеша, а не в открытом виде), а "console" в false, если вам действительно не нужен доступ к оболочке через браузер. Оставьте "terminal" со значением по умолчанию false и пропустите установку gritty по той же причине. Существуют также эквиваленты для командной строки, включая --root, --auth, --username, --password и --prefix.

Будьте реалистичны в отношении того, что это за инструмент. Одна пара учетных данных, отсутствие разграничения прав пользователей, квот и ссылок для общего доступа. Это персональный инструмент, поэтому привяжите его к localhost, как показано выше, и подключайтесь через туннель:

ssh -L 8000:127.0.0.1:8000 you@your-vps

Затем откройте http://127.0.0.1:8000 на своем компьютере. Файловый менеджер никогда не выставляется в публичный доступ, и единственное, что смотрит в интернет — это SSH-демон, который вы уже защитили на своем VPS.

Почему Nextcloud не подходит для этой задачи

Nextcloud — качественное ПО, но оно предназначено для других целей. Это платформа для совместной работы: PHP-приложение, база данных, фоновые задания, клиенты для синхронизации и магазин приложений. Использование его только для просмотра /srv/files через веб-интерфейс — это избыточное количество компонентов для простой задачи, и здесь возникает фундаментальное несоответствие. Nextcloud хранит метаданные файлов в таблице базы данных, а не считывает содержимое директории при каждом запросе. Поэтому файлы, записанные через rsync или cron-задание, могут оставаться невидимыми в интерфейсе до тех пор, пока не завершится сканирование, что сопровождается sudo -u www-data php occ files:scan --all. Обычный файловый менеджер просто считывает содержимое директории при загрузке страницы, поэтому такой задержки не существует.

Используйте Nextcloud для того, с чем он справляется хорошо: календари, контакты, синхронизация и обмен данными с пользователями, которым нужен десктопный клиент. В Nextcloud на VPS с Docker, TLS и резервным копированием описана настройка такого решения. Если вы уже используете Nextcloud и вам нужно лишь просматривать существующую директорию, включите приложение External Storage и на этом остановитесь. Второе веб-приложение с правами записи на тот же диск — это еще один компонент, который нужно обновлять и защищать.

Как запустить сервис, не предоставляя доступ ко всему серверу

Никогда не указывайте в качестве пути /. Процесс может читать и записывать всё, к чему имеет доступ его учетная запись, поэтому украденный токен сессии превращается в полный доступ к файловой системе. Обслуживайте только одну директорию, /srv/files, и создайте её специально для этой цели.

Запускайте процесс от имени пользователя без прав root и монтируйте только то, что необходимо. В Compose используйте user: "1000:1000" и по одному bind mount на каждую директорию, добавив :ro для всего, во что приложению не нужно записывать данные:

    volumes:
      - /srv/files:/folder
      - /srv/media:/media:ro

Обычно после этого изменения просмотр файлов работает, а загрузка завершается ошибкой permission denied, так как идентификатор пользователя внутри контейнера не является владельцем директории на хосте. Сравните их: docker exec filebrowser id выводит пользователя контейнера, а ls -ln /srv/files — числовой идентификатор владельца на хосте. Исправьте это с помощью sudo chown -R 1000:1000 /srv/files. Это та же проблема с правами владения, для решения которой существуют PUID и PGID в образах Docker.

Привязывайте опубликованный порт к localhost, 127.0.0.1:8080:80, а не к 8080:80. Docker записывает свои правила netfilter раньше правил ufw, поэтому открытый порт остается доступным из Интернета, даже если ufw deny 8080 активен. Установите reverse proxy перед приложением для TLS. При использовании обычного HTTP cookie сессии передается по сети в открытом виде, а этот cookie — это доступ к файловой системе. Если вы только начинаете работать с Compose, в Docker Compose на VPS описана структура файлов, на которую опираются эти примеры.

Добавьте уровень аутентификации, если встроенные средства приложения недостаточно надежны. HTTP basic auth на стороне прокси достаточно для экземпляра с одним пользователем. Если пользователей больше одного, используйте OIDC или forward auth через провайдера идентификации, чтобы отзыв одной учетной записи закрывал доступ везде.

Отключите лишние функции. Любой файловый менеджер, предлагающий оболочку (shell), выполнение команд или терминал в браузере, предоставляет возможность удаленного выполнения кода (RCE) любому, у кого есть валидная сессия. Рекомендация FileBrowser — держать функцию выполнения команд отключенной, а в примере конфигурации Cloud Commander консоль включена. Принимайте решение осознанно, а не по умолчанию.

Что ломается в первую очередь и какие ошибки вы увидите

listen tcp :80: bind: permission denied. Linux считает порты ниже 1024 привилегированными: для привязки к ним требуются права root, наличие capability CAP_NET_BIND_SERVICE или пониженное значение net.ipv4.ip_unprivileged_port_start. В документации FileBrowser Quantum указан порт 80. Обычно это работает внутри контейнера на стандартном rootful Docker, так как он предоставляет контейнеру необходимые права. Однако это не сработает, если запустить бинарный файл напрямую от имени непривилегированного пользователя на хосте, а также может вызвать сбои при использовании rootless Docker или при строгих профилях безопасности. Укажите порт выше 1024 в config.yaml, а обработку 443 порта оставьте за прокси-сервером.

Загрузка файлов не работает, хотя просмотр каталогов доступен. Для отображения содержимого каталога требуется r-x, а для записи в него — w. Веб-интерфейс выдает общую ошибку, поэтому в первую очередь проверяйте права доступа в файловой системе, а не логи приложения.

413 Request Entity Too Large. Эта ошибка обычно возникает из-за настроек компонента, стоящего перед файловым менеджером, а не из-за самого менеджера. Сначала проверьте Nginx. Значение client_max_body_size по умолчанию составляет 1 MB, поэтому прокси-сервер отклоняет загрузку файла большего размера до того, как запрос дойдет до приложения. Установите client_max_body_size 4096m; в блоке server или используйте 0, чтобы отключить проверку. Если домен проксируется через Cloudflare, он возвращает ту же ошибку 413, если запрос превышает максимальный размер загрузки для зоны (по состоянию на октябрь 2026 года для тарифов Free и Pro это 100 MB). Увеличение лимита в Nginx в этом случае не поможет, поэтому для больших файлов потребуется маршрут, который не проходит через прокси Cloudflare.

Загруженные файлы получают неверную группу. Новые файлы принадлежат пользователю, от имени которого запущен процесс, независимо от настроек родительского каталога, что мешает другим сервисам работать с этими файлами. Назначьте обоим сервисам общую группу и установите бит setgid на каталог с помощью sudo chmod g+s /srv/files, чтобы новые файлы наследовали группу каталога.

Все работает при прямом обращении к порту, но ломается за прокси. Если приложение обслуживается по подпути, оно формирует ссылки на основе префикса, о котором его нужно уведомить. В Cloud Commander для этого есть --prefix. Если такой опции нет, выделите приложению отдельный поддомен и проксируйте корневой путь.

Какой self-hosted файловый менеджер выбрать?

  • Один VPS, один или два каталога, обмен ссылками с истекающим сроком действия и, возможно, SSO в будущем: FileBrowser Quantum.
  • Файлы хранятся в другом месте (S3-бакет, SFTP-хост или NAS по SMB), и вам нужен единый веб-интерфейс для доступа к ним: Filestash, в рамках ограничений бесплатной версии.
  • Другим пользователям нужны учетные записи, квоты и загрузка файлов по SFTP или FTPS: SFTPGo, где веб-клиент рассматривается как полезное дополнение, а не основная причина выбора.
  • Персональный инструмент с редактором и консолью, доступный через SSH-туннель и никогда не публикуемый в сети: Cloud Commander.
  • Nextcloud уже запущен, и нужно открыть доступ к существующему каталогу: приложение External Storage, без установки нового ПО.

Что бы вы ни выбрали, способ развертывания важнее самого выбора. Один каталог, пользователь без прав root, порт, привязанный к localhost, и аутентификация перед приложением. Файловый менеджер, настроенный таким образом, — это удобство. То же самое ПО, направленное на / с общим паролем, превращается в удаленную оболочку с приятным интерфейсом.

FAQ

Безопасно ли использовать FileBrowser в 2026 году?

В README проекта filebrowser/filebrowser указано, что разработка File Browser прекращена 2026-09-01, новые релизы, исправления ошибок и обновления безопасности не выпускаются. Код продолжает работать, но использование ПО без обновлений, имеющего права на запись в файловую систему, со временем становится всё более рискованным. Если вы решили оставить его, следуйте рекомендациям проекта: не открывайте доступ напрямую в Интернет, используйте reverse proxy для TLS и собственной аутентификации, отключите функцию выполнения команд и запускайте приложение в непривилегированном контейнере, смонтировав только нужную директорию. Учтите, что сессии основаны на JWT, а не на серверных идентификаторах, поэтому их нельзя отозвать, а смена пароля не аннулирует уже выданные токены. Для новой установки используйте форк FileBrowser Quantum, доступный как образ gtstef/filebrowser, где разработка продолжается.

Может ли self-hosted файловый менеджер использовать существующую SSO?

FileBrowser Quantum поддерживает OIDC, LDAP и режим proxy header, поэтому его можно разместить за существующим провайдером идентификации без создания отдельной базы пользователей. Интеграция OpenID Connect в SFTPGo доступна в open source версии и позволяет сопоставлять пользователей провайдера с администраторами и пользователями SFTPGo для интерфейсов WebAdmin и WebClient. Исключение — Filestash: согласно странице с ценами, SSO (SAML, OIDC и LDAP) доступна только в платной self-hosted версии по цене от 50 долларов в месяц по состоянию на октябрь 2026 года, в то время как бесплатная версия распространяется по лицензии AGPL v3 и ограничена 3 пользователями. Если приложение не поддерживает SSO, используйте forward authentication на уровне reverse proxy: это защитит страницу входа, но не затронет внутренние права доступа в самом приложении.

В каком из этих решений есть ссылки на файлы с истекающим сроком действия?

Наиболее полная реализация представлена в SFTPGo. Пользователь может создать HTTP/S-ссылку через WebClient, ограничить количество скачиваний и загрузок, установить пароль, ограничить доступ по IP-адресу и задать дату автоматического истечения срока действия. FileBrowser Quantum поддерживает общие ссылки с ограничением по времени, доступ к которым может быть анонимным или привязанным к пользователю, с настройкой прав на просмотр, редактирование и загрузку для каждой ссылки. В Filestash также есть функция обмена файлами; это единственный случай, когда сервер хранит постоянную зашифрованную копию учетных данных хранилища, так как ссылка должна работать даже после завершения вашей сессии в браузере. В Cloud Commander функции общих ссылок отсутствуют.

Безопасно ли открывать доступ файловому менеджеру к корню системы (/), если я единственный пользователь?

Нет, и дело здесь не в доверии к самому себе. Процесс обладает правами на чтение и запись для всего, к чему имеет доступ учетная запись, от имени которой он запущен. Любой путь к этой сессии, украденный cookie, неисправленная уязвимость в обработчике загрузок или повторно использованный пароль дают злоумышленнику доступ к /etc, вашим SSH-ключам и директориям данных всех сервисов. Ограничьте монтирование одной директорией: /srv/files вместо /. С Cloud Commander это наиболее критично, так как в официальной команде Docker для него монтируется корень хоста в /mnt/fs, а в примере конфигурации задано "root": "/" с "auth": false. Измените эти параметры, прежде чем контейнер начнет принимать соединения на любом интерфейсе, кроме localhost.

Была ли эта статья полезной?

#file-manager#filebrowser#sftpgo#self-hosting#storage