Filebrowser на VPS: встановлення, налаштування та обслуговування

Filebrowser на VPS — це зручний і легкий веб-застосунок для керування файлами, який дозволяє отримати доступ до ваших даних через браузер з будь-якого пристрою, і для його встановлення на віртуальний сервер оптимально використовувати Docker-контейнери, що значно спрощує розгортання та обслуговування, перетворюючи ваш віртуальний сервер на персональне хмарне сховище або файловий сервер для невеликої команди.

Що таке Filebrowser і чому він ідеальний для VPS?

Filebrowser являє собою мінімалістичний, але потужний файловий менеджер з веб-інтерфейсом, написаний на Go. Він дозволяє з легкістю керувати файлами та папками на вашому сервері через будь-який веб-браузер, надаючи функціональність завантаження, скачування, перейменування, видалення, створення папок і навіть попереднього перегляду медіафайлів. Завдяки своїй легкості та низькому споживанню ресурсів, Filebrowser на VPS є чудовим рішенням для тих, хто шукає простий та ефективний спосіб організації доступу до файлів без необхідності розгортати складні та ресурсоємні хмарні платформи, такі як Nextcloud або Owncloud.

Переваги Filebrowser:

Легкість та швидкість: Розроблений на Go, що забезпечує високу продуктивність та мінімальне споживання системних ресурсів. Це критично важливо для VPS з обмеженими потужностями.
Простота встановлення та налаштування: Особливо при використанні Docker, встановлення Filebrowser займає лічені хвилини.
Кросплатформність: Працює на більшості операційних систем (Linux, Windows, macOS, BSD).
Безпека: Підтримка автентифікації користувачів, можливість обмеження доступу до певних директорій, інтеграція з HTTPS.
Розширюваність: Підтримка кількох користувачів, можливість створення публічних посилань для обміну файлами, кастомізація інтерфейсу.
Керування версіями: Інтеграція з Git для відстеження змін у файлах (опціонально).
Самостійний хостинг (self-hosted): Ви повністю контролюєте свої дані, що є ключовою перевагою порівняно з комерційними хмарними сервісами. Це робить Filebrowser self-hosted привабливим вибором для тих, хто цінує приватність та суверенітет над своїми даними.

Сценарії використання Filebrowser на сервері

Filebrowser на сервері може бути застосований у найрізноманітніших сценаріях:

Персональне хмарне сховище: Замініть Google Drive або Dropbox на власне рішення, де ви повністю контролюєте дані.
Файловий сервер для невеликої команди: Надайте співробітникам зручний доступ до спільних документів та ресурсів.
Керування медіафайлами: Зберігайте та переглядайте фотографії, відео, музику прямо через браузер.
Доступ до файлів для веб-розробників: Зручний спосіб завантажувати та редагувати файли на веб-сервері.
Обмін файлами: Створюйте тимчасові посилання для швидкої передачі великих файлів без використання сторонніх сервісів.
Резервне копіювання та синхронізація: Хоча Filebrowser сам по собі не є рішенням для бекапу, він може слугувати зручним інтерфейсом для доступу до даних, які були синхронізовані за допомогою інших інструментів, таких як Syncthing на VPS або Seafile на VPS.

Системні вимоги для Filebrowser

Filebrowser відрізняється своєю скромністю у споживанні ресурсів, що робить його ідеальним кандидатом для розгортання навіть на найбюджетніших VPS-тарифах. Однак, кінцеві вимоги залежатимуть від передбачуваного навантаження та обсягу збережених даних.

Мінімальні вимоги для одного користувача або невеликого проєкту

Для одного користувача або невеликого проєкту з рідкісним доступом до файлів (наприклад, для особистої хмари або файлообмінника):

