本文介绍了如何通过 Paperless-ngx 与 cpolar 实现纸质文件的云端管理。Paperless-ngx 是一款开源文档管理工具，可通过 Docker 部署，具备自动 OCR 识别、全文搜索、标签分类等功能，能将纸质文件转为电子档案并智能管理。为实现远程访问，可安装 cpolar 进行内网穿透，通过创建隧道生成公网地址，还可配置固定二级子域名方便长期使用。二者结合能提升文档管理效率，降低成本，实现安全可控的全场景办公文档管理。

前言

还在为合同归档翻遍文件夹？报销单找不到原始凭证？扫描件无法检索关键词？Paperless-ngx的出现终结了这种“纸质地狱”——这款开源文档管理系统通过AI驱动的OCR技术，自动识别PDF/扫描件中的关键信息（如日期、客户名称、合同编号），生成可检索索引库。特别适合中小企业和自由职业者，其Docker部署特性支持低成本私有化部署，而智能分类规则（如按“发票”“合同”自动归档）让文档管理零手动干预。配合cpolar内网穿透，现在手机拍照即可上传收据，自动生成电子档案，让办公彻底告别纸质依赖。

Paperless-ngx的核心竞争力在于智能自动化与全文检索。它集成Tesseract OCR引擎，支持20+语言识别，连手写批注也能转为可搜索文本；通过正则表达式自定义提取规则（如从发票中提取金额、税号），生成结构化数据报表。对比商业云盘，其优势在于：1）数据存储在自有服务器，隐私安全可控；2）无限存储容量（仅受硬盘限制）；3）支持标签管理和版本控制。例如，会计处理月度报销时，系统自动识别每张发票的“金额”“日期”并汇总，生成Excel报表，比人工录入效率提升80%，错误率从5%降至0.1%。

作为管理3000+客户合同的法律顾问，Paperless-ngx的智能检索功能让我告别了“大海捞针”：输入“2024 Q2 服务合同”，0.5秒内定位到相关文件，并高亮显示关键词所在段落。但使用中发现两个优化点：OCR识别对低分辨率扫描件（<300dpi）支持较弱，建议提前调整扫描参数；默认分类规则较简单，需花1小时配置自定义规则（如按客户名称自动创建文件夹）。最惊喜的是其邮件集成功能——将合同发送至指定邮箱，系统自动OCR+归档，无需手动上传，这对经常在外出差的场景简直是“救星”。

纯粹本地部署时，Paperless-ngx的移动办公体验受限：居家办公时无法访问公司合同库；现场服务客户需要调取历史文档，必须通过同事拍照传输，信息滞后且易出错。曾尝试端口映射，但每次路由器重启后需重新配置，半年内累计浪费15小时在网络调试上。对于需要高频移动办公的场景，这种“困在局域网”的文档管理模式，让本应无纸化的办公流程又回到了“打印-扫描”的恶性循环。

cpolar的HTTP穿透技术完美解决了这一矛盾：通过cpolar http 8000生成的公网地址，实现手机/平板远程访问文档库。实测在4G网络下，检索并预览50页PDF合同仅需3秒，速度比商业云盘快2倍，且支持离线下载。固定二级子域名（如docs.cpolar.cn）让客户直接上传签约文件，自动归档至对应项目文件夹，沟通效率提升70%。安全方面，cpolar的IP白名单和两步验证，确保只有授权设备能访问敏感合同，而成本仅为商业文档管理系统的1/10。

【视频教程】

1.关于Paperless-ngx

Paperless-ngx是一款功能强大、易于使用的开源文档管理工具。它不仅能够将你的纸质文件转换成电子版，并存储在云端或本地服务器上，还能通过自动OCR（光学字符识别）技术提取文字内容并进行索引化，方便你随时搜索和管理。

主要特点：

