Перейти к содержимому

Статья 126 из 141

Гайды

File Browser на VPS: веб-файловый менеджер в Docker, пароль администратора и безопасная настройка

File Browser — веб-интерфейс для файлов на сервере. Через браузер можно загружать и скачивать файлы, создавать папки, править текстовые файлы и делиться ссылками. Удобно, чтобы отдать файлы коллеге, выложить архив или поправить конфиг без SSH-клиента.

Статья проверена на версии 2.63.23 (ноябрь 2026).

Статус проекта. Разработчики заархивировали File Browser 1 сентября 2026 года. Версия 2.63.23 последняя: новых релизов и исправлений безопасности не будет. Известные уязвимости опубликованы в security advisories проекта. Сами авторы советуют не открывать File Browser в интернет без дополнительной авторизации перед ним. Ставьте его, только если готовы закрыть доступ так, как описано ниже.

Ресурс Минимум
RAM 128 МБ свободной памяти
vCPU 1
Диск место под ваши файлы
ПО Docker и Docker Compose

File Browser показывает содержимое одной папки сервера. Не давайте ему весь диск: создайте отдельный каталог с файлами для веб-доступа.

Окно терминала
mkdir -p /opt/filebrowser/{srv,database,config}
cd /opt/filebrowser
chown -R 1000:1000 srv database config

Контейнер работает от пользователя с UID и GID 1000. Docker не меняет владельца подключённых папок, поэтому chown обязателен, иначе File Browser не сможет записать базу и файлы.

Окно терминала
nano compose.yaml
services:
filebrowser:
image: filebrowser/filebrowser
restart: unless-stopped
ports:
- "127.0.0.1:8080:80"
volumes:
- ./srv:/srv
- ./database:/database
- ./config:/config
Путь в контейнере Что там
/srv файлы, которые видно в интерфейсе
/database база filebrowser.db с пользователями и настройками
/config settings.json: порт, корень, путь к базе
Окно терминала
docker compose up -d

Пароля по умолчанию нет. При первом запуске File Browser создаёт пользователя admin со случайным паролем и выводит его в лог один раз:

Окно терминала
docker compose logs filebrowser | grep password
User 'admin' initialized with randomly generated password: СЛУЧАЙНЫЙ_ПАРОЛЬ

Сохраните пароль сразу. Если лог пропал или пароль потерян, сбросьте его из командной строки. Контейнер нужно остановить, иначе база занята:

Окно терминала
docker compose stop
docker compose run --rm filebrowser users update admin --password 'ДЛИННЫЙ_ПАРОЛЬ'
docker compose start

Минимальная длина пароля по умолчанию 12 символов. Регистрация новых пользователей выключена, выполнение команд на сервере (Exec) тоже выключено. Так и оставьте.

Панель слушает только 127.0.0.1. До настройки домена откройте её через SSH-туннель с вашего компьютера:

Окно терминала
ssh -L 8080:127.0.0.1:8080 root@IP_СЕРВЕРА

и зайдите на http://localhost:8080. Форма входа сама переключается на русский по языку браузера.

Форма входа File Browser

После входа интерфейс администратора может быть на английском. Язык меняется в Settings → Profile Settings → Language (после выбора нажмите Update).

Список файлов в File Browser

Основные действия:

  • Новый каталог и Новый файл в меню слева.
  • Загрузка через кнопку со стрелкой вверх или перетаскиванием файлов в окно.
  • Клик по файлу выделяет его. Вверху появляются кнопки: поделиться, переименовать, копировать, переместить, удалить, скачать.
  • Текстовые файлы открываются во встроенном редакторе.

У каждого пользователя есть Область (scope): папка внутри /srv, выше которой он не поднимется.

  1. Откройте Настройки → Управление пользователями и нажмите Новый.
  2. Задайте Имя пользователя, Пароль и Область, например /site. Пользователь увидит только содержимое /opt/filebrowser/srv/site.
  3. В Права доступа оставьте только нужное: создание, удаление, скачивание, редактирование, переименование, ссылки. Галочку Администратор не ставьте.
  4. Нажмите Сохранить. File Browser попросит ввести ваш пароль, чтобы подтвердить действие.

Создание пользователя с ограниченной областью /site

Проверено: пользователь с областью /site видит только файлы этой папки, а не весь /srv.

  1. Выделите файл или папку и нажмите кнопку Поделиться вверху.
  2. В поле Время расшаренной ссылки задайте срок жизни (секунды, минуты, часы, дни). Значение 0 создаёт постоянную ссылку.
  3. При желании задайте Необязательный пароль.
  4. Нажмите Поделиться и скопируйте ссылку вида https://files.example.com/share/AbCd1234.

Окно создания ссылки: срок и необязательный пароль

Ссылка открывается без входа в File Browser. Все активные ссылки видны и удаляются в Настройки → Управление расшаренными ссылками. Ставьте срок и удаляйте ссылки, когда они больше не нужны.

File Browser хранит сессии в токенах, которые нельзя отозвать. Выход из аккаунта и смена пароля не делают старый токен недействительным до конца его срока. Поэтому поставьте перед ним Nginx с HTTPS и ограничьте доступ по IP.

Конфиг /etc/nginx/sites-available/filebrowser:

server {
listen 80;
server_name files.example.com;
client_max_body_size 2G;
location / {
allow 203.0.113.10;
deny all;
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
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;
}
}

Замените 203.0.113.10 на ваш IP. client_max_body_size ограничивает размер загружаемого файла. Учтите, что ограничение по IP действует и на ссылки из раздела выше: они откроются только с разрешённых адресов.

Окно терминала
ln -s /etc/nginx/sites-available/filebrowser /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d files.example.com

Подробнее: Nginx, Let’s Encrypt, DNS. Если IP у вас меняется, вместо allow используйте HTTP Basic Auth или VPN, например WireGuard.

  • Порт 8080 только на 127.0.0.1. В файрволе оставьте 22, 80 и 443.
  • Подключайте в /srv одну рабочую папку, не / и не /root.
  • Не включайте выполнение команд (Exec): у этой функции много известных уязвимостей.
  • Не входите в File Browser с чужих компьютеров: смена пароля не отзывает уже выданный токен.
  • Подумайте о замене на поддерживаемое решение, например Nextcloud, если нужен доступ к файлам из интернета для многих людей.

Сохраняйте базу и настройки, а файлы из srv по вашим правилам:

Окно терминала
cd /opt/filebrowser
docker compose stop
tar -czf /root/filebrowser-$(date +%F).tar.gz database config
docker compose start

Храните копии вне сервера: бэкапы.

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

Окно терминала
docker compose pull && docker compose up -d
Симптом Причина и решение
Контейнер перезапускается, в логе ошибка доступа к базе Папки не принадлежат UID 1000. Выполните chown -R 1000:1000 srv database config
Не помню пароль admin Сбросьте командой users update admin --password при остановленном контейнере
Пароль не принимается при создании пользователя Короче 12 символов
Большой файл не загружается через домен Увеличьте client_max_body_size в Nginx
Пользователь видит чужие папки Не задана Область или стоит галочка Администратор
Ссылка открывает 403 у внешнего человека Его IP не входит в allow в Nginx. Передайте файл другим способом или добавьте адрес