使用 Docker / Docker Compose 部署 PdfDing —— 个人 PDF笔记

PdfDing 是一款开源的PDF 文档管理与阅读工具，支持标签分类、全文检索、暗色主题等实用功能，非常适合用于搭建个人或小团队的 PDF 资料库。本文将手把手教你通过两种主流方式快速部署 PdfDing：

• 方式一：docker run（适合快速体验）
• 方式二：docker-compose（推荐用于长期使用）

一、环境准备

在开始部署前，请确保你的系统满足以下条件：

• 操作系统：Linux / macOS / Windows（建议使用 WSL2）
• 已安装Docker ≥ 20.x
• （可选）已安装Docker Compose ≥ 2.x

验证 Docker 是否正常工作：

dockerversion

若未安装，请参考 Docker 官方安装指南。

二、方式一：使用docker run快速启动（适合测试）

1️⃣ 启动命令

dockerrun --name pdfding\-p8000:8000\-v sqlite_data:/home/nonroot/pdfding/db\-v media:/home/nonroot/pdfding/media\-eHOST_NAME=127.0.0.1\-eSECRET_KEY=some_secret\-eCSRF_COOKIE_SECURE=FALSE\-eSESSION_COOKIE_SECURE=FALSE\-d\mrmn/pdfding:latest

2️⃣ 参数说明

3️⃣ 访问服务

打开浏览器，访问：

http://127.0.0.1:8000

即可看到 PdfDing 的界面，开始上传和管理你的 PDF 文档！

三、方式二：使用 Docker Compose 部署（推荐 ✅）

Docker Compose 提供更清晰的配置结构，便于版本控制、备份和升级，强烈推荐用于日常使用或团队部署。

1️⃣ 创建docker-compose.yml

version:"3.8"services:pdfding:container_name:pdfdingimage:mrmn/pdfding:latestports:-"8000:8000"volumes:-sqlite_data:/home/nonroot/pdfding/db-media:/home/nonroot/pdfding/mediaenvironment:# 主题设置-DEFAULT_THEME=${DEFAULT_THEME:-dark}-DEFAULT_THEME_COLOR=${DEFAULT_THEME_COLOR:-blue}# 安全与配置-SECRET_KEY=${SECRET_KEY:-change_me_to_a_strong_random_string}-HOST_NAME=${HOST_NAME:-127.0.0.1}# 生产环境建议启用 HTTPS 后设为 TRUE-CSRF_COOKIE_SECURE=${CSRF_COOKIE_SECURE:-FALSE}-SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-FALSE}restart:unless-stoppedvolumes:sqlite_data:media:

💡 建议同时创建.env文件管理敏感配置（如SECRET_KEY），避免硬编码。

2️⃣ 启动服务

在docker-compose.yml所在目录执行：

dockercompose up -d

查看运行状态：

dockercomposeps

3️⃣ 访问应用

浏览器打开：

http://127.0.0.1:8000

现在你拥有了一个功能完整的 PDF 管理平台！

四、常用运维命令

五、生产环境安全建议（重要！）

如果你计划在内网或公网长期使用 PdfDing，请务必：

1. 更换SECRET_KEY：使用openssl rand -hex 32生成强密钥。
2. 启用 HTTPS：
   • 通过 Nginx + Let’s Encrypt（公网）
   • 或使用私有 CA（如 step-ca，适用于内网）
3. 设置安全 Cookie：

   CSRF_COOKIE_SECURE=TRUE SESSION_COOKIE_SECURE=TRUE

4. 限制访问 IP（如仅允许公司内网）
5. 定期备份db和media数据卷

六、总结

PdfDing 轻量、开源、功能聚焦，是构建个人笔记的最佳选择。