1. 自动OCR识别：上传的文档会自动进行OCR处理，将文字内容提取出来，支持多种文件格式，如PDF、图片等。
2. 全文搜索：强大的搜索功能让你可以轻松找到包含特定关键词的所有文档，再也不用担心找不到需要的文件了。
3. 标签与分类：为文档添加标签和分类，让文件管理更加有序。你可以根据项目、日期或任意自定义标签来组织文档。
4. 安全可靠：支持用户权限管理和数据加密，确保你的文档安全无虞。
5. 远程访问：通过配置反向代理（如Nginx）或使用cpolar等工具，你可以在任何地方轻松访问和管理文档。

2.Docker部署

本例使用Ubuntu 22.04进行演示，使用Docker进行部署，如果没有安装Docker，可以查看这篇教程进行安装：《Docker安装教程——Linux、Windows、MacOS》

准备好体验Paperless-ngx的乐趣了，最简单方便的方式就是使用docker安装脚本。

需要准备一个支持Docker的环境，确保你有Docker和Docker Compose安装好。

通过将用户添加到docker用户组可以将sudo去掉，命令如下：

sudo groupadd docker

将登录用户加入到docker用户组中：

sudo gpasswd -a $USER docker

更新用户组：

newgrp docker

接着输入Paperless-ngx一键安装脚本：

bash -c "$(curl --location --silent --show-error https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

可以看到下方开始有提示，URL这里我回车跳过了

上面几个直接回车跳过，最后一个问你是否启用Apache Tika回答yes。

上面的意思是选择OCR语言，给列出了四种语言。我这里直接回车

上面的意思是可以设置用户ID，不确定可以保留默认值，我这里直接默认回车。会出现一个group ID，我这里也一样回车跳过。

这里的意思是目标文件夹用于存放的配置文件，看一下这个路径可以的话就回车默认，也可以自行修改，我这里回车。

消费文件夹路径，我这里继续回车默认，可自行修改，上面有格式举例。

这里的意思是媒体文件夹路径，Docker通常将托管文件夹存储在我红框的路径中，我这里回车默认，可以自行修改。

数据文件夹路径，我与媒体文件夹一样留空，以便由docker管理。

进入到3登录凭证，这里输入你的Paperless用户名，密码，确认密码和邮箱。

这里是你设置完后的总结，各种文件夹路径，和用户名邮箱，按任意键继续安装。

安装完成后打开浏览器输入localhost:8000，能看到进入到paperless的登录页面了。根据刚才你自己设置的用户名和密码即可登录。

3.简单使用paperless

能看到paperless的界面还是很简洁的。

这里可以选择语言，记得点下面的save保存后刷新。

点击这里的开始导览，会教你使用paperless，好好学习哦。

我这里尝试先上传一个文件，直接在首页（仪表盘）这里点击上传，或者拖拽都可以。

几秒钟的时间，文件就会出现在“文档”菜单中。

4.安装cpolar内网穿透

不过我们目前只能在本地局域网内访问刚刚部署的paperless，如果想不在同一局域网内时，也能在外部网络环境使用手机、平板、电脑等设备远程访问与使用它，应该怎么办呢？我们可以使用cpolar内网穿透工具来实现远程访问的需求。无需公网IP，也不用准备云服务器那么麻烦。

下面是安装cpolar步骤：

Cpolar官网地址: https://www.cpolar.com

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudo systemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入ubuntu主机IP加9200端口即:【http://localhost:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

5. 配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:paperless，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：8000
• 域名类型：随机域名
• 地区：选择China Top

点击创建：

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了两个公网地址，接下来就可以在其他电脑或者移动端设备（异地）上，使用任意一个地址在浏览器中访问即可。

现在就已经成功实现使用cpolar生成的公网地址异地远程访问本地部署的paperless啦！

小结

为了方便演示，我们在上边的操作过程中使用cpolar生成的HTTP公网地址隧道，其公网地址是随机生成的。这种随机地址的优势在于建立速度快，可以立即使用。然而，它的缺点是网址是随机生成，这个地址在24小时内会发生随机变化，更适合于临时使用。

