简介
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)视图
可以根据某次查询,生成视图
并展示在左侧,方便查看,注意哦,视图不同于分类,如果下次有符合查询条件的文件加进来,视图是会自动更新的
更多功能,大家自行挖掘……
评价
优点:
-
能自动解析文件内容,并可根据文件内容查询;
-
可以自动排除重复文件,空文件夹;
缺点:
- 因为上传后需要解析文件,上传的文件一多,会开启很多解析任务,影响使用其他功能;