Процесор: 1 vCPU (віртуальне ядро). Сучасні процесори з тактовою частотою від 2.0 GHz будуть більш ніж достатніми.
Оперативна пам'ять (RAM): 512 MB. Сам Filebrowser споживає близько 20-50 MB RAM у режимі очікування. Решта знадобиться для операційної системи та кешування файлів.
Дисковий простір: 10-20 GB NVMe SSD. NVMe диски значно прискорюють операції з файлами, що критично для будь-якого файлового сервера. Обсяг диска, звичайно, залежить від того, скільки даних ви плануєте зберігати.
Операційна система: Ubuntu 20.04+, Debian 11+, CentOS 8+ або будь-який інший дистрибутив Linux, що підтримує Docker.
Мережа: Стабільне інтернет-з'єднання, мінімальна швидкість 100 Mbps.

Покрокове встановлення Filebrowser на VPS з використанням Docker

Найпростіший і рекомендований спосіб встановлення Filebrowser на ваш VPS — це використання Docker та Docker Compose. Цей підхід забезпечує ізоляцію застосунку, простоту оновлення та переносимість.

Підготовка VPS: Встановлення Docker та Docker Compose

Перш ніж приступити до розгортання Filebrowser, необхідно встановити Docker та Docker Compose на ваш сервер. Приклади команд наведені для Ubuntu/Debian.

1. Оновлення системи

Завжди починайте з оновлення пакетного менеджера та встановлених пакетів:

sudo apt update
sudo apt upgrade -y

2. Встановлення Docker Engine

Встановіть необхідні пакети для Docker:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y

Додайте офіційний GPG ключ Docker:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Додайте репозиторій Docker:

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Оновіть список пакетів та встановіть Docker Engine:

sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io -y

Додайте поточного користувача до групи docker, щоб уникнути використання sudo при кожній команді Docker (перезавантаження сесії або вихід/вхід може знадобитися):

sudo usermod -aG docker $USER

Перевірте встановлення Docker:

docker --version
docker run hello-world

3. Встановлення Docker Compose

Завантажте останню стабільну версію Docker Compose (перевірте актуальну версію на GitHub-репозиторії Docker Compose):

sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.5/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Зробіть файл виконуваним:

sudo chmod +x /usr/local/bin/docker-compose

Перевірте встановлення Docker Compose:

docker-compose --version

Для детальнішого посібника по роботі з Docker на VPS ви можете ознайомитися з іншими нашими статтями, наприклад, про те, як розгорнути Gitea на VPS або PocketBase на VPS, які також використовують Docker.

Розгортання Filebrowser через Docker Compose

Створіть директорію для Filebrowser та перейдіть до неї:

mkdir ~/filebrowser
cd ~/filebrowser

Створіть файл docker-compose.yml:

nano docker-compose.yml

Вставте наступний вміст:

version: '3.8'

services:
  filebrowser:
    image: filebrowser/filebrowser:latest
    container_name: filebrowser
    restart: unless-stopped
    ports:
      - "8080:80" # Зовнішній порт 8080, внутрішній 80. Можете змінити 8080 на будь-який вільний.
    volumes:
      - ./data:/data # Тут зберігатимуться файли Filebrowser (налаштування, база даних користувачів)
      - /path/to/your/files:/srv # Тут будуть ваші файли, якими ви хочете керувати через Filebrowser
      # Приклад: - /home/user/my_documents:/srv/documents
      # Приклад: - /mnt/external_drive:/srv/shared
    environment:
      # Налаштування Filebrowser (опціонально)
      # FB_BASEURL: "/files" # Якщо ви використовуєте reverse proxy і хочете, щоб Filebrowser був доступний за підшляхом
      # FB_NOAUTH: "true" # Вимкнути автентифікацію (НЕ РЕКОМЕНДУЄТЬСЯ для публічного доступу)
      # FB_LOGLEVEL: "debug" # Рівень логування
      PUID: "1000" # User ID, під яким працюватиме Filebrowser (для коректних прав доступу до файлів)
      PGID: "1000" # Group ID, під яким працюватиме Filebrowser
      TZ: "Europe/Moscow" # Встановіть свій часовий пояс

Важливі моменти:

Замініть /path/to/your/files на актуальний шлях до директорії на вашому VPS, де зберігаються файли, якими ви хочете керувати. Ви можете додати кілька рядків - /шлях/на/хості:/шлях/у/контейнері для монтування кількох директорій.
PUID та PGID: Ці змінні визначають User ID та Group ID, під якими Filebrowser запускатиметься всередині контейнера. Щоб Filebrowser мав коректні права на читання та запис ваших файлів, ці ID повинні відповідати ID користувача, якому належать ваші файли на хост-системі. Ви можете дізнатися свої PUID та PGID, виконавши команду id $USER на вашому VPS. Зазвичай для першого користувача це 1000.
ports: - "8080:80": Filebrowser за замовчуванням слухає порт 80 всередині контейнера. Ми мапимо його на порт 8080 на вашому хост-VPS. Ви можете змінити 8080 на будь-який інший вільний порт.
./data:/data: Це монтування збереже конфігурацію Filebrowser (користувачів, налаштування) у піддиректорії data в поточній директорії на вашому VPS. Це дуже важливо для збереження даних після перезапуску контейнера.

Збережіть файл (Ctrl+O, Enter, Ctrl+X).

Запустіть контейнер:

docker-compose up -d

Опція -d означає запуск у фоновому режимі (detached mode).

Перевірте статус контейнера:

docker-compose ps

Тепер Filebrowser має бути доступний за адресою http://ВАШ_IP_VPS:8080. При першому запуску вам буде запропоновано створити облікові дані адміністратора. Логін за замовчуванням: admin, пароль: admin. Обов'язково змініть їх одразу після входу!

rocket_launch Швидкий вибір

Шукаєте сервер, який просто працює?

Valebyte VPS — NVMe, підтримка 24/7, розгортання за 60 секунд.

Переглянути тарифи VPS arrow_forward

Налаштування Reverse Proxy (Nginx/Caddy) та HTTPS

Прямий доступ до Filebrowser за IP-адресою та портом 8080 не є оптимальним рішенням для production-середовища. Для забезпечення безпеки, використання доменного імені та шифрування трафіку (HTTPS) рекомендується налаштувати зворотний проксі-сервер (Reverse Proxy). Ми розглянемо два популярні варіанти: Nginx та Caddy.

1. Налаштування Reverse Proxy з Nginx та Let's Encrypt (Certbot)

Nginx — це потужний і широко використовуваний веб-сервер, який чудово підходить для роботи як зворотний проксі.

1.1. Встановлення Nginx

sudo apt install nginx -y

1.2. Налаштування доменного імені

Переконайтеся, що ваш домен (наприклад, files.yourdomain.com) вказує на IP-адресу вашого VPS у DNS-записах (A-запис).

1.3. Створення конфігураційного файлу Nginx для Filebrowser

Створіть новий файл конфігурації для вашого домену:

sudo nano /etc/nginx/sites-available/filebrowser.conf

Вставте наступний вміст (замініть files.yourdomain.com на ваш домен):

server {
    listen 80;
    listen [::]:80;
    server_name files.yourdomain.com;

    location / {
        proxy_pass http://localhost:8080; # Або IP_VPS:8080, якщо Filebrowser запущено не на локальному хості
        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;
        proxy_redirect off;
    }
}

Збережіть файл.

1.4. Активація конфігурації та перевірка синтаксису

sudo ln -s /etc/nginx/sites-available/filebrowser.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

1.5. Встановлення Certbot та отримання SSL-сертифіката (HTTPS)

Certbot від Let's Encrypt дозволяє отримати безкоштовні SSL-сертифікати. Встановіть Certbot:

sudo apt install certbot python3-certbot-nginx -y

Отримайте сертифікат для вашого домену:

sudo certbot --nginx -d files.yourdomain.com

Дотримуйтесь інструкцій Certbot. Він автоматично змінить конфігурацію Nginx для використання HTTPS. Після успішного виконання ваш Filebrowser буде доступний за адресою https://files.yourdomain.com.

2. Налаштування Reverse Proxy з Caddy

Caddy — це сучасний веб-сервер з автоматичною підтримкою HTTPS, що значно спрощує налаштування.

2.1. Встановлення Caddy

Додайте ключ GPG:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

Додайте репозиторій Caddy:

curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list

Оновіть список пакетів та встановіть Caddy:

sudo apt update
sudo apt install caddy -y

2.2. Налаштування доменного імені

Як і для Nginx, переконайтеся, що ваш домен (наприклад, files.yourdomain.com) вказує на IP-адресу вашого VPS.

2.3. Створення конфігураційного файлу Caddyfile

Створіть або відредагуйте основний конфігураційний файл Caddy:

sudo nano /etc/caddy/Caddyfile

Видаліть або закоментуйте наявний вміст і додайте наступне (замініть files.yourdomain.com на ваш домен):

files.yourdomain.com {
    reverse_proxy localhost:8080 # Або IP_VPS:8080
}

Збережіть файл.

2.4. Перезапуск Caddy

sudo systemctl restart caddy
sudo systemctl enable caddy

Caddy автоматично отримає та налаштує SSL-сертифікат для вашого домену. Ваш Filebrowser буде доступний за адресою https://files.yourdomain.com.

Бекапи та оновлення Filebrowser на VPS

Регулярні бекапи та своєчасні оновлення — ключ до стабільної та безпечної роботи будь-якого застосунку, особливо Filebrowser на сервері, де зберігаються важливі дані.

Резервне копіювання (Бекапи)

У контексті Filebrowser, бекап включає в себе дві основні частини: дані самого Filebrowser (користувачі, налаштування) та файли, якими Filebrowser керує.

1. Бекап даних Filebrowser (конфігурація та база даних)

Якщо ви дотримувалися нашої інструкції по Docker Compose, дані Filebrowser зберігаються в директорії ./data відносно вашого docker-compose.yml. Для бекапу цієї директорії достатньо скопіювати її:

cd ~/filebrowser # Перейдіть до директорії з docker-compose.yml
sudo tar -czvf filebrowser_config_$(date +%Y%m%d%H%M%S).tar.gz data/

Це створить стиснутий архів .tar.gz з вашою конфігурацією. Рекомендується зберігати ці бекапи на окремому сховищі, не на тому ж VPS.

2. Бекап керованих файлів

Файли, які ви керуєте через Filebrowser, знаходяться в директоріях, які ви змонтували в контейнер (наприклад, /path/to/your/files). Методи бекапу цих файлів можуть бути різними:

rsync: Використовуйте rsync для інкрементального копіювання файлів на віддалений сервер або в локальну резервну директорію.
Хмарні сховища: Якщо обсяг даних великий, розгляньте синхронізацію з S3-сумісним сховищем або іншими хмарними сервісами за допомогою таких інструментів, як rclone.
Знімки файлової системи (Snapshots): Багато провайдерів VPS, включаючи Valebyte, пропонують можливість створення знімків (снапшотів) вашого VPS. Це найпростіший спосіб створити повну резервну копію всієї системи, включаючи Filebrowser та всі його дані. Рекомендується робити знімки перед великими оновленнями або змінами.

Рекомендація: Налаштуйте автоматичне створення бекапів за допомогою cron. Наприклад, для щоденного бекапу конфігурації:

# Відкрийте crontab для редагування
crontab -e

# Додайте наступний рядок для щоденного бекапу о 03:00 ранку
0 3 * * * cd /root/filebrowser && tar -czvf /var/backups/filebrowser_config_$(date +\%Y\%m\%d).tar.gz data/ && find /var/backups -name "filebrowser_config_*.tar.gz" -mtime +7 -delete

Ця команда буде щодня створювати бекап конфігурації та видаляти бекапи старші 7 днів.

Оновлення Filebrowser

Оновлення Filebrowser Docker-контейнера — це простий процес:

Зупиніть поточний контейнер:
```
cd ~/filebrowser
docker-compose down
```
Отримайте нову версію образу:
```
docker-compose pull filebrowser
```
Запустіть контейнер з новим образом:
```
docker-compose up -d
```

Ваші дані (користувачі, налаштування) збережуться, оскільки вони знаходяться в змонтованому томі ./data, який не видаляється при зупинці контейнера.

Оновлення операційної системи та Docker

Не забувайте регулярно оновлювати операційну систему вашого VPS та сам Docker Engine. Це забезпечує актуальність патчів безпеки та стабільність роботи:

sudo apt update
sudo apt upgrade -y
sudo systemctl restart docker

Вибір VPS-конфігурації для реального навантаження з Filebrowser

Правильний вибір VPS є ключовим для забезпечення стабільної та продуктивної роботи Filebrowser. Valebyte.com пропонує широкий спектр VPS-тарифів, які можуть бути адаптовані під різні сценарії використання Filebrowser.

Визначення навантаження та вибір тарифу

Навантаження на Filebrowser в основному визначається наступними факторами:

Кількість одночасно активних користувачів: Чим більше користувачів одночасно завантажують або скачують файли, тим вище навантаження на процесор, пам'ять і особливо дискову підсистему.
Обсяг та розмір файлів: Робота з великою кількістю дрібних файлів або дуже великими файлами (наприклад, відео) вимагає більше ресурсів.
Інтенсивність операцій: Часті операції читання/запису, індексування або пошук за файлами.
Додаткові сервіси: Якщо на тому ж VPS запущено інші застосунки (наприклад, веб-сервер, база даних, моніторинг типу Netdata на VPS), це збільшує загальні вимоги до ресурсів.

Сценарій використання	vCPU	RAM	Диск (NVMe SSD)	Пропускна здатність мережі	Орієнтовна вартість/місяць*	Оптимально для
Персональна хмара / Тестування	1	1 GB	25 GB	100 Mbps	від $5	1-2 користувачі, легкі файли, нечастий доступ. Ідеально для ознайомлення з Filebrowser self-hosted.
Мала команда / Документообіг	2	2 GB	50 GB	500 Mbps	від $10	3-7 користувачів, середній обсяг документів та зображень, періодичний доступ.
Середня команда / Медіа-хостинг	2-4	4 GB	100-200 GB	1 Gbps	від $20	8-15 користувачів, великі файли (відео, архіви), частий доступ, можливі інші фонові завдання.
Великий проєкт / Високе навантаження	4-8	8-16 GB	200 GB+	1 Gbps+	від $40	15+ користувачів, інтенсивні операції з файлами, критично важливі дані, можливо, з інтеграцією з іншими сервісами.

Важливі міркування при виборі VPS

Тип диска: Завжди вибирайте VPS з NVMe SSD. Різниця в продуктивності зі звичайними SATA SSD або HDD величезна, особливо для файлових операцій.
Розташування сервера: Вибирайте дата-центр, який географічно ближче до ваших основних користувачів для мінімізації затримок (latency).
Канал зв'язку: Переконайтеся, що провайдер пропонує достатню пропускну здатність мережі. Для файлового сервера швидкість інтернету критична.
Масштабованість: Вибирайте провайдера, який дозволяє легко масштабувати ресурси (CPU, RAM, Disk) вашого VPS у міру зростання потреб.
Підтримка: Наявність оперативної та кваліфікованої технічної підтримки може бути вирішальним при виникненні проблем.

Для більш загального розуміння вибору сервера, ви можете прочитати нашу статтю Що таке сервер і дедик: Повний посібник для початківців.