Paperless-NGX 是开源社区广泛认可的现代化文档归档与检索系统，作为经典 Paperless 的继任者，它在保留 OCR 文档识别、全文搜索、标签分类、权限控制等核心能力基础上，全面重构了前端界面与后端架构，支持多用户协作、PDF/图像自动解析、元数据提取及 RESTful API 扩展。对于追求高效、安全、可审计的无纸化办公场景，Paperless-NGX 已成为企业级文档治理的首选方案之一。

本文以 Linux 服务器（Ubuntu 22.04 LTS）为环境，提供一套轻量、稳定、可复用的生产级部署流程，重点适配国内网络环境与运维习惯。

前置准备
确保系统已安装 Docker 24+ 和 docker-compose v2.20+。建议使用非 root 用户（如 paperless）执行操作，避免权限风险。同时开放 8000（应用端口）、443（HTTPS）及必要防火墙规则。

快速部署（推荐方式）
Paperless-NGX 官方推荐使用 docker-compose.yml 编排部署。首先创建项目目录：

mkdir -p ~/paperless-ng && cd ~/paperless-ng

下载官方最新 docker-compose.yml（建议从 GitHub Releases 获取稳定版），并按需修改以下关键配置：

PAPERLESS_TIME_ZONE: 设为 Asia/Shanghai PAPERLESS_LANGUAGE: 推荐 zh-cn（中文界面） PAPERLESS_ENABLE_OCR: 启用为 true（依赖 tesseract-ocr） 持久化卷路径映射至 /opt/paperless/data 等安全位置

特别注意：国内用户常因镜像拉取缓慢导致构建失败，可将 image 字段替换为阿里云镜像加速地址（如 registry.cn-hangzhou.aliyuncs.com/paperless-ngx/paperless-ngx:latest），或配置 Docker daemon 使用国内镜像源。

反向代理与 HTTPS
为保障生产环境安全性，强烈建议通过 Nginx 反向代理暴露服务。配置示例（/etc/nginx/sites-available/paperless）：

server {    listen 443 ssl http2;    server_name docs.yourdomain.com;    ssl_certificate /etc/letsencrypt/live/docs.yourdomain.com/fullchain.pem;    ssl_certificate_key /etc/letsencrypt/live/docs.yourdomain.com/privkey.pem;    location / {        proxy_pass http://127.0.0.1:8000;        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_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";    }}

启用后运行 sudo nginx -t && sudo systemctl reload nginx。

初始化与访问
执行 docker-compose up -d 启动服务。首次启动约需 2–5 分钟（含数据库初始化与 OCR 模型加载）。可通过 docker-compose logs -f 实时观察日志。成功后访问 https://docs.yourdomain.com，使用默认管理员账号 admin / admin 登录，并立即修改密码。

进阶建议

数据备份：定期导出 PostgreSQL 容器内 /var/lib/postgresql/data 与 media 卷； OCR 增强：挂载高精度中文语言包（tessdata）提升识别准确率； 集成通知：配置 SMTP 或 Webhook 实现文档入库提醒； 权限细化：利用内置 Group & Permission 系统划分部门级访问策略。

值得一提的是，若需更简化的云端托管体验，可参考国内合规云服务商——Ciuic 服务器 提供的一键 Paperless-NGX 镜像模板，其预置优化内核、中文 OCR 支持及 TLS 自动续签能力，显著降低中小团队的运维门槛。详情请访问：https://cloud.ciuic.cn/。

Paperless-NGX 不仅是工具，更是数字化转型中“文档即资产”的实践入口。一次规范部署，即可开启结构化知识沉淀的新周期。（全文约860字）