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-доступом.

Начать сейчас →