从零开始在Linux服务器上通过Docker部署PDF3MD全攻略一、PDF3MD介绍1.1 PDF3MD简介1.2 PDF3MD主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取PDF3MD镜像五、部署PDF3MD服务5.1 创建部署目录5.2 docker compose方式部署5.3 创建PDF3MD容器5.4 查看PDF3MD容器状态5.5 检查PDF3MD容器日志六、访问PDF3MD服务6.1 访问PDF3MD首页6.2 文档转化七、总结一、PDF3MD介绍1.1 PDF3MD简介PDF3MD是一款基于 Web 的文档转换工具采用 React 前端与 Python Flask 后端架构专注于将 PDF 文件高效、准确地转换为结构清晰的 Markdown 和 Microsoft WordDOCX格式并提供实时进度反馈与友好的用户交互体验。1.2 PDF3MD主要特点PDF 转 Markdown将 PDF 文档智能转换为结构清晰、可读性强的 Markdown 格式。Markdown 转 DOCX利用 Pandoc 将 Markdown 内容高保真地导出为 Word.docx文件。多文件上传支持同时上传并批量处理多个 PDF 文件提升转换效率。拖拽上传界面提供拖放或传统选择两种方式简化文件上传操作。实时进度跟踪在转换过程中为每个文件提供详细的实时状态更新。文件信息展示清晰显示原始文件名、大小、页数及转换时间等元数据。现代响应式 UI界面简洁直观适配桌面与移动设备确保跨平台良好体验。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为 Ubuntu 24.04.2 LTS。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.5.0PDF3MD——2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署PDF转Markdown工具PDF3MD。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Tue2025-12-02 00:51:31 CST;1min 11s ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:75393(dockerd)Tasks:32Memory:34.1M(peak:34.8M)CPU:1.248s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.5.0, build 887030f3.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven:~# docker compose versionDocker Compose version v2.39.4四、拉取PDF3MD镜像下载PDF3MD镜像执行以下命令dockerpull registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latestdockerpull registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latest五、部署PDF3MD服务5.1 创建部署目录创建部署目录mkdir-p/data/pdf3md/datacd/data/pdf3md目录权限设置chmod-R777/data/pdf3md5.2 docker compose方式部署新建及编辑docker-compose.yaml文件宿主机映射端口可自行设置注意防止端口冲突。vimdocker-compose.yamlservices:backend:image:registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latestcontainer_name:pdf3md-backendrestart:unless-stoppedports:-6201:6201volumes:-./data:/app/tempenvironment:-PYTHONUNBUFFERED1-FLASK_ENVproduction-TZAsia/Shanghaihealthcheck:test:[CMD,curl,-f,http://localhost:6201/]interval:30stimeout:10sretries:3start_period:40sfrontend:image:registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latestcontainer_name:pdf3md-frontendrestart:unless-stoppedports:-9960:3000environment:{}depends_on:-backendhealthcheck:test:[CMD,wget,--no-verbose,--tries1,--spider,http://localhost:3000/]interval:30stimeout:10sretries:3start_period:40s5.3 创建PDF3MD容器执行以下命令创建PDF3MD容器。dockercompose up-d5.4 查看PDF3MD容器状态检查PDF3MD容器运行状态确保PDF3MD容器正常启动。rootjeven:/data/pdf3md# docker compose psNAME IMAGE COMMAND SERVICE CREATED STATUS PORTS pdf3md-backend registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-backend:latestpython app.pybackend39seconds ago Up38seconds(health: starting)0.0.0.0:6201-6201/tcp,[::]:6201-6201/tcp pdf3md-frontend registry.cn-hangzhou.aliyuncs.com/jeson/pdf3md-frontend:latestdocker-entrypoint.s…frontend39seconds ago Up38seconds(healthy)0.0.0.0:9960-3000/tcp,[::]:9960-3000/tcp5.5 检查PDF3MD容器日志检查容器运行日志确保PDF3MD服务正常运行。dockercompose logs六、访问PDF3MD服务6.1 访问PDF3MD首页浏览器地址http://个人的服务器IP:9960访问PDF3MD初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。6.2 文档转化将测试PDF文档转化为Markdown格式文档效果如下七、总结本次实践通过 Docker 成功部署了 PDF3MD验证了其作为一款轻量级 PDF 转 Markdown/DOCX 工具的便捷性与实用性。借助 Docker Compose前后端服务快速启动无需手动配置复杂依赖极大简化了部署流程。PDF3MD 提供的拖拽上传、多文件处理和实时进度反馈功能显著提升了文档转换效率和用户体验。