Paperless部署&使用

0 阅读3分钟

简介

Paperless 是 Github 上一款开源的文件管理系统,顾名思义,Paperless(paper,纸,-less,没有)意思是无纸化。

本文介绍如何本地部署 Paperless。

在这里插入图片描述

本地部署

(1)准备

采用 Docker-Compose 部署,Windows 操作系统下载一个 Docker-Desktop,安装后自带 Docker-Compose 环境。

本地学习的话,Docker-Desktop 非常方便,支持界面化操作容器和镜像。

下载地址:docs.docker.com/desktop/set…

下载下来后,双击安装包,根据指示一步一步安装即可。

安装好后,在本地 Windows 操作系统上就有 Docker 和 Docker-Compose 环境。

在这里插入图片描述

(2)更改 Docker-Compose 文件

Paperless 提供了好几个版本的 Docker-Compose 文件(github.com/paperless-n…

根据需要下载,我这里下载 postgresql 版本的

在这里插入图片描述

下载下来后,不能直接用,要改名为 docker-compose.yml,Docker-Compose 只认这个文件

另外,改一下文件地址为本地某位置(我这里设置 D:/dev/paperless),不然它会在当前所在目录创建文件夹

services:
  broker:
    image: docker.io/library/redis:8
    restart: unless-stopped
    volumes:
      - redisdata:/data
  db:
    image: docker.io/library/postgres:18
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperless
      POSTGRES_PASSWORD: paperless
  webserver:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    restart: unless-stopped
    depends_on:
      - db
      - broker
    ports:
      - "8000:8000"
    volumes:
      - data:/usr/src/paperless/data
      - media:/usr/src/paperless/media
      - D:/dev/paperless/export:/usr/src/paperless/export
      - D:/dev/paperless/consume:/usr/src/paperless/consume
    env_file: docker-compose.env
    environment:
      PAPERLESS_REDIS: redis://broker:6379
      PAPERLESS_DBHOST: db
volumes:
  data:
  media:
  pgdata:
  redisdata:

另外,这个 docker-compose.env 这个文件也要下载下来,和 docker-compose.yml 文件放一块

在这里插入图片描述

如下

在这里插入图片描述

(3)启动

在 docker-compose.yml 所在目录,打开命令窗口,敲下面的命令启动容器

docker-compose up -d

首次会先拉取镜像,会比较慢,后面镜像已经拉过了,直接启动容器就很快

在这里插入图片描述

打开 Docker-Desktop,可以看到这三个容器,一个 Redis、一个数据库,一个应用

直接点击应用绑定的端口号

在这里插入图片描述

顺利打开登录界面,说明部署完成了

在这里插入图片描述

如果不成功,可以直接点击容器看看日志,看是不是端口有冲突还是什么

在这里插入图片描述

使用

设置完管理员账户后,直接登录,界面还不错,清新、简洁

在这里插入图片描述

(1)上传文件

上传文件,可以点 仪表盘/上传文件,或者手动将文件拖进来

在这里插入图片描述

上传后,会在右下角产生一个任务进度

在这里插入图片描述

(2)文件操作

文档 中能找到刚刚上传的这张图片,双击图片可进入详情

在这里插入图片描述

点开详情,发现它的内容竟然是可编辑的

这说明上传图片后,系统有自动解析图片,有做 OCR,自动识别了图片中的文字

在这里插入图片描述

左上角有 发送 操作,可以生成链接分享给其他人,别人可以直接在浏览器上访问该图片(类似 OSS 的预览链接)

在这里插入图片描述

(3)视图

可以根据某次查询,生成视图 在这里插入图片描述

并展示在左侧,方便查看,注意哦,视图不同于分类,如果下次有符合查询条件的文件加进来,视图是会自动更新的

在这里插入图片描述

更多功能,大家自行挖掘……

评价

优点:

  • 能自动解析文件内容,并可根据文件内容查询;

  • 可以自动排除重复文件,空文件夹;

缺点:

  • 因为上传后需要解析文件,上传的文件一多,会开启很多解析任务,影响使用其他功能;