10分钟上手PdfDing：Docker快速部署教程

【免费下载链接】PdfDing Selfhosted PDF manager, viewer and editor offering a seamless user experience on multiple devices. 项目地址: https://gitcode.com/gh_mirrors/pd/PdfDing

PdfDing是一款功能强大的自托管PDF管理工具，支持PDF文件的管理、查看和编辑，让你在多设备上都能获得无缝的用户体验。通过Docker部署，你可以在短短10分钟内搭建起属于自己的PDF管理系统。

📋 准备工作

在开始部署前，请确保你的系统已安装以下工具：

• Docker
• Docker Compose

如果尚未安装，可以参考Docker官方文档进行安装配置。

🚀 快速部署步骤

1. 克隆项目代码

首先，克隆PdfDing项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/pd/PdfDing
cd PdfDing

2. 选择部署模式

PdfDing提供了两种Docker Compose配置文件，分别适用于不同的数据库需求：

• compose/sqlite.docker-compose.yaml - 使用SQLite数据库，适合个人使用或小规模部署
• compose/postgres.docker-compose.yaml - 使用PostgreSQL数据库，适合团队使用或需要更高性能的场景

3. 启动服务

这里以SQLite配置为例，执行以下命令启动服务：

docker-compose -f compose/sqlite.docker-compose.yaml up -d

4. 访问PdfDing

服务启动后，打开浏览器访问 http://127.0.0.1:8000 即可进入PdfDing系统。

⚙️ 配置说明

SQLite配置文件主要包含以下关键参数：

services:
  pdfding:
    container_name: pdfding
    image: mrmn/pdfding:latest
    volumes:
      - sqlite_data:/home/nonroot/pdfding/db
      - media:/home/nonroot/pdfding/media
    environment:
      - DEFAULT_THEME=${DEFAULT_THEME:-dark}
      - DEFAULT_THEME_COLOR=${DEFAULT_THEME_COLOR:-green}
      - SECRET_KEY=${SECRET_KEY:-some_long_random_secret}
      - HOST_NAME=${HOST_NAME:-127.0.0.1}
      - CSRF_COOKIE_SECURE=${CSRF_COOKIE_SECURE:-FALSE}
      - SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-FALSE}
    ports:
      - "8000:8000"

主要配置项说明：

• DEFAULT_THEME - 默认主题，可选值：light/dark
• DEFAULT_THEME_COLOR - 默认主题颜色，可选值：green/blue/red等
• SECRET_KEY - 安全密钥，建议生产环境中设置为随机字符串
• HOST_NAME - 访问域名，默认为127.0.0.1
• ports - 端口映射，默认为8000端口

🔧 常见问题解决

服务无法启动？

1. 检查Docker和Docker Compose是否已正确安装
2. 检查端口是否被占用，可修改配置文件中的端口映射
3. 查看日志获取详细错误信息：

docker-compose -f compose/sqlite.docker-compose.yaml logs

如何更新PdfDing？

docker-compose -f compose/sqlite.docker-compose.yaml down
docker pull mrmn/pdfding:latest
docker-compose -f compose/sqlite.docker-compose.yaml up -d

🎉 开始使用PdfDing

部署完成后，你可以：

• 上传和管理PDF文件
• 使用内置的PDF查看器查看文件
• 添加注释和标记
• 创建收藏夹和标签分类文件

现在，你已经成功部署了PdfDing，开始体验这款强大的PDF管理工具吧！

【免费下载链接】PdfDing Selfhosted PDF manager, viewer and editor offering a seamless user experience on multiple devices. 项目地址: https://gitcode.com/gh_mirrors/pd/PdfDing