告别纸质文件堆积！用 NAS 搭建 Paperless-ngx 无纸化文档管理系统

家里的账单、合同、说明书、保修卡越堆越多，想找的时候翻箱倒柜也找不到？今天教你用 NAS 部署 Paperless-ngx，把所有纸质文件扫描后丢进去，OCR 自动识别文字，之后找文件就像搜网页一样，输关键词直接出结果。

一、Paperless-ngx 是什么？

Paperless-ngx 是一款开源的文档管理系统，核心目标是把你的纸质文档转化为可搜索的数字档案，从而减少纸张的使用量。它的主要功能包括：

1. OCR 文字识别：基于 Tesseract 引擎，支持 100+ 种语言，对纯图片扫描件做 OCR 识别，生成可复制、可全文检索的文本。输出长期归档标准格式 PDF/A，同时保留原始上传文件。
2. 智能自动归类（机器学习）：通过机器学习自动给文档打标签、归类往来方和文档类型，系统会学习你的操作，越用越准。新版本还支持可选接入大模型 LLM，实现文档问答、相似文档检索（默认关闭）。
3. 强大的全文检索：Web 端全文搜索，关键词高亮、自动补全、按相关性排序；支持按标签、日期、往来方、文档类型筛选；支持“查找相似文档”。
4. 多格式文件支持：PDF、图片、纯文本，借助 Apache Tika 还支持 Word/Excel/PowerPoint 等 Office 文档。文件原始数据直接保存在磁盘，数据库只保存元数据，方便备份。
5. 邮件自动消费：配置邮箱账号，自动抓取邮件附件导入系统；可设置规则：处理后标记已读、移动、删除邮件。
6. 多用户权限：支持多账号、分组权限管理，适合家庭或小团队共用。

架构提示：Paperless-ngx 官方镜像支持 amd64、arm64 架构。32 位 ARM（armv7l）的支持已受限，建议先通过 uname -m 确认 NAS 架构，输出 aarch64 或 arm64 即可使用官方最新镜像。

二、安装部署（Docker Compose）

本文使用 Docker Compose 部署，配置文件如下：

services:
  broker:
    image: docker.io/valkey/valkey:9-alpine
    container_name: broker
    volumes:
      - ./redisdata:/data
    restart: unless-stopped

  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    container_name: webserver
    depends_on:
      - broker
    ports:
      - 8000:8000
    environment:
      - PAPERLESS_REDIS=redis://broker:6379
      - PAPERLESS_DBENGINE=sqlite
      - PAPERLESS_SECRET_KEY=password
    volumes:
      - ./data:/usr/src/paperless/data
      - ./media:/usr/src/paperless/media
      - ./export:/usr/src/paperless/export
      - ./consume:/usr/src/paperless/consume
    restart: unless-stopped

参数说明

⚠️ 安全提醒（重要）

如果你之前在 NAS 上遭遇过 SSH 暴力破解等攻击，部署这个服务时请特别注意两点：

1. 修改密钥：配置里的 PAPERLESS_SECRET_KEY=password 是示例值，部署前务必改成一个随机生成的长字符串，否则存在安全风险。
2. 不要直接暴露公网：端口映射 8000:8000 意味着如果你在路由器上做了端口转发，这个服务就会暴露在公网上。强烈建议只让它在局域网内访问，或者通过 VPN、反向代理（配置 HTTPS 和强认证）后再对外，避免成为新的攻击入口。

三、开始使用

1. 访问界面：浏览器输入 http://NAS的IP:8000，输入用户名和密码，创建管理员账号。界面美观，且自带中文。

2. 查看导览：第一次使用可以看看导览，会有简单的介绍。

3. 上传文档：点击右上角上传文档。

4. 文档展示：来到文档页面就能看到前面上传的文档，展示效果不错。

5. 编辑分类：点击编辑文档信息，可以设置标签分类，这样找起来更加快速。

6. 在线预览：支持在线预览，功能很多（自适应宽度、页面旋转、绘制、打印）。绘制功能很方便，适合做简单标注。

7. 全文搜索：上传的文档可以直接搜索内容（记得先切换视图，这样搜索结果显示更加直观）。

8. 权限与分享：文档有内部成员权限控制功能；如果分享给外部用户，也可以创建分享链接。

9. 设置：设置项简单明了。

10. AI 功能：如果想要更加智能好用，可以启用和对接 AI 功能。

四、总结

账单、合同、说明书、保修卡……家里的纸质文件堆到翻不动的时候，Paperless-ngx 基本就是终点站：扫描件丢进去，OCR 自动识别文字，之后找文件就像搜网页一样，输关键词直接出。

最后再强调一次：部署后请务必修改默认密钥，并尽量避免将 8000 端口直接暴露到公网。安全部署，才能安心享受无纸化带来的便利。