Лучшие VPS для Paperless-ngx в 2026 году: RAM, диски и установка
Лучший VPS для Paperless-ngx должен выдерживать пики потребления памяти при OCR и вмещать как исходные сканы, так и обработанные копии. Paperless-ngx превращает документы в доступный для поиска архив с OCR, тегами и веб-интерфейсом. VPS сохраняет доступ к нему, когда домашний компьютер выключен, а вы управляете размещением и доступом.
Начните с измерений на характерной подборке файлов. Короткий текстовый PDF и скан на сто страниц в высоком разрешении по-разному нагружают CPU, память и диск. Параллелизм OCR важен не меньше количества документов. Для резервных копий нужна отдельная емкость вне сервера.
В этой статье сравниваются шесть провайдеров, рассматривается планирование RAM и дисков, а установка следует официальному варианту PostgreSQL с Docker Compose. Настройки OCR, автоматический импорт и восстановление из зашифрованных копий помогут выбрать конфигурацию с посильными расходами на обслуживание.
Цены и технические источники проверены 29 октября 2026 года. Последний подтвержденный стабильный выпуск: Paperless-ngx 3.3.4. Это сведения публичных каталогов, а не покупки серверов или тесты OCR. Проверьте регион, наличие, налоги и итоговую сумму заказа.
Лучшие VPS для Paperless-ngx: краткое сравнение
Рекомендованные планы рассчитаны на регулярный OCR примерно с 4GB RAM и выше. Более дешевые начальные тарифы рассматриваются отдельно; число CPU само по себе не определяет скорость распознавания.
| Провайдер | Рекомендованный план | vCPU | RAM | Включенный диск | Расширение | Проверенная месячная цена | Для чего подходит |
|---|---|---|---|---|---|---|---|
| LightNode | Agency Linux | 2 | 4GB | 50GB NVMe | Дополнительный облачный диск; цена в консоли | Публичный ориентир $14.70 | Гибкая почасовая оплата |
| Hetzner | CPX22, проверить наличие | 2 | 4GB | 80GB NVMe | Подключаемые тома | Уточните актуальную цену | Размещение в ЕС после проверки предложения |
| DigitalOcean | Basic Regular 4GiB | 2 | 4GiB | 80GiB SSD | Подключаемые тома | $24 | Первый запуск по документации |
| Vultr | vc2-2c-4gb | 2 | 4GB | 80GB SSD | Региональное Block Storage | $20 в базовом регионе | Выбор региона |
| Akamai Cloud / Linode | Linode 4GB | 2 | 4GB | 80GB SSD | Block Storage; уточнить региональную цену | $24 в базовом регионе | Универсальный хостинг |
| Contabo | Cloud VPS 4 | 4 | 8GB | 100GB SSD | Более крупные планы; проверить совместимость дополнений | Уточните актуальную цену | Больше ресурсов |
Что такое Paperless-ngx?
Paperless-ngx представляет собой открытую систему управления документами для самостоятельного размещения. Она импортирует файлы, извлекает текст, при необходимости выполняет OCR и предоставляет полнотекстовый поиск. Теги, корреспонденты, типы документов и правила сопоставления помогают организовать чеки, счета и переписку. Веб-интерфейс также поддерживает права доступа и автоматическую классификацию.
Документы остаются на хранилище, которым управляете вы. Поэтому диски, доступ и восстановление входят в эксплуатационные задачи. Система может дополнять фототеку Immich, но оригиналам документов, метаданным и производным файлам нужен собственный план хранения.
Требования Paperless-ngx к серверу
CPU и оперативная память
Официальное руководство допускает скромное оборудование и рекомендует Docker большинству пользователей. Оно не устанавливает одну конфигурацию VPS, гарантирующую работу при любой нагрузке OCR. Учитывайте отдельно Linux/Docker, приложение, PostgreSQL, брокер и временную обработку OCR. Необязательные службы конвертации потребляют дополнительную память.
Рекомендованные конфигурации VPS
Это стартовые редакционные оценки, включающие систему и основные контейнеры, а не официальные минимумы или гарантии быстродействия. Дисковые объемы относятся к небольшой начальной установке; последующий расчет библиотеки может потребовать большего.
| Нагрузка | vCPU | RAM | Начальный бюджет SSD | Стартовые настройки OCR |
|---|---|---|---|---|
| Личная небольшая библиотека | 2 | 2GB | 30GB | Один обработчик и один поток OCR; осторожное тестирование |
| Регулярный OCR | 2 | 4GB | 50GB | Начать с 1 × 1 и следить за пиками |
| Частое сканирование, небольшой офис | 4 | 8GB | 100GB | Оценить 1 × 2 или 2 × 1 |
| Большие партии или библиотеки | 4-8 | 8-16GB | Расширяемое хранилище | Настраивать по измеренным очереди и памяти |
Производительность OCR и расход ресурсов
Изображения высокого разрешения, длинные PDF, несколько языков и одновременные задания могут вызывать краткие пики CPU/RAM. Запросы пользователей, база данных, обновление индекса и классификация конкурируют с OCR. Tika/Gotenberg увеличивают нагрузку при преобразовании документов Office.
В актуальном справочнике настроек PAPERLESS_TASK_WORKERS определяет параллельные фоновые задачи, а PAPERLESS_THREADS_PER_WORKER определяет число страниц одного документа, обрабатываемых параллельно. Их произведение не должно превышать число логических CPU. На VPS с 2 vCPU настройка 1 × 1 оставляет часть CPU сайту и базе данных. Она не задает жесткий предел памяти.
Требования к диску
Учитывайте оригиналы, архивные версии, миниатюры, извлеченный текст/метаданные, PostgreSQL, поисковый индекс, образы контейнеров и временные файлы. Оставляйте свободное место для импорта и обновлений. Измерьте рост после загрузки характерных сканов; универсального процента накладных расходов нет.
PostgreSQL и Redis-совместимый брокер
Официальное руководство рекомендует PostgreSQL для новых установок; SQLite и MariaDB также поддерживаются. Redis-совместимый брокер координирует фоновую работу. Проверенный шаблон использует Valkey, поэтому Redis не является единственным вариантом. Адрес redis://broker:6379 обозначает протокол, а не название продукта.
Когда увеличивать RAM?
Добавляйте память или уменьшайте параллелизм при устойчивой нехватке памяти, сбоях OCR или завершении процессов механизмом OOM. Прежде чем объяснять все задержки RAM, сравните типичные импорты с остановленными посторонними задачами. Swap дает аварийный запас, но не ускоряет перегруженный OCR. При совместном размещении с Coolify или Dokploy учитывайте и их потребление.
6 лучших провайдеров VPS для Paperless-ngx
Провайдеры предлагают Linux VM с административным доступом root/SSH для ручной установки Docker. Выберите поддерживаемый 64-битный образ Ubuntu, проверьте условия IPv4 и ограничьте SSH до установки. Общие CPU не дают гарантии скорости OCR.
1. LightNode: гибкая почасовая оплата
LightNode Agency предлагает 2 vCPU, 4GB RAM, 50GB NVMe и заявленные 2TB трафика при месячном ориентире $14.70. Premium увеличивает CPU/RAM до 4 vCPU/8GB и трафик до 3TB за $27.70, но диск остается 50GB. Agency разумно оценить для личного регулярного OCR; Premium добавляет запас параллелизма, но не решает дисковую проблему большой библиотеки.
Linux/root, предложение выделенного IP и площадки на нескольких континентах подходят для обычного Docker-хостинга. Подтвердите статический адрес и регион в заказе. В документации по оплате описаны дополнительные облачные диски, но емкость и стоимость нужно узнать в консоли. Не предполагайте дешевое безлимитное расширение или официальную установку Paperless-ngx в один клик.
Младший Start дает 1 vCPU/2GB за $7.71, ниже нашей стартовой рекомендации 2 vCPU. В FAQ описаны почасовая серверная плата, предел 672 часа за полный календарный месяц, отдельные правила трафика и начисления за остановленные VM. Цены snapshots и резервных копий уточняйте отдельно. Гибкая оплата удобна для оценки настроек OCR, но не доказывает скорость обработки.
2. Hetzner: размещение в ЕС после проверки предложения
CPX22 включает 2 vCPU, 4GB и 80GB NVMe. Каталог также показывал недоступность и региональные цены, поэтому здесь указано Уточните актуальную цену, без заявления о подтвержденном самом дешевом доступном заказе. Младший CPX12 имеет 1 vCPU/2GB и меньше запаса для OCR.
Для CPX22 указаны 20TB передачи в ЕС и 1TB в Сингапуре. Основной IPv4 стоит €0.50/месяц без НДС; почасовая оплата ограничена месячным пределом. Проверьте доступные Linux-образы и итог региона.
Тома расширяют файловое хранилище независимо от CPU/RAM. Их данные не входят в резервные копии и snapshots сервера. Для ежедневных серверных копий есть семь слотов; уточните текущие тарифы копий и томов. Hetzner стоит сравнить для архива в ЕС после подтверждения емкости, предусмотрев отдельную копию каждого подключенного тома с документами.
3. DigitalOcean: первый запуск по документации
Basic Regular 4GiB дает 2 vCPU, 80GiB SSD и 4,000GiB передачи за $24/месяц. Начальный $4/512MiB не соответствует нашей оценке всей системы; даже $12/2GiB имеет только одну vCPU. Рекомендованный план практичнее для регулярного OCR.
Документация Ubuntu, создание VM с SSH-ключами и облачные межсетевые экраны помогают с первым запуском. Основной стандартный IPv4 включен; доступны Америка, Европа и Азиатско-Тихоокеанский регион. Посекундная оплата имеет месячный предел и минимум 60 секунд или $0.01, смотря что больше.
Тома стоят $0.10/GiB в месяц; проверьте региональную доступность и отдельно заложите их snapshots. Процентные еженедельные копии стоят 20%, ежедневные 30%. Образы Droplet не включают подключенный том. Преимущества здесь в документации и понятных ресурсах; PostgreSQL, OCR и восстановление обслуживаете вы.
4. Vultr: региональные варианты VPS
Публичный API планов содержит vc2-2c-4gb: 2 vCPU, 4GB RAM, 80GB SSD и 3,072GB передачи за $20/месяц или $0.027/час в базовых регионах. В Сан-Паулу цена $30. Младший 1 vCPU/1GB стоит $5; его нельзя выдавать за стоимость рекомендованной конфигурации OCR.
В каталоге есть площадки на нескольких континентах, но наличие плана on-demand не резервирует мощности. Проверьте Linux-образ и стандартную конфигурацию с IPv4. Используйте межсетевой экран провайдера вместе с ограничениями самого хоста.
Цена и доступность Block Storage зависят от региона. Автоматические копии добавляют 20% и не включают Block Storage; snapshots оплачиваются отдельно. План 4 vCPU/8GB/160GB стоит $40 в базовых регионах, если измерения показывают необходимость расширения. Выбирайте подходящее сочетание региона и диска, не приписывая ему непроверенное преимущество по задержке или OCR.
5. Akamai Cloud: универсальное размещение
API типов Linode указывает Linode 4GB за $24/месяц или $0.036/час: 2 vCPU, 80GB диска и 4,000GB передачи. Дополнение резервного копирования стоит $5/месяц в базовых регионах. Nanode 1GB начинается с $5, но ниже диапазона оценки всей системы в этом руководстве.
Linux-образы, SSH, включенный основной IPv4 и облачные межсетевые экраны подходят для обычной установки. Есть регионы в Америке, Европе и АТР. Рекомендованный план стоит $28.80 в Джакарте и $33.60 в Сан-Паулу, с другими тарифами копий. Почасовая оплата имеет месячные пределы; выделенные ресурсы оплачиваются и после остановки VM.
Block Storage позволяет расширять архив; проверьте регион, емкость и цену до переноса файлов. Резервные копии Linode не включают подключенное Block Storage. Используйте экспорты приложения и независимое зашифрованное хранилище. Это универсальный вариант при подходящих цене и размещении, а не специализированная служба OCR.
6. Contabo: конфигурации с большим объемом ресурсов
Актуальная документация VPS Contabo описывает Cloud VPS 4: 4 общие vCPU, 8GB RAM и 100GB SSD. Cloud VPS Plus 4 представляет собой другой продукт с 150GB NVMe. Память полезна для частого сканирования, но заявленный объем не доказывает скорость обработки PDF.
Документированы Linux/root, один статический IPv4 и сетевой межсетевой экран. У Cloud VPS 4 порт 200Mbit/s; заявленный безлимитный трафик подчиняется правилам разумного использования. Проверьте региональные доплаты и доступные ОС.
Публичную цену заказа подтвердить не удалось: Уточните актуальную цену, включая подключение, срок и продление. Более крупные планы и Storage VPS могут быть альтернативой, но не считайте их подключаемым диском без проверки совместимости. Покрытие и стоимость Auto Backup и snapshots зависят от продукта. Сравните весь план хранения и восстановления, особенно когда документы перерастут системный диск.
Сколько диска нужно Paperless-ngx?
Оригинал и архивная версия PDF/A могут существовать одновременно. Настройки OCR и формат влияют на создание архивной версии; принудительная растеризация увеличивает размер. Извлеченный текст, база данных, индексы и миниатюры занимают дополнительное место. Руководство пользователя поясняет: успешно обработанные файлы покидают входящую папку и переходят в управляемый архив.
Следующие примерные бюджеты емкости основаны на допущениях, а не измеренных коэффициентах. Предполагается, что архивные версии примерно равны оригиналам, плюс явно заданный вспомогательный объем. ОС и образы контейнеров учитываются отдельно от вспомогательных данных архива. Свободное место нужно для временного OCR, обновлений и ближайшего роста. Внешняя емкость рассчитана на два полных несжатых комплекта оригиналов, архивных версий и вспомогательных данных; сроки хранения, шифрование и дедупликация меняют результат.
| Исходные документы | Дополнительное место по оценке | Свободный рабочий запас | Основное хранилище | Внешние резервные копии |
|---|---|---|---|---|
| 5GB | 5GB архивных версий + 2GB вспомогательных + 8GB системы | 10GB | 30GB | Около 24GB плюс конфигурация/накладные расходы |
| 50GB | 50GB архивных версий + 10GB вспомогательных + 10GB системы | 30GB | 150GB | Около 220GB плюс конфигурация/накладные расходы |
| 200GB | 200GB архивных версий + 30GB вспомогательных + 10GB системы | 60GB | 500GB | Около 860GB плюс конфигурация/накладные расходы |
Импортируйте образцы и измерьте отдельно media, data, базу данных и пиковое временное место. До полного локального экспорта выделите дополнительную емкость. Внешняя колонка показывает объем, а не цену. Для библиотеки 200GB получите предложение по полезному диску и копиям до заказа VPS на 50GB. Подключите постоянное хранилище документов до импорта; смена точки монтирования без переноса данных может скрыть существующий архив.
Сколько стоит хостинг Paperless-ngx?
| Сценарий | Проверенная цена VM | IPv4 | Расширение диска | Необязательные копии провайдера | Оценка внешнего хранения/домена | Месячный бюджет |
|---|---|---|---|---|---|---|
| Личный архив, около 5GB оригиналов | LightNode Agency $14.70 | Подтвердить включенный выделенный IP | Не нужно в пределах 50GB | Отдельная цена, не включена | $2 внешнее хранение; имеющийся домен $0 | $16.70 + неоцененные опции |
| Семья, около 50GB оригиналов | Vultr 4 vCPU/8GB/160GB $40 | Стандартный план; проверить заказ | Не нужно, если фактический бюджет помещается | 20% = $8 | $6 хранение + $1 домен | $55 |
| OCR малого бизнеса, около 200GB оригиналов | DigitalOcean 4 vCPU/8GiB/160GiB $48 | Основной включен | Том документов 500GiB = $50 | Еженедельные 20% = $9.60 | $20 хранение + $1 домен | $128.60 |
Расходы на внешнее хранилище и домен являются редакционными бюджетными допущениями, а не доступными предложениями или гарантией нужной глубины хранения. Уточните емкость, восстановление и исходящий трафик. В бизнес-примере том 500GiB по подтвержденному тарифу добавлен к корневому диску 160GiB: это превышает примерный общий бюджет 500GB и оставляет место ОС/базе данных. Проверьте монтирование, полезный объем и место экспорта. GB и GiB отличаются; сохраняйте единицы провайдера. Базовые суммы не включают временный полный экспорт. При указанных допущениях библиотеке 50GB нужно еще около 110GB для экспорта, которые не поместятся вместе с рабочими файлами на корневом диске 160GB. До локального экспорта рассчитайте отдельный временный том или достаточное расширение. Копии провайдера не защищают подключенные тома. Налоги, превышение трафика, почтовые службы и работа администратора оплачиваются дополнительно. Промоакции в суммы не заложены.
Как установить Paperless-ngx на Ubuntu VPS
Для новой установки используется официальный версионный шаблон PostgreSQL. Нужны Ubuntu 24.04 LTS, SSH-ключ и свой домен. Здесь не заявлены запуск на купленном VPS или измерение скорости OCR. Команды выполняются в оболочке root; новый хост исключает перезапись существующей установки.
1. Установите Docker Engine и Compose
ssh ubuntu@YOUR_SERVER_IP
sudo -i
apt update
apt upgrade -y
apt install -y ca-certificates curl python3 age
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc
cat > /etc/apt/sources.list.d/docker.sources <<EOF_DOCKER
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF_DOCKER
apt update
apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
docker run --rm hello-world
docker compose versionПрочитайте требования Docker для Ubuntu, список конфликтующих пакетов и ограничения межсетевого экрана. При необходимости перезагрузитесь и подключитесь снова. Официальная установка Paperless требует Docker и Compose; здесь используется поддерживаемый плагин, а не старый исполняемый файл docker-compose.
2. Скачайте и измените официальные файлы
umask 077
install -d -m 0700 /opt/paperless
cd /opt/paperless
# Stop here if this directory already contains an installation.
test ! -e docker-compose.yml && test ! -e .env && test ! -e docker-compose.env || exit 1
PAPERLESS_RELEASE=v3.3.4
COMPOSE_BASE="https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/${PAPERLESS_RELEASE}/docker/compose"
curl -fL "$COMPOSE_BASE/docker-compose.postgres.yml" -o docker-compose.yml
curl -fL "$COMPOSE_BASE/docker-compose.env" -o docker-compose.env
curl -fL "$COMPOSE_BASE/.env" -o .env
cp docker-compose.yml docker-compose.upstream.yml
install -d -o 1000 -g 1000 -m 0700 consume exportПеред запуском следующего блока замените paperless.example.com. Проверенное преобразование фиксирует версию приложения, ограничивает HTTP loopback-адресом и меняет пароль БД из шаблона. Сохраняются официальные тома data, media, pgdata и redisdata; последний хранит состояние Valkey. В PostgreSQL 18 шаблон монтирует /var/lib/postgresql, поэтому не подменяйте путь схемой старой основной версии.
python3 - <<'PY_CONFIG'
from pathlib import Path
import secrets
p = Path('docker-compose.yml')
s = p.read_text()
changes = {
'ghcr.io/paperless-ngx/paperless-ngx:latest': 'ghcr.io/paperless-ngx/paperless-ngx:3.3.4',
'"8000:8000"': '"127.0.0.1:8000:8000"',
'POSTGRES_PASSWORD: paperless': 'POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:?Set database password}"',
'PAPERLESS_DBENGINE: postgresql': 'PAPERLESS_DBENGINE: postgresql\n PAPERLESS_DBPASS: "${POSTGRES_PASSWORD:?Set database password}"',
}
for old, new in changes.items():
assert s.count(old) == 1, f'Unexpected upstream template: {old}'
s = s.replace(old, new)
p.write_text(s)
with Path('.env').open('a') as f:
f.write('\nPOSTGRES_PASSWORD=' + secrets.token_hex(32) + '\n')
e = Path('docker-compose.env')
t = e.read_text()
assert t.count('PAPERLESS_SECRET_KEY=change-me') == 1
t = t.replace('PAPERLESS_SECRET_KEY=change-me',
'PAPERLESS_SECRET_KEY=' + secrets.token_urlsafe(64))
t += '''
PAPERLESS_URL=https://paperless.example.com
PAPERLESS_TIME_ZONE=UTC
PAPERLESS_ACCOUNT_ALLOW_SIGNUPS=false
USERMAP_UID=1000
USERMAP_GID=1000
PAPERLESS_OCR_LANGUAGE=eng
PAPERLESS_OCR_MODE=auto
PAPERLESS_TASK_WORKERS=1
PAPERLESS_THREADS_PER_WORKER=1
'''
e.write_text(t)
PY_CONFIG
chmod 0600 .env docker-compose.env docker-compose.yml
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100 webserver db broker
docker compose exec webserver createsuperuserДождитесь успешного запуска и миграций, затем создайте администратора. Введите уникальный пароль интерактивно; не помещайте учетные данные в команды и не добавляйте env-файлы в Git. config --quiet проверяет синтаксис без вывода раскрытых секретов. Настройте узкие права доступа сканера для выбранных UID/GID; избегайте chmod 777. Контейнер может начинать инициализацию от root и затем понижать права приложения; в этом примере режим rootless не включается.
3. Включите HTTPS и проверьте импорт
Направьте запись A домена на VPS; AAAA публикуйте только при рабочей маршрутизации и firewall IPv6. Оставьте 8000 приватным, разрешите SSH доверенным адресам, а TCP 80/443 откройте для прокси. Не публикуйте PostgreSQL 5432 или Valkey 6379. Опубликованные Docker-порты могут обходить обычные предположения о правилах UFW.
Установите Caddy из официального репозитория Debian/Ubuntu:
apt install -y debian-keyring debian-archive-keyring apt-transport-https gnupg
curl -fsSL https://dl.cloudsmith.io/public/caddy/stable/gpg.key \
| gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -fsSL https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt \
-o /etc/apt/sources.list.d/caddy-stable.list
chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
chmod o+r /etc/apt/sources.list.d/caddy-stable.list
apt update
apt install -y caddyНа новом сервере поместите следующий текст в /etc/caddy/Caddyfile, заменив домен:
paperless.example.com {
reverse_proxy 127.0.0.1:8000
}caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy
curl -I https://paperless.example.comДля базового варианта используйте прямой DNS; дополнительные прокси меняют доверенную цепочку и ограничения загрузки. Войдите через HTTPS, загрузите безвредный скан PDF, дождитесь успешной задачи и найдите характерное слово с изображения. Проверьте скачивание оригинала и архивной версии. Убедитесь через ss -lntp, что 8000 слушает только loopback, а БД/брокер недоступны извне. HTTPS защищает передачу, но не шифрует архив от администраторов сервера.
Настройка OCR в Paperless-ngx
Для локального OCR Paperless использует OCRmyPDF и Tesseract. PAPERLESS_OCR_LANGUAGE выбирает языки распознавания с разделителем +. PAPERLESS_OCR_LANGUAGES устанавливает дополнительные Docker-пакеты, перечисленные через пробел. По документированным настройкам проверенной версии образа доступны английский, немецкий, итальянский, испанский и французский.
Для документов на английском и турецком измените docker-compose.env:
PAPERLESS_OCR_LANGUAGE=eng+tur
PAPERLESS_OCR_LANGUAGES=tur
PAPERLESS_OCR_MODE=auto
PAPERLESS_TASK_WORKERS=1
PAPERLESS_THREADS_PER_WORKER=1Пересоздайте приложение командой docker compose up -d webserver и проверьте образец скана. Установка дополнительных языков требует обычной инициализации контейнера; официальная документация запрещает эту опцию с режимом rootless. Названия пакетов могут отличаться от кодов Tesseract, особенно для вариантов китайского.
В v3.3.4 режим auto пропускает OCR при достаточном встроенном тексте и обрабатывает PDF только с изображениями. redo пытается заменить прежний OCR; force растеризует страницы и увеличивает файлы; off выключает OCR. Перед изменением прочитайте справочник конфигурации. Tika и Gotenberg нужны для необязательной конвертации Office/.eml, а не для каждого сканированного PDF. При необходимости берите официальный шаблон -tika и добавляйте RAM.
Автоматический импорт документов
Каталог consume, подключенный с хоста, принимает сканы и полностью переданные файлы; после успешной обработки они удаляются из входящей папки. UID приложения должен иметь права чтения и удаления. Сначала загружайте во временный каталог, затем перемещайте готовый файл во входящую папку на той же файловой системе, чтобы не импортировать недописанные данные.
Для NFS/SMB без надежного inotify задайте актуальный параметр PAPERLESS_CONSUMER_POLLING_INTERVAL=10 в docker-compose.env: опрос каждые десять секунд. PAPERLESS_CONSUMER_STABILITY_DELAY определяет, как долго файл должен оставаться неизменным. Сверяйтесь с версионной документацией, а не копируйте старые имена параметров опроса.
Почтовые учетные записи и правила обработки импортируют вложения. Ограничьте доступ к ящику и проверьте правила до разрешения удаления или перемещения. Теги, корреспонденты, сопоставление и рабочие процессы классифицируют документы; проверьте результаты, прежде чем доверять автоматизации. Сценарий n8n необязателен и должен обращаться к API с ограниченными правами. Папка consume является очередью приема, а не резервной копией.
Резервное копирование Paperless-ngx
Следуйте официальному руководству администратора. Экспортер включает оригиналы, архивные файлы, миниатюры, метаданные/настройки и содержимое БД; API-токены исключаются. Отдельно сохраняйте Compose и окружение. Поисковые данные в data можно пересоздать из восстановленных документов и метаданных; при копировании томов нужно также сохранять data, документы и согласованную копию базы данных.
Для экспорта приостановите прием со сканера, почты и автоматизаций, прекратите пользовательские изменения и дождитесь окончания всех задач. Сохраняйте это окно обслуживания до конца экспорта. Заранее подготовьте временное место:
cd /opt/paperless
set -euo pipefail
umask 077
BACKUP_LABEL="$(date -u +%Y%m%dT%H%M%SZ)"
docker compose exec -T webserver document_exporter "../export/$BACKUP_LABEL"На доверенном компьютере восстановления создайте ключ age командой age-keygen -o recovery-key.txt и храните закрытый ключ там. На VPS замените получателя его открытым ключом age1.... Укажите внешний SSH-узел под своим контролем:
AGE_RECIPIENT='REPLACE_WITH_YOUR_AGE_PUBLIC_RECIPIENT'
install -d -m 0700 /var/backups/paperless
BACKUP_FILE="/var/backups/paperless/$BACKUP_LABEL.tar.age"
set -euo pipefail
tar -C /opt/paperless -cf - "export/$BACKUP_LABEL" \
docker-compose.yml docker-compose.env .env \
| age -r "$AGE_RECIPIENT" -o "$BACKUP_FILE"
sha256sum "$BACKUP_FILE" > "$BACKUP_FILE.sha256"
scp "$BACKUP_FILE" "$BACKUP_FILE.sha256" backupuser@BACKUP_HOST:paperless/Проверяйте код завершения каждой команды и удаленную контрольную сумму до признания копии готовой. Сохраняйте /etc/caddy/Caddyfile и дополнительную конфигурацию тем же защищенным способом. Возобновите прием после успешного экспорта. Ошибку конвейера нужно расследовать; пустой или неполный файл не является копией восстановления. Задайте сроки хранения в независимом хранилище и защитите временные незашифрованные экспорты. Договоры, счета и удостоверения личности требуют ограниченного доступа и зашифрованных копий.
Проверьте восстановление на отдельном новом хосте с той же версией Paperless, пустой БД и пустыми томами media/data. Восстановите проверенную конфигурацию, расшифруйте архив на доверенном компьютере (age -d -i recovery-key.txt -o recovery.tar BACKUP.tar.age), осмотрите содержимое и передайте его через SSH в новый приватный каталог. Не распаковывайте поверх работающей установки. Поместите датированный экспорт в новый export, сохраните доступ UID/GID, запустите новые БД/брокер и выполните:
docker compose up -d db broker
docker compose run --rm webserver document_importer ../export/EXPORT_LABEL
docker compose up -d
docker compose exec webserver document_index reindexЗамените EXPORT_LABEL; импортируйте до создания нового администратора, поскольку импортер требует пустой установки. Проверьте вход, количество документов, контрольные суммы оригиналов/архивных версий, теги, поиск и новый тестовый импорт. Пересоздайте API-токены. Сохраняйте старые сервер и DNS до успешной проверки. Экспортер позволяет не копировать каталог работающей PostgreSQL; snapshots сами по себе не обеспечивают согласованность БД и файлов.
Paperless-ngx и другие системы управления документами
| Система | Сложность установки | OCR | Организация | Планирование ресурсов | Применение |
|---|---|---|---|---|---|
| Paperless-ngx | Приложение, БД и брокер | OCRmyPDF/Tesseract | Теги, корреспонденты, рабочие процессы | Параллелизм OCR и документы | Личный/семейный архив с поиском |
| Mayan EDMS | Более широкая настройка администрирования и процессов | OCR/распознавание текста | Версии, права, рабочие процессы | Оценить способ запуска и обработчики | Команды с документными процессами |
| Docspell | REST-сервер и обработчик | Автоматическое извлечение текста/OCR | Теги и метаданные | Фоновые задания и JVM-службы | Автоматизированный прием и организация |
Это сравнение функций и способов развертывания, а не тесты на одинаковом оборудовании. До выбора прочитайте актуальные инструкции проектов; более широкие процессы могут оправдать дополнительные затраты на администрирование.
Безопасность и конфиденциальность
Используйте HTTPS, надежные пароли, встроенную двухфакторную аутентификацию и офлайн-коды восстановления. Выдавайте обычным пользователям только нужные права на документы; суперпользователь нужен для администрирования. Собственное хранилище паролей помогает с учетными данными, но требует отдельной защиты и копий.
Ограничьте БД/брокер приватной сетью Docker. Защитите SSH, аккаунты провайдера, учетные данные резервного хранилища и конфигурацию. Не открывайте общий доступ к сканеру без ограничений. Проверяйте закрепленные выпуски приложения и инструкции крупных миграций, экспортируйте перед обновлением и регулярно обновляйте Docker/ОС. Основные версии PostgreSQL требуют отдельной миграции; новая метка образа не переносит каталог данных автоматически.
Сам по себе VPS не делает конфиденциальные документы безопасными. Компрометация сервера или аккаунта провайдера может раскрыть файлы. Зафиксируйте цели восстановления и проверяйте внешние копии. Для домашнего архива VPN или доступ из доверенных сетей может быть разумнее неограниченного публичного доступа.
Частые проблемы Paperless-ngx
| Проблема | Безопасное направление диагностики |
|---|---|
| Контейнер не запускается | Проверьте docker compose ps, логи, синтаксис окружения и архитектуру образа; не удаляйте тома |
| OCR отсутствует или ошибается | Проверьте пакеты языков, коды и режим; используйте безвредный образец |
| Документы не появляются | Проверьте права приема, очередь и завершение обработки; исключите дубликаты до повторной загрузки |
| Ошибка импорта PDF | Прочитайте ошибку; проверьте шифрование, повреждения и размеры страниц/картинок на копии |
| PostgreSQL не подключается | Проверьте состояние, имя сервиса и совпадение паролей; не сбрасывайте существующую БД |
| Ошибка Redis/Valkey | Проверьте брокер и PAPERLESS_REDIS; не открывайте 6379 наружу |
| Не хватает памяти | Проверьте docker stats, сообщения OOM ядра и параллелизм; уменьшите задачи или добавьте RAM |
| Закончился диск | Проверьте df -h, df -i и рост экспортов; сохраняйте оригиналы до переноса проверенных копий |
| Ошибки доступа | Проверьте UID/GID consume/export и внешних томов; не разрешайте запись всем |
| Прокси отклоняет загрузку | Проверьте лимиты размера/времени всех прокси/CDN и логи; попробуйте небольшой безвредный PDF |
| Поиск пропускает файлы | Проверьте OCR и задачи; после резервной копии выполните документированный document_index reindex |
Какой VPS выбрать для Paperless-ngx?
LightNode Agency имеет самый низкий проверенный месячный ориентир среди рекомендованных планов этого сравнения: $14.70, с гибкой почасовой оплатой. Это не учитывает неподтвержденные предложения Hetzner/Contabo, региональные надбавки и дополнительное хранение/копии. Диск 50GB подходит небольшому личному архиву, пока измеренный рост помещается.
Для регулярного OCR оцените 2 vCPU/4GB с умеренным параллелизмом. У Vultr базовый план за $20 включает 80GB; DigitalOcean и Akamai предлагают 2 vCPU/4GB/80GB за $24. Частые сканы или малый бизнес могут оправдать 4 vCPU/8GB, ограничения доступа и определенный план восстановления. Большим библиотекам независимо от провайдера нужны отдельная цена тома документов и подходящая глубина внешних копий.
Частые вопросы
Какой VPS лучше для Paperless-ngx?
Выбирайте по измеренной нагрузке OCR и полезному диску. LightNode Agency имеет самый низкий проверенный ориентир рекомендованного плана; Vultr, DigitalOcean и Akamai дают больше диска по более высокой цене.
Сколько RAM нужно Paperless-ngx?
Мы оцениваем 2GB для осторожной проверки небольшой библиотеки и 4GB для регулярного OCR вместе с Linux и основными контейнерами. Это рекомендации планирования, не универсальные официальные минимумы.
Можно ли использовать VPS с 2GB?
Можно оценить небольшие файлы при низком параллелизме. Крупные сканы, дополнительные языки или службы конвертации могут исчерпать память; измеряйте пики.
Обязателен ли PostgreSQL?
Нет, поддерживаются SQLite и MariaDB. Для новой установки документация рекомендует PostgreSQL; здесь используется его шаблон.
Нужен ли Redis?
Фоновой обработке нужен Redis-совместимый брокер. Официальный проверенный шаблон использует Valkey, а не требует именно Redis.
Сколько места занимает Paperless-ngx?
Сложите оригиналы, возможные архивные копии, вспомогательные данные и рабочий запас. Измеряйте типичные импорты; число документов не определяет объем диска.
Бесплатен ли самостоятельный хостинг?
Проект открыт по GPL-3.0. Вы оплачиваете VM, полезный диск, независимые копии и администрирование.
Распознает ли он сканированные PDF?
Да, локально через OCRmyPDF/Tesseract. На результат влияют правильные языковые пакеты и достаточные вычислительные ресурсы.
Как сделать резервную копию?
Запустите официальный экспортер в тихое окно обслуживания, сохраните конфигурацию, зашифруйте внешние копии и проверьте импортер на пустой установке той же версии.
Можно ли разместить его на Ubuntu?
Да. Поддерживаемый Ubuntu с Docker Engine и плагином Compose запускает официальную систему контейнеров. Веб-порт оставьте приватным за HTTPS-прокси.
Для небольшого архива начните с измерений и умеренных настроек OCR. На регулярную работу закладывайте 2 vCPU/4GB, увеличивайте ресурсы по мониторингу и покупайте место и для оригиналов, и для обработанных файлов. Проверенная зашифрованная копия для восстановления должна входить в бюджет с самого начала.