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

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

У світі, де обсяг інформації зростає експоненціально, ефективне керування документами стає не просто зручністю, а необхідністю. Від невеликих команд до великих підприємств, потреба в надійному та доступному сховищі для файлів, з можливістю спільної роботи та суворим контролем доступу, залишається незмінною. Docmost — це сучасне open-source рішення, розроблене для цих цілей. Однак, щоб розкрити весь його потенціал, особливо в контексті безпеки, продуктивності та масштабованості, оптимальним вибором стає встановлення Docmost на власний Virtual Private Server (VPS).

Використання Docmost на VPS надає унікальні переваги порівняно з хмарними сервісами: ви повністю володієте своїми даними, контролюєте інфраструктуру та можете налаштувати систему точно під свої потреби, уникаючи прив'язки до провайдера та щомісячних платежів за кожен гігабайт або користувача. У цій статті ми детально розглянемо, що таке Docmost, як його встановити та налаштувати на VPS за допомогою Docker, забезпечити безпеку з HTTPS та підтримувати його в актуальному стані.

Що таке Docmost і чому його варто використовувати на VPS?

Docmost — це сучасна система керування документами (DMS), розроблена для організації, зберігання та спільної роботи з файлами. Вона пропонує інтуїтивно зрозумілий інтерфейс та багатий набір функцій, покликаних спростити роботу з документами в будь-якій організації або для особистого використання. На відміну від багатьох пропрієтарних рішень, Docmost є проєктом з відкритим вихідним кодом, що дає користувачам свободу модифікації та аудиту.

Основні можливості Docmost

Централізоване зберігання: Усі документи знаходяться в одному місці, що спрощує пошук та доступ.
Керування версіями: Відстеження змін та можливість повернення до попередніх версій документа.
Повнотекстовий пошук: Швидкий пошук за вмістом документів.
Контроль доступу: Гнучка система дозволів для користувачів та груп, що дозволяє точно налаштувати, хто може переглядати, редагувати або видаляти документи.
Спільна робота: Можливість спільного редагування та коментування документів.
Інтеграції: Підтримка інтеграції з іншими сервісами та системами.
Безпека: Шифрування даних, аудит дій користувачів.
Підтримка різних форматів: Робота з PDF, DOCX, XLSX, ODT та багатьма іншими.

Переваги self-hosted рішення на VPS

Вибір Docmost self-hosted на VPS від Valebyte.com дає низку критично важливих переваг:

Повний контроль над даними: Ваші документи зберігаються на сервері, який ви контролюєте. Це означає повну відповідність вимогам конфіденційності та регуляторам, особливо важливим для компаній, що працюють з чутливою інформацією.
Висока продуктивність: Ви не ділите ресурси з тисячами інших користувачів. Ваш VPS виділений спеціально для ваших потреб, що гарантує стабільну та швидку роботу Docmost, навіть при високих навантаженнях.
Гнучкість налаштування: На VPS ви можете встановити будь-яке додаткове ПЗ, налаштувати файрвол, резервне копіювання та моніторинг точно так, як вам потрібно. Це дозволяє оптимізувати систему під унікальні вимоги вашого робочого процесу.
Економічна вигода: У довгостроковій перспективі, володіння власним сервером може бути значно дешевше, ніж підписка на хмарні DMS, особливо для зростаючих команд з великим обсягом даних або великою кількістю користувачів.
Незалежність від провайдера: Ви не прив'язані до умов та змін політики сторонніх хмарних сервісів. Ви самі вирішуєте, коли і як оновлювати систему.
Масштабованість: У міру зростання ваших потреб, ви легко можете оновити ресурси VPS (RAM, CPU, дисковий простір) без міграції даних або складної перенастроювання.

Docmost на сервері, керованому вами, стає не просто DMS, а частиною вашої контрольованої цифрової інфраструктури, забезпечуючи спокій та ефективність.

Системні вимоги Docmost: який VPS обрати?

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

Мінімальні вимоги для Docmost

Для тестового встановлення або для дуже невеликої кількості користувачів (1-2 особи) з мінімальним обсягом документів, Docmost може запуститися на скромних ресурсах:

Процесор: 1 vCPU з частотою від 2 GHz.
Оперативна пам'ять (RAM): 2 GB.
Дисковий простір: 20-30 GB NVMe/SSD. Docmost зберігатиме базу даних, файли та Docker-образи. NVMe або SSD значно прискорять роботу з файлами та базою даних.
Операційна система: Ubuntu 22.04 LTS, Debian 11/12 або інша сучасна Linux-система.
Docker та Docker Compose: Для розгортання Docmost.

Ці мінімальні вимоги достатні для ознайомлення з Docmost, але для продуктивної роботи вони швидко стануть вузьким місцем.

Підготовка VPS до встановлення Docmost

Перш ніж приступити до розгортання Docmost, необхідно підготувати ваш VPS. Цей етап включає оновлення системи, встановлення Docker та Docker Compose, а також створення необхідної структури директорій.

Оновлення системи та встановлення Docker

Першим кроком завжди має бути оновлення вашої операційної системи. Це гарантує, що у вас встановлені всі останні виправлення безпеки та пакети.

sudo apt update && sudo apt upgrade -y

Потім встановимо Docker. Рекомендується використовувати офіційний установочний скрипт Docker, щоб отримати найсвіжішу версію:

sudo apt install ca-certificates curl gnupg lsb-release -y
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

Після встановлення додайте вашого користувача до групи docker, щоб запускати команди Docker без sudo (потрібно буде перелогінітися):

sudo usermod -aG docker $USER

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

docker --version
docker compose version

Ви повинні побачити версії Docker та Docker Compose.

Створення користувача та директорій

Для кращої організації та безпеки рекомендується створити окремого користувача для запуску Docmost та відповідну структуру директорій.

sudo adduser docmostuser
sudo usermod -aG docker docmostuser
sudo mkdir -p /opt/docmost
sudo chown -R docmostuser:docmostuser /opt/docmost

Переключіться на нового користувача:

su - docmostuser

Створіть директорії для даних Docmost. Docmost зберігає свої дані в кількох місцях: для конфігурації, для бази даних та для завантажених файлів. Ми створимо їх всередині /opt/docmost:

mkdir -p /opt/docmost/data/db
mkdir -p /opt/docmost/data/files
mkdir -p /opt/docmost/config

Переконайтеся, що користувач docmostuser має права на ці директорії.

Тепер ваш VPS готовий до встановлення Docmost з використанням Docker Compose.

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

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

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

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

Покрокове встановлення Docmost на VPS за допомогою Docker Compose

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

Файл docker-compose.yml для Docmost

Створіть файл docker-compose.yml у директорії /opt/docmost (якщо ви зараз під docmostuser, то в /home/docmostuser/docmost або де ви вирішили зберігати конфігурацію). Для простоти будемо використовувати шлях /opt/docmost.

cd /opt/docmost
nano docker-compose.yml

Вставте наступний вміст. Цей файл визначає три основні сервіси: Docmost (основний застосунок), PostgreSQL (база даних) та Redis (для кешування та черг).

version: '3.8'

services:
  db:
    image: postgres:15-alpine
    restart: always
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmostuser
      POSTGRES_PASSWORD: your_strong_db_password # <-- ОБОВ'ЯЗКОВО ЗМІНІТЬ ЦЕ
    volumes:
      - ./data/db:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U docmostuser -d docmost"]
      interval: 10s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7-alpine
    restart: always
    volumes:
      - ./data/redis:/data

  docmost:
    image: docmost/docmost:latest
    restart: always
    environment:
      DATABASE_URL: postgresql://docmostuser:your_strong_db_password@db:5432/docmost # <-- ОБОВ'ЯЗКОВО ЗМІНІТЬ ЦЕ
      REDIS_URL: redis://redis:6379/0
      DOCMOST_SECRET_KEY: your_super_secret_key # <-- ОБОВ'ЯЗКОВО ЗМІНІТЬ ЦЕ, ГЕНЕРУЙТЕ ВИПАДКОВИЙ РЯДОК
      DOCMOST_MEDIA_ROOT: /app/media
      DOCMOST_STATIC_ROOT: /app/static
      # DOCMOST_ALLOW_REGISTRATION: "false" # Розкоментуйте, щоб вимкнути реєстрацію нових користувачів
      # DOCMOST_EMAIL_HOST: smtp.yourprovider.com
      # DOCMOST_EMAIL_PORT: 587
      # DOCMOST_EMAIL_USE_TLS: "true"
      # DOCMOST_EMAIL_HOST_USER: [email protected]
      # DOCMOST_EMAIL_HOST_PASSWORD: your_email_password
      # DOCMOST_DEFAULT_FROM_EMAIL: [email protected]
    volumes:
      - ./data/files:/app/media
      - ./config:/app/config # Для додаткових файлів конфігурації Docmost
    ports:
      - "8000:8000" # Порт Docmost, можна змінити, якщо 8000 зайнятий
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started

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

