【亲测免费】 Paperless-ngx 开源项目常见问题解决方案

1. 项目基础介绍和主要编程语言

项目介绍： Paperless-ngx 是一个文档管理系统，它可以将您的实体文档转换为一个可搜索的在线存档，帮助您减少纸张的使用。它是原始的 Paperless 和 Paperless-ng 项目的官方继承者，旨在将推进和支持项目的责任分布在多个团队成员之间。

主要编程语言： 该项目主要使用 Python 编程语言。

---

2. 新手在使用这个项目时需要特别注意的3个问题和详细解决步骤

问题1：如何安装 Paperless-ngx

问题描述： 新手可能不清楚如何正确安装 Paperless-ngx。

解决步骤：

1. 使用 Docker Compose 安装：

   • 确保您的系统已安装 Docker 和 Docker Compose。
   • 使用以下命令下载并运行安装脚本：

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

   • 安装脚本会自动配置并启动 Docker Compose 服务。

2. 手动安装：

   • 克隆项目仓库到本地：

     git clone https://github.com/paperless-ngx/paperless-ngx.git
     

   • 进入项目目录并安装依赖：

     cd paperless-ngx
     pip install -r requirements.txt
     

   • 运行项目：

     python manage.py runserver
     

问题2：如何配置数据库

问题描述： 项目默认使用 SQLite 数据库，但用户可能需要使用其他数据库。

解决步骤：

1. 更改 paperless.conf 文件中的数据库设置：

   • 打开 paperless.conf 文件。
   • 更改 DATABASES 部分的配置，例如使用 PostgreSQL：

     DATABASES = {
         'default': {
             'ENGINE': 'django.db.backends.postgresql',
             'NAME': 'paperless',
             'USER': 'paperlessuser',
             'PASSWORD': 'paperlesspassword',
             'HOST': 'localhost',
             'PORT': '5432',
         }
     }
     

2. 安装数据库依赖：

   • 对于 PostgreSQL，您需要安装 psycopg2：

     pip install psycopg2
     

问题3：如何导入文档和扫描件

问题描述： 用户可能不清楚如何将实体文档或扫描件导入系统。

解决步骤：

1. 使用文件上传功能：

   • 登录 Paperless-ngx 系统后台。
   • 在文档管理页面，找到上传按钮。
   • 选择要上传的文件，支持多种文件格式，如 PDF、JPEG 等。

2. 使用扫描件：

   • 如果您有扫描仪，可以使用扫描软件将文档扫描为 PDF 或图片格式。
   • 使用上述文件上传功能将扫描件导入系统。

通过以上步骤，新手用户可以顺利开始使用 Paperless-ngx 项目，并解决常见的配置和使用问题。