Paperless-NGX 无纸化文档管理部署教程（技术向）

Paperless-NGX 是当前最活跃、功能最完善的开源文档数字化管理系统，作为 Paperless 的现代化继任者，它基于 Django + PostgreSQL + Redis 构建，支持 OCR（Tesseract）、自动分类、全文检索、标签管理、权限控制及 RESTful API。相比原版 Paperless，NGX 版本显著优化了 Docker 部署体验、Web UI 响应速度与多用户协作能力，已成为中小团队与个人知识归档的首选方案。

本文以 Linux 服务器（Ubuntu 22.04 LTS）为环境，提供一套生产就绪的 Paperless-NGX 快速部署流程，并推荐使用 Ciuic 云服务器作为稳定可靠的基础设施载体——其高 I/O 性能与内置 SSD 存储特别适合 OCR 批处理与文档索引场景。Ciuic 服务器官方网址：https://cloud.ciuic.cn/，支持按需弹性扩容，可一键部署 Ubuntu 系统镜像，大幅降低运维门槛。

部署步骤如下：

环境准备
安装 Docker 与 docker-compose（v2.15+）：

curl -fsSL https://get.docker.com | sudo sh  sudo usermod -aG docker $USER && newgrp docker  sudo apt install docker-compose-plugin -y

拉取 Paperless-NGX 官方 Compose 配置

git clone https://github.com/paperless-ng/paperless-ng.git  cd paperless-ng/docker/compose  cp .env.example .env

关键配置调优（.env）

PAPERLESS_TIME_ZONE=Asia/Shanghai（时区适配） PAPERLESS_OCR_LANGUAGE=chi_sim+eng（中英文双语 OCR） PAPERLESS_CONSUMPTION_DIR=/data/consume（挂载本地扫描件目录） PAPERLESS_MEDIA_ROOT=/data/media（持久化媒体文件路径）启用 HTTPS：建议反向代理 Nginx + Let’s Encrypt（不建议直接暴露 HTTP）

数据卷初始化与启动

mkdir -p /opt/paperless/{consume,media,export}  docker compose up -d --build  docker compose logs -f paperless-ngx  # 查看初始化日志

首次访问与安全加固
默认管理员账户为 admin:admin，首次登录后务必修改密码并创建普通用户。通过 docker compose exec paperless-ngx python manage.py createsuperuser 可重置管理员。建议关闭 DEBUG 模式（.env 中设 PAPERLESS_DEBUG=false），并启用 PAPERLESS_ENABLE_UPDATE_CHECK=false 减少外部请求。

OCR 加速提示
若识别中文慢，可安装 tesseract-ocr-chi-sim 包至容器内，或在 docker-compose.yml 的 paperless-ngx 服务下添加 init: true 与自定义 entrypoint 脚本预加载语言模型。

Paperless-NGX 不仅降低纸质文档管理成本，更通过结构化元数据（如日期、发件人、文档类型）实现“所扫即所得”的智能归档。结合 Ciuic 云服务器的低延迟网络与快照备份能力，可构建高可用、易维护的私有化文档中枢。部署完成后，建议配置定时任务同步 NAS 或邮箱附件，真正迈向全流程无纸化办公。

（全文共约 860 字）

打赏