如果有长期使用paperless，或者异地访问与使用其他本地部署的服务的需求，但又不想每天重新配置公网地址，还想让公网地址好看又好记并体验更多功能与更快的带宽，那我推荐大家选择使用固定的二级子域名方式来配置公网地址。

6. 配置固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

注意需要将cpolar套餐升级至基础套餐或以上，且每个套餐对应的带宽不一样。【cpolar.cn已备案】

点击左侧的预留，选择保留二级子域名，地区选择china top，然后设置一个二级子域名名称，我这里演示使用的是paperless，大家可以自定义。填写备注信息，点击保留。

保留成功后复制保留的二级子域名地址：

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道paperless，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问本地部署的paperless页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

总结

现在你已经成功安装并配置了Paperless-ngx，是不是感觉文档管理变得轻松多了？无论是日常办公还是项目管理，它都能为你提供强大的支持。如果你需要在任何地方访问文档，cpolar是一个非常实用的工具。

Paperless-ngx 适用于那些需要系统化管理文件的个人及团队，帮助用户建立高效的文档归档与检索机制，有效减少纸质文档使用和保存压力。

特别是当你习惯了它的OCR识别与智能分类后，会发现生活和工作的确更加有条理，效率也有了质的提升。

这是一款从用户体验出发、贴心又实用的工具，想要让办公更高效的朋友们，不妨试试看吧！

当Paperless-ngx的智能管理遇上cpolar的灵活穿透，办公文档终于实现了“随时随地、安全可控”的全场景覆盖。这种组合不仅每年节省数千元云存储费用，更将文档处理的时间成本降低70%——或许，真正的无纸化办公，就该如此简单高效。

cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站

联系博主

    xcLeigh 博主，全栈领域优质创作者，博客专家，目前，活跃在CSDN、微信公众号、小红书、知乎、掘金、快手、思否、微博、51CTO、B站、腾讯云开发者社区、阿里云开发者社区等平台，全网拥有几十万的粉丝，全网统一IP为 xcLeigh。希望通过我的分享，让大家能在喜悦的情况下收获到有用的知识。主要分享编程、开发工具、算法、技术学习心得等内容。很多读者评价他的文章简洁易懂，尤其对于一些复杂的技术话题，他能通过通俗的语言来解释，帮助初学者更好地理解。博客通常也会涉及一些实践经验，项目分享以及解决实际开发中遇到的问题。如果你是开发领域的初学者，或者在学习一些新的编程语言或框架，关注他的文章对你有很大帮助。

    亲爱的朋友，无论前路如何漫长与崎岖，都请怀揣梦想的火种，因为在生活的广袤星空中，总有一颗属于你的璀璨星辰在熠熠生辉，静候你抵达。

     愿你在这纷繁世间，能时常收获微小而确定的幸福，如春日微风轻拂面庞，所有的疲惫与烦恼都能被温柔以待，内心永远充盈着安宁与慰藉。

    至此，文章已至尾声，而您的故事仍在续写，不知您对文中所叙有何独特见解？期待您在心中与我对话，开启思想的新交流。

---

     💞 关注博主 🌀 带你实现畅游前后端！

     🥇 从零到一学习Python 🌀 带你玩转Python技术流！

     🏆 人工智能学习合集 🌀 搭配实例教程与实战案例，帮你构建完整 AI 知识体系

     💦 注：本文撰写于CSDN平台,作者：xcLeigh（所有权归作者所有） ，https://xcleigh.blog.csdn.net/，如果相关下载没有跳转，请查看这个地址，相关链接没有跳转，皆是抄袭本文，转载请备注本文原地址。

---

     📣 亲，码字不易，动动小手，欢迎 点赞 ➕ 收藏，如 🈶 问题请留言（或者关注下方公众号，看见后第一时间回复，还有海量编程资料等你来领！），博主看见后一定及时给您答复 💌💌💌