在 Windows 上安装 Paperless-ngx 最推荐的方式是通过 Docker Desktop。

在 Windows 上安装 Paperless-ngx 最推荐的方式是通过Docker Desktop。它能把所有复杂的依赖数据库、OCR引擎等都打包在容器里省去很多手动配置的麻烦。下面我会分步骤为你详细拆解整个安装和配置过程。 第一步安装 Docker Desktop去 Docker 官网下载Docker Desktop for Windows安装程序 。运行安装程序。在配置选项时建议勾选 “Use WSL 2 instead of Hyper-V”这样性能更好也更省资源。安装完成后根据提示重启电脑。重启后启动 Docker Desktop。你可以在任务栏的托盘区看到它的小鲸鱼图标。初次启动可能需要登录一个 Docker Hub 账号注册一个免费账号即可。 第二步部署 Paperless-ngx我们使用docker-compose.yml文件来一次性配置和启动所有需要的服务包括应用本身、数据库和缓存。创建项目文件夹在你的电脑上新建一个文件夹比如C:\paperless这个文件夹将用来存放你的文档和配置文件。打开这个文件夹。创建docker-compose.yml文件在C:\paperless文件夹里新建一个名为docker-compose.yml的文件用记事本或其他代码编辑器打开将下面的内容完整复制进去并保存。version:3.4services:broker:image:docker.io/library/redis:7restart:unless-stoppedvolumes:-redisdata:/datadb:image:docker.io/library/postgres:13restart:unless-stoppedvolumes:-pgdata:/var/lib/postgresql/dataenvironment:POSTGRES_DB:paperlessPOSTGRES_USER:paperlessPOSTGRES_PASSWORD:paperlesswebserver:image:ghcr.io/paperless-ngx/paperless-ngx:latestrestart:unless-stoppeddepends_on:-db-brokerports:-8000:8000volumes:-data:/usr/src/paperless/data-media:/usr/src/paperless/media-./export:/usr/src/paperless/export-./consume:/usr/src/paperless/consumeenvironment:PAPERLESS_REDIS:redis://broker:6379PAPERLESS_DBHOST:dbPAPERLESS_DBNAME:paperlessPAPERLESS_DBUSER:paperlessPAPERLESS_DBPASS:paperlessvolumes:data:media:pgdata:redisdata:启动容器打开 PowerShell 或命令提示符进入C:\paperless目录然后运行以下命令dockercompose up-d这条命令会自动从网上下载所需的镜像并启动服务你可以在命令行窗口看到下载进度 。⚙️ 第三步初始化与配置服务启动后还需要最后一步来创建管理员账户。创建管理员账户在同一个 PowerShell 窗口中执行以下命令并按提示输入你想要的用户名、邮箱和密码 dockercompose run--rmwebserver createsuperuser验证并登录打开你的浏览器访问http://localhost:8000。你应该能看到 Paperless-ngx 的登录界面 。用上一步创建的管理员账户登录就能进入你的个人文档中心了。 进阶配置与目录说明为了让 Paperless-ngx 更好地为你服务还有两个小地方可以优化一下。消费目录 (Consumption Directory)这是最方便的功能。只要把文件比如扫描好的PDF放进C:\paperless\consume这个文件夹Paperless-ngx 就会自动处理、OCR并归档 。支持中文OCR如果你的文档主要是中文的需要安装中文语言包。在 PowerShell 中运行以下命令进入容器并安装 # 进入容器内部dockercomposeexecwebserverbash# 在容器内执行安装简体中文OCR语言包python manage.py document_install_languages zh-hans之后在网页端的设置 (Settings) 通用 (General)中把OCR 语言 (OCR Language)改成chi_sim即可。目录/卷作用备注C:\paperless\consume消费目录把文档放进去系统会自动处理C:\paperless\export导出目录用于导出文档备份Docker 卷存储数据库和原始文件位于 Docker 虚拟机内请定期通过网页端导出功能备份希望这份指南能帮你顺利搭建起自己的文档管理系统。关于系统维护、自动备份或者中文搜索等更深入的功能如果需要了解随时可以再来问我