your_strong_db_password: ОБОВ'ЯЗКОВО замініть на складний, унікальний пароль для бази даних. Він має бути однаковим у секціях db та docmost.
your_super_secret_key: ОБОВ'ЯЗКОВО згенеруйте унікальний секретний ключ. Це можна зробити, наприклад, командою python3 -c 'import os; print(os.urandom(32).hex())'. Цей ключ використовується для криптографічних операцій Docmost.
ports: "8000:8000": Перший порт — це порт на хост-машині (VPS), другий — порт всередині контейнера Docmost. Ви можете змінити хост-порт, наприклад, на "8080:8000", якщо 8000 зайнятий.
volumes: Визначають, де дані зберігатимуться на вашому VPS. Ми використовуємо відносні шляхи ./data/db, ./data/files, ./data/redis, які будуть створені всередині /opt/docmost.
DOCMOST_ALLOW_REGISTRATION: За замовчуванням увімкнено. Якщо ви хочете, щоб лише адміністратор міг створювати користувачів, розкоментуйте та встановіть "false".
Налаштування пошти: Розкоментуйте та налаштуйте секцію DOCMOST_EMAIL_*, якщо Docmost має надсилати сповіщення електронною поштою.

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

Запуск та первинне налаштування Docmost

Після створення docker-compose.yml можна запустити Docmost Docker контейнери:

docker compose up -d

Команда -d запускає контейнери у фоновому режимі. Перше завантаження може зайняти деякий час, оскільки Docker завантажуватиме образи.

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

docker compose ps

Усі сервіси мають бути у стані running. Якщо у вас виникли проблеми, ви можете переглянути логи:

docker compose logs docmost

Після успішного запуску Docmost буде доступний за IP-адресою вашого VPS та портом 8000 (наприклад, http://ВАШ_IP_VPS:8000). Відкрийте цю адресу в браузері.

При першому вході вам потрібно буде створити обліковий запис адміністратора. Заповніть форму реєстрації, і ви станете першим користувачем та адміністратором системи Docmost.

Тепер, коли Docmost на сервері запущено, наступним кроком буде забезпечення безпечного доступу через доменне ім'я та HTTPS.

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

Прямий доступ до Docmost через IP-адресу та порт 8000 не є безпечним або зручним для продуктивного середовища. Необхідно налаштувати reverse proxy (зворотний проксі-сервер) та забезпечити шифрування трафіку за допомогою HTTPS. Ми розглянемо налаштування Nginx, як одного з найпопулярніших рішень.

Для цього вам знадобиться:

Зареєстрований домен або піддомен (наприклад, docs.yourdomain.com), що вказує на IP-адресу вашого VPS.
Відкриті порти 80 (HTTP) та 443 (HTTPS) на вашому VPS.

Налаштування Nginx як reverse proxy

Спочатку встановіть Nginx на ваш VPS (якщо він ще не встановлений):

sudo apt install nginx -y

Створіть файл конфігурації для вашого домену. Припустимо, ви хочете, щоб Docmost був доступний за адресою docs.valebyte.com. Створіть файл /etc/nginx/sites-available/docs.valebyte.com:

sudo nano /etc/nginx/sites-available/docs.valebyte.com

Вставте наступний вміст, замінивши docs.valebyte.com на ваш реальний домен:

server {
    listen 80;
    server_name docs.valebyte.com;

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl http2;
    server_name docs.valebyte.com;

    ssl_certificate /etc/letsencrypt/live/docs.valebyte.com/fullchain.pem; # Буде створено Certbot
    ssl_certificate_key /etc/letsencrypt/live/docs.valebyte.com/privkey.pem; # Буде створено Certbot
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384";
    ssl_prefer_server_ciphers on;

    location / {
        proxy_pass http://localhost:8000; # Або інший порт, якщо ви змінювали в docker-compose.yml
        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_buffering off;
        proxy_request_buffering off;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Збережіть файл. Потім створіть символічне посилання на цей файл у директорії sites-enabled та видаліть конфігурацію за замовчуванням:

sudo ln -s /etc/nginx/sites-available/docs.valebyte.com /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default

Перевірте синтаксис Nginx:

sudo nginx -t

Якщо все в порядку, перезапустіть Nginx:

sudo systemctl restart nginx

Автоматичне отримання SSL-сертифікатів з Let's Encrypt

Для HTTPS нам потрібен SSL-сертифікат. Let's Encrypt надає безкоштовні сертифікати, які можна легко отримати за допомогою Certbot.

sudo apt install certbot python3-certbot-nginx -y

Запустіть Certbot для отримання сертифіката для вашого домену:

sudo certbot --nginx -d docs.valebyte.com

Certbot автоматично визначить вашу конфігурацію Nginx, отримає сертифікат та налаштує Nginx для використання HTTPS. Він також додасть завдання до cron для автоматичного продовження сертифіката. Дотримуйтесь інструкцій Certbot (зазвичай достатньо вибрати "Redirect" для перенаправлення HTTP на HTTPS).

Тепер ваш Docmost на VPS має бути доступний за адресою https://docs.valebyte.com (замініть на ваш домен) з безпечним HTTPS-з'єднанням.

Обслуговування Docmost: резервне копіювання, оновлення та моніторинг

Підтримка Docmost self-hosted в актуальному та робочому стані вимагає регулярного обслуговування, включаючи створення резервних копій, своєчасні оновлення та моніторинг продуктивності. Ці кроки критично важливі для забезпечення стабільності та безпеки вашої системи.

Стратегії резервного копіювання Docmost

Резервне копіювання — це найважливіший аспект обслуговування будь-якої системи. Для Docmost необхідно робити резервні копії двох основних компонентів: бази даних PostgreSQL та директорії з файлами.

1. Резервне копіювання бази даних PostgreSQL:

Виконайте команду з кореневої директорії /opt/docmost (або де знаходиться ваш docker-compose.yml) під користувачем docmostuser:

docker compose exec db pg_dump -U docmostuser docmost > ./backups/docmost_db_$(date +%Y%m%d_%H%M%S).sql

Ця команда виконає дамп бази даних та збереже його в директорію ./backups. Переконайтеся, що ця директорія існує: mkdir -p /opt/docmost/backups.

2. Резервне копіювання файлів Docmost:

Просто скопіюйте директорію data/files, яка містить усі завантажені користувачами документи:

tar -czvf ./backups/docmost_files_$(date +%Y%m%d_%H%M%S).tar.gz ./data/files

Автоматизація резервного копіювання:

Для автоматизації створіть скрипт backup.sh:

#!/bin/bash
BACKUP_DIR="/opt/docmost/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)

mkdir -p $BACKUP_DIR

echo "Створення резервної копії бази даних..."
docker compose -f /opt/docmost/docker-compose.yml exec db pg_dump -U docmostuser docmost > "$BACKUP_DIR/docmost_db_$TIMESTAMP.sql"

echo "Створення резервної копії файлів..."
tar -czvf "$BACKUP_DIR/docmost_files_$TIMESTAMP.tar.gz" -C /opt/docmost data/files

echo "Видалення старих резервних копій (старших за 7 днів)..."
find $BACKUP_DIR -type f -name "docmost_db_*.sql" -mtime +7 -delete
find $BACKUP_DIR -type f -name "docmost_files_*.tar.gz" -mtime +7 -delete

echo "Резервне копіювання завершено."

Зробіть скрипт виконуваним: chmod +x /opt/docmost/backup.sh. Потім додайте його до cron для щоденного виконання (наприклад, о 3:00 ночі):

crontab -e

Додайте рядок:

0 3 * * * /opt/docmost/backup.sh >> /var/log/docmost_backup.log 2>&1

Важливо: Зберігайте резервні копії не тільки на VPS, але й на віддаленому сховищі. Для цього можна використовувати rsync, SCP або спеціалізовані інструменти на кшталт Restic.

Оновлення Docmost через Docker

Оновлення Docmost через Docker Compose дуже просте. Рекомендується регулярно перевіряти наявність нових версій образу Docmost.

cd /opt/docmost
docker compose pull # Завантажує останні версії образів
docker compose down # Зупиняє та видаляє поточні контейнери
docker compose up -d # Запускає нові контейнери з оновленими образами

Перед оновленням завжди бажано зробити резервну копію, як описано вище.

Моніторинг продуктивності Docmost на сервері

Моніторинг ресурсів вашого VPS допоможе вчасно виявити проблеми з продуктивністю або нестачу ресурсів. Відстежуйте наступні метрики:

Завантаження CPU: Високе завантаження може вказувати на інтенсивну індексацію або велику кількість активних користувачів.
Використання RAM: Якщо Docmost або база даних споживають занадто багато пам'яті, це може призвести до уповільнення роботи або збоїв.
Використання диска: Переконайтеся, що у вас достатньо вільного місця, особливо якщо очікується зростання обсягу документів.
I/O диска: Висока активність читання/запису може вказувати на вузьке місце в дисковій підсистемі.
Мережевий трафік: Моніторинг вхідного/вихідного трафіку допоможе зрозуміти інтенсивність використання Docmost.

Для моніторингу можна використовувати утиліти командного рядка (htop, iotop, df -h) або встановити спеціалізовані системи моніторингу, такі як Netdata, які надають зручні дашборди та сповіщення.

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

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

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

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

Оптимальна конфігурація VPS для Docmost під реальне навантаження

Вибір правильної конфігурації VPS для Docmost на VPS критично важливий для забезпечення стабільної роботи та масштабованості. Нижче представлена таблиця з рекомендаціями щодо вибору VPS-конфігурації залежно від передбачуваного навантаження.

Таблиця порівняння VPS-конфігурацій для Docmost

Сценарій використання	vCPU	RAM	Диск (NVMe/SSD)	Пропускна здатність	Орієнтовна вартість Valebyte.com
Особисте використання / Тест (1-2 користувачі, <1000 док.)	1 ядро (2+ GHz)	2 GB	50 GB NVMe	100 Mbit/s	Від $5/міс
Мала команда (3-5 користувачів, 1000-5000 док.)	2 ядра (2.5+ GHz)	4 GB	100 GB NVMe	200 Mbit/s	Від $10/міс
Середня команда (5-15 користувачів, 5000-20000 док.)	4 ядра (2.5+ GHz)	8 GB	200 GB NVMe	500 Mbit/s	Від $20/міс
Велика команда / Відділ (15-30 користувачів, 20000+ док.)	6 ядер (2.8+ GHz)	16 GB	400 GB NVMe	1 Gbit/s	Від $40/міс
Enterprise / Високе навантаження (30+ користувачів, >50000 док.)	8+ ядер (3+ GHz)	32+ GB	800+ GB NVMe	1 Gbit/s	Від $80/міс

Важливі зауваження:

NVMe-диски: Пріоритет завжди має надаватися NVMe або, як мінімум, SSD-дискам. Швидкість дискової підсистеми є одним з ключових факторів продуктивності для DMS, особливо при повнотекстовому пошуку та роботі з великими файлами.
Масштабованість: Почніть з конфігурації, яка відповідає вашим поточним потребам, але завжди майте на увазі можливість швидкого апгрейду ресурсів VPS у міру зростання навантаження.
Резервне копіювання: Обов'язково враховуйте місце для резервних копій при плануванні дискового простору, або налаштуйте зовнішнє сховище для резервних копій.

Висновки

Docmost на VPS — це потужне та гнучке рішення для керування документами, що надає повний контроль над вашими даними та інфраструктурою. Дотримуючись наведених інструкцій щодо встановлення Docmost з використанням Docker Compose, налаштування reverse proxy та HTTPS, а також регулярного обслуговування, ви зможете створити надійну та безпечну систему для вашої команди. Вибір відповідної конфігурації VPS від Valebyte.com забезпечить оптимальну продуктивність та масштабованість для ваших потреб.

Готові обрати сервер?

VPS та виділені сервери в 72+ країнах з миттєвою активацією та повним root-доступом.

Почати зараз →