使用 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 是否正常工作：

docker version

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

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

1️⃣ 启动命令

docker run –name pdfding \\
-p 8000:8000 \\
-v sqlite_data:/home/nonroot/pdfding/db \\
-v media:/home/nonroot/pdfding/media \\
-e HOST_NAME=127.0.0.1 \\
-e SECRET_KEY=some_secret \\
-e CSRF_COOKIE_SECURE=FALSE \\
-e SESSION_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: pdfding
image: mrmn/pdfding:latest
ports:
– "8000:8000"
volumes:
– sqlite_data:/home/nonroot/pdfding/db
– media:/home/nonroot/pdfding/media
environment:
# 主题设置
– 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–stopped

volumes:
sqlite_data:
media:

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

2️⃣ 启动服务

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

docker compose up -d

查看运行状态：

docker compose ps

3️⃣ 访问应用

浏览器打开：

http://127.0.0.1:8000

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

四、常用运维命令

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

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

六、总结

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