本地部署ScanYourPDFUbuntu与macOS环境搭建完整教程【免费下载链接】scanyourpdfRepository for the Scan Your Pdf community项目地址: https://gitcode.com/gh_mirrors/sc/scanyourpdfScanYourPDF 是一个能把普通 PDF 变成扫描效果的开源工具它的核心功能是给电子文档添加轻微旋转、噪点、灰度与模糊处理让打印出来的文件看起来像是用扫描仪扫描过的原件。本教程将带你完成ScanYourPDF 本地部署涵盖Ubuntu 部署步骤与macOS 安装方法即使是新手也能照着一步步跑通全流程。一分钟了解 ScanYourPDF 能做什么 很多场合需要看起来像扫描件的 PDF提交证明材料、论文签名、存档文件。ScanYourPDF 通过ImageMagick Ghostscript两个命令行工具自动完成仿真扫描处理整个过程无需人工干预效果说明 灰度化彩色页面转为灰度模拟扫描质感 轻微旋转页面随机旋转约 0.5°~1°更贴近真实扫描️ 噪点与模糊添加高斯噪声与微模糊去除电子感️ 体积优化用 Ghostscript 压缩图片化后的 PDF避免体积爆炸 项目核心逻辑集中在 scanned_pdf.sh 脚本与 pdfwebsite/views.py 的processPDF函数中感兴趣可以对照源码学习。部署前的环境要求清单 ✅在开始ScanYourPDF 环境搭建之前请先确认你的机器满足以下条件Python 3.6项目基于 Django 3.1pip 与 venvPython 虚拟环境工具ImageMagickPDF 转图片的核心工具Ghostscript图片压缩回 PDF 的工具下面的章节会分别给出Ubuntu 安装步骤和macOS 安装步骤请根据你的系统选择对应部分。Ubuntu 部署步骤一键安装系统依赖第一步安装 Ghostscript 与 ImageMagick在 Ubuntu / Debian 系系统上使用 apt 即可快速完成依赖安装sudo apt-get update sudo apt-get install ghostscript sudo apt-get install imagemagick第二步修改 ImageMagick 的 PDF 策略关键Ubuntu 上 ImageMagick 出于安全考虑默认禁止处理 PDF如果跳过这一步转换时会直接报错。请编辑策略文件sudo nano /etc/ImageMagick-6/policy.xml找到这一行policy domaincoder rightsnone patternPDF /将其修改为policy domaincoder rightsread|write patternPDF /⚠️ 安全提示此修改会放开 PDF 读写权限仅供本地测试使用生产环境请评估风险。macOS 部署步骤Homebrew 一条龙安装macOS 用户使用Homebrew安装依赖与 Ubuntu 相比更加简单brew install ghostscript brew install imagemagick安装完成后程序会自动在/usr/local/bin/gs与/usr/local/bin/convert中定位工具。路径配置逻辑位于 convertpdf/settings.py如果你使用 Apple Silicon路径为/opt/homebrew需要手动修改该文件中GHOSTSCRIPT_PATH与CONVERT_PATH两个变量。启动 Django 网站服务 依赖装好后接下来克隆仓库并初始化 Python 环境git clone https://gitcode.com/gh_mirrors/sc/scanyourpdf cd scanyourpdf python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt然后初始化数据库并启动开发服务器python manage.py migrate python manage.py runserver浏览器访问http://127.0.0.1:8000即可看到ScanYourPDF 上传页面选择 PDF 文件后就能生成扫描效果文档了 项目自带定时清理任务 pdfwebsite/management/commands/cleanfiles.py会删除超过 1 小时的历史文件避免磁盘堆积。不依赖网页直接用命令行转换 ⚡如果你只想快速转换单个 PDF可以不启动网站直接使用核心脚本scanned_pdf.shchmod x ./scanned_pdf.sh ./scanned_pdf.sh 你的文件.pdf脚本默认输出document_flat.pdf也可以指定输出文件名./scanned_pdf.sh -o output.pdf 你的文件.pdf转换过程大约每页 2~3 秒期间会依次执行 ImageMagick 的灰度、旋转、加噪处理再用 Ghostscript 压缩体积两步逻辑都集中在 scanned_pdf.sh 中。进阶方案Docker 容器化部署 不想污染宿主机环境项目提供了现成的 Dockerfile 与 docker-compose.yml容器内已经预装 Ghostscript、ImageMagick 并自动修改了 PDF 策略docker-compose build docker-compose run --rm app ./scanned_pdf.sh -o output.pdf input.pdfDocker 方式对 Ubuntu 和 macOS 都适用是最快的 ScanYourPDF 部署方法推荐给不想折腾系统依赖的读者。常见问题排查 问题解决方案convert: not authorized ... PDF报错按上文第二步修改 ImageMagick 策略文件gs: command not found重新执行 ghostscript 安装命令macOS 下找不到 convert检查 Homebrew 安装是否成功并确认 settings.py 中的路径上传超过 10 页被拒绝项目默认限制单文件 10 页、50MB详见 pdfwebsite/views.py总结通过本教程你已经掌握了ScanYourPDF 在 Ubuntu 与 macOS 上的本地部署全流程装依赖、改策略、建环境、起服务还学会了命令行直转与 Docker 两种备用方案。整个过程 10 分钟内即可完成快去把你的电子文档变成以假乱真的扫描件吧✍️【免费下载链接】scanyourpdfRepository for the Scan Your Pdf community项目地址: https://gitcode.com/gh_mirrors/sc/scanyourpdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 本地部署ScanYourPDF：Ubuntu与macOS环境搭建完整教程
本地部署ScanYourPDFUbuntu与macOS环境搭建完整教程【免费下载链接】scanyourpdfRepository for the Scan Your Pdf community项目地址: https://gitcode.com/gh_mirrors/sc/scanyourpdfScanYourPDF 是一个能把普通 PDF 变成扫描效果的开源工具它的核心功能是给电子文档添加轻微旋转、噪点、灰度与模糊处理让打印出来的文件看起来像是用扫描仪扫描过的原件。本教程将带你完成ScanYourPDF 本地部署涵盖Ubuntu 部署步骤与macOS 安装方法即使是新手也能照着一步步跑通全流程。一分钟了解 ScanYourPDF 能做什么 很多场合需要看起来像扫描件的 PDF提交证明材料、论文签名、存档文件。ScanYourPDF 通过ImageMagick Ghostscript两个命令行工具自动完成仿真扫描处理整个过程无需人工干预效果说明 灰度化彩色页面转为灰度模拟扫描质感 轻微旋转页面随机旋转约 0.5°~1°更贴近真实扫描️ 噪点与模糊添加高斯噪声与微模糊去除电子感️ 体积优化用 Ghostscript 压缩图片化后的 PDF避免体积爆炸 项目核心逻辑集中在 scanned_pdf.sh 脚本与 pdfwebsite/views.py 的processPDF函数中感兴趣可以对照源码学习。部署前的环境要求清单 ✅在开始ScanYourPDF 环境搭建之前请先确认你的机器满足以下条件Python 3.6项目基于 Django 3.1pip 与 venvPython 虚拟环境工具ImageMagickPDF 转图片的核心工具Ghostscript图片压缩回 PDF 的工具下面的章节会分别给出Ubuntu 安装步骤和macOS 安装步骤请根据你的系统选择对应部分。Ubuntu 部署步骤一键安装系统依赖第一步安装 Ghostscript 与 ImageMagick在 Ubuntu / Debian 系系统上使用 apt 即可快速完成依赖安装sudo apt-get update sudo apt-get install ghostscript sudo apt-get install imagemagick第二步修改 ImageMagick 的 PDF 策略关键Ubuntu 上 ImageMagick 出于安全考虑默认禁止处理 PDF如果跳过这一步转换时会直接报错。请编辑策略文件sudo nano /etc/ImageMagick-6/policy.xml找到这一行policy domaincoder rightsnone patternPDF /将其修改为policy domaincoder rightsread|write patternPDF /⚠️ 安全提示此修改会放开 PDF 读写权限仅供本地测试使用生产环境请评估风险。macOS 部署步骤Homebrew 一条龙安装macOS 用户使用Homebrew安装依赖与 Ubuntu 相比更加简单brew install ghostscript brew install imagemagick安装完成后程序会自动在/usr/local/bin/gs与/usr/local/bin/convert中定位工具。路径配置逻辑位于 convertpdf/settings.py如果你使用 Apple Silicon路径为/opt/homebrew需要手动修改该文件中GHOSTSCRIPT_PATH与CONVERT_PATH两个变量。启动 Django 网站服务 依赖装好后接下来克隆仓库并初始化 Python 环境git clone https://gitcode.com/gh_mirrors/sc/scanyourpdf cd scanyourpdf python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt然后初始化数据库并启动开发服务器python manage.py migrate python manage.py runserver浏览器访问http://127.0.0.1:8000即可看到ScanYourPDF 上传页面选择 PDF 文件后就能生成扫描效果文档了 项目自带定时清理任务 pdfwebsite/management/commands/cleanfiles.py会删除超过 1 小时的历史文件避免磁盘堆积。不依赖网页直接用命令行转换 ⚡如果你只想快速转换单个 PDF可以不启动网站直接使用核心脚本scanned_pdf.shchmod x ./scanned_pdf.sh ./scanned_pdf.sh 你的文件.pdf脚本默认输出document_flat.pdf也可以指定输出文件名./scanned_pdf.sh -o output.pdf 你的文件.pdf转换过程大约每页 2~3 秒期间会依次执行 ImageMagick 的灰度、旋转、加噪处理再用 Ghostscript 压缩体积两步逻辑都集中在 scanned_pdf.sh 中。进阶方案Docker 容器化部署 不想污染宿主机环境项目提供了现成的 Dockerfile 与 docker-compose.yml容器内已经预装 Ghostscript、ImageMagick 并自动修改了 PDF 策略docker-compose build docker-compose run --rm app ./scanned_pdf.sh -o output.pdf input.pdfDocker 方式对 Ubuntu 和 macOS 都适用是最快的 ScanYourPDF 部署方法推荐给不想折腾系统依赖的读者。常见问题排查 问题解决方案convert: not authorized ... PDF报错按上文第二步修改 ImageMagick 策略文件gs: command not found重新执行 ghostscript 安装命令macOS 下找不到 convert检查 Homebrew 安装是否成功并确认 settings.py 中的路径上传超过 10 页被拒绝项目默认限制单文件 10 页、50MB详见 pdfwebsite/views.py总结通过本教程你已经掌握了ScanYourPDF 在 Ubuntu 与 macOS 上的本地部署全流程装依赖、改策略、建环境、起服务还学会了命令行直转与 Docker 两种备用方案。整个过程 10 分钟内即可完成快去把你的电子文档变成以假乱真的扫描件吧✍️【免费下载链接】scanyourpdfRepository for the Scan Your Pdf community项目地址: https://gitcode.com/gh_mirrors/sc/scanyourpdf创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考