chekuhakim/paperweight

Paperweight：自托管开源PDF压缩工具

镜像概述和主要用途

Paperweight是一个自托管的开源PDF压缩工具，基于Python和Bottle构建。它允许用户在自己的服务器上轻松压缩PDF文件，无需依赖外部服务。该工具利用Ghostscript实现高效且可定制的压缩，确保数据隐私和完全控制。

核心功能和特性

• 无损与有损压缩：支持无损压缩（保持最高质量）和有损压缩（获得更小文件大小），提供不同压缩级别选择。
• 可定制设置：通过Ghostscript参数微调压缩配置，实现文件大小与质量的平衡。
• 自托管架构：数据完全本地处理，避免第三方服务依赖，保障隐私安全。
• 简洁Web界面：直观的上传和压缩操作流程，无需专业知识即可快速使用。
• Docker化部署：支持Docker容器化部署，简化安装和环境配置过程。

使用场景和适用范围

• 处理敏感PDF文件的个人用户，需确保数据不经过外部服务。
• 企业或组织内部文档压缩需求，要求数据本地存储和处理。
• 需要自定义压缩参数以平衡文件大小和质量的场景。
• 希望快速部署且低维护成本的PDF压缩解决方案。

使用方法和配置说明

安装方式

选项1：Docker（推荐）

1. 拉取Docker镜像：

   bash
   docker pull chekuhakim/paperweight
   

2. 运行容器：

   bash
   docker run -p 8000:8000 chekuhakim/paperweight
   

3. 访问Web界面：打开浏览器，导航至http://localhost:8000/（服务器环境需替换为对应IP地址和端口）。

选项2：手动安装

1. 克隆仓库：

   bash
   git clone https://github.com/chekuhakim/paperweight.git
   

2. 安装依赖：
   • 确保已安装Python 3.7+
   • 安装所需包：

     bash
     pip install bottle ghostscript
     

3. 运行应用：

   bash
   python paperweight.py
   

4. 访问Web界面：打开浏览器，导航至http://localhost:1234/（服务器环境需替换为对应IP地址和端口）。

使用步骤

1. 上传PDF文件：通过Web界面的文件上传按钮选择需要压缩的PDF文件。
2. 选择压缩级别：使用滑块或输入框设置压缩级别，数值越高文件越小，但可能影响质量。
3. 启动压缩：点击"Compress"按钮开始压缩过程。
4. 下载结果：压缩完成后，系统将自动下载压缩后的PDF文件。

注意事项

• Docker镜像已包含所有必要依赖（Python、Bottle、Ghostscript），无需额外安装。
• 可通过调整docker run命令中的端口映射（如-p 8080:8000）修改访问端口。
• 手动安装时需确保Ghostscript已正确安装并配置环境变量，可在paperweight.py中调整端口和主机地址。
• 提供的index.html模板可根据需求自定义Web界面样式。