【Docker部署Papra极简文件归档平台一、Papra介绍1.1 Papra简介1.2 主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取Papra镜像五、部署Papra服务5.1 创建部署目录5.2 编辑部署文件5.3 创建Papra容器5.4 查看Papra容器状态5.5 查看Papra容器日志六、访问Papra服务七、Papra基本使用7.1 上传文档7.2 查看文档信息八、总结一、Papra介绍1.1 Papra简介Papra是一个极简主义的文档管理和归档平台旨在为用户提供简单易用、可长期存储文档的解决方案。无论是个人使用还是与家人、朋友或同事协作Papra 都能帮助你轻松上传、组织和检索文档。它支持自托管部署并提供了丰富的功能来满足不同用户的需求。1.2 主要特点文档管理将你的文件集中上传、存储和管理在一个地方。组织结构创建组织方便与他人一起协同管理文档。搜索功能通过全文搜索快速找到你需要的文档内容。用户认证提供用户账户和身份验证机制保障文档安全。暗黑模式支持夜间使用的深色主题界面。响应式设计适配所有设备包括桌面端和移动端。开源免费项目完全开源任何人都可以自由使用和贡献代码。自托管支持可通过 Docker 或其他方式自行部署运行。标签系统通过标签分类整理文档提升查找效率。邮件导入将邮件或附件发送到指定地址自动导入文档。内容提取自动从图像或扫描件中提取文本以便搜索。规则标签根据自定义规则自动为文档添加标签。文件夹导入监控本地文件夹并自动导入新文档。命令行工具通过 CLI 命令行工具高效管理文档。API 和 SDK提供 API 和 SDK 支持方便二次开发和集成。多语言支持支持多种语言适应国际化用户需求。即将推出 - 文档共享允许你将文档分享给他人。即将推出 - 文档请求生成上传链接邀请他人提交文档。未来可能 - 移动应用在手机上随时访问和上传文档。未来可能 - 桌面应用通过桌面客户端更便捷地管理文档。未来可能 - 浏览器扩展直接从浏览器上传网页或文件到 Papra。未来可能 - 人工智能引入 AI 技术辅助文档管理与自动标记。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为Ubuntu 22.04.1。hostnameIP地址操作系统版本Docker版本部署项目jeven01192.168.3.88Ubuntu 22.04.1 LTS27.1.1Papra2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署Papra极简文件归档平台。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven01:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/lib/systemd/system/docker.service;enabled;vendor preset: enabled)Active: active(running)since Wed2025-07-0214:16:57 UTC;21h ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:878(dockerd)Tasks:28Memory:1.2G CPU: 1min50.356s CGroup: /system.slice/docker.service ├─878/usr/bin/dockerd-Hfd://--containerd/run/containerd/containerd.sock3.2 检查Docker版本检查Docker版本rootjeven01:~# docker -vDocker version27.1.1, build63125853.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven01:~# docker compose versionDocker Compose version v2.19.1四、拉取Papra镜像拉取Papra容器镜像如下所示dockerpull ghcr.io/papra-hq/papra:latest五、部署Papra服务5.1 创建部署目录创建部署目录mkdir-p/data/papra/data/{db,documents}cd/data/papra/修改目录权限chmod-R777/data/papra/data5.2 编辑部署文件如果想要使用docker-cli部署可参考以下命令dockerrun-d\--restartalways\--namepapra\-p1221:1221\-v$(pwd)/data:/app/app-data\-eSERVER_BASE_URLhttp://192.168.3.88:1221\ghcr.io/papra-hq/papra:latest在部署目录下创建docker-compose.yaml文件如下所示vimdocker-compose.yamlversion:3.9services:papra:image:ghcr.io/papra-hq/papra:latestenvironment:-SERVER_BASE_URLhttp://192.168.3.88:1221volumes:-/data/papra/data:/app/app-dataports:-1221:1221container_name:paprarestart:always5.3 创建Papra容器执行以下命令创建Papra容器。dockercompose up-d5.4 查看Papra容器状态检查Papra容器运行状态确保Papra容器正常启动。rootjeven01:/data/papra# docker psCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES 515a63b53532 ghcr.io/papra-hq/papra:latestdocker-entrypoint.s…8seconds ago Up7seconds0.0.0.0:1221-1221/tcp,[::]:1221-1221/tcp papra5.5 查看Papra容器日志检查Papra容器运行日志确保Papra服务正常运行。dockercompose logs六、访问Papra服务浏览器地址http://个人的服务器IP:1221访问Papra的初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。注册账号在Papra注册页自行填写账号信息进行注册。账号创建完毕后会提示创建组织这里使用默认名称后点击确认创建。七、Papra基本使用7.1 上传文档点击Papra首页的上传选项上传本地文档如下所示7.2 查看文档信息点击上传文档后我们可以查看文档的详细信息和文本内容也可选择下载文档或在线浏览。点击“ Open in new tab”选项可以在线浏览文档内容。八、总结通过Docker部署Papra能够快速实现文档管理平台的搭建简化了复杂的环境配置与依赖管理。Papra凭借其极简设计和丰富功能如全文搜索、自动标签、多设备适配为用户提供高效、安全的文档存储与检索体验。自托管特性结合开源优势让用户完全掌控数据隐私和系统扩展能力。未来随着移动应用和AI功能的完善Papra有望成为个人及团队数字化档案管理的核心工具。