YoutubeDL-Material 项目 Docker 部署指南

项目概述

YoutubeDL-Material 是一个基于 Web 的视频下载工具，提供了友好的用户界面和丰富的功能。通过 Docker 容器化部署，可以轻松搭建自己的视频下载服务平台。本文将详细介绍如何使用 Docker Compose 部署 YoutubeDL-Material 项目。

环境准备

在开始部署前，请确保您的系统已安装以下组件：

1. Docker 引擎
2. Docker Compose

建议使用较新版本的 Docker，以获得最佳兼容性和性能。

部署架构解析

YoutubeDL-Material 采用了两层服务架构：

1. 主应用服务 (ytdl_material)：提供 Web 界面和下载功能
2. 数据库服务 (ytdl-mongo-db)：使用 MongoDB 存储应用数据

这种分离式设计提高了系统的可维护性和扩展性。

配置文件详解

主应用服务配置

ytdl_material:
    environment: 
        ytdl_mongodb_connection_string: 'mongodb://ytdl-mongo-db:27017'
        ytdl_use_local_db: 'false'
        write_ytdl_config: 'true'
    restart: always
    depends_on:
        - ytdl-mongo-db
    volumes:
        - ./appdata:/app/appdata
        - ./audio:/app/audio
        - ./video:/app/video
        - ./subscriptions:/app/subscriptions
        - ./users:/app/users
    ports:
        - "8998:17442"
    image: tzahi12345/youtubedl-material:latest

关键配置说明：

1. 环境变量：

   • ytdl_mongodb_connection_string：指定 MongoDB 连接字符串
   • ytdl_use_local_db：设置为 false 表示使用外部 MongoDB 服务
   • write_ytdl_config：允许写入配置文件

2. 卷挂载：

   • appdata：存储应用配置数据
   • audio：下载的音频文件存储目录
   • video：下载的视频文件存储目录
   • subscriptions：订阅相关数据
   • users：用户数据

3. 端口映射：

   • 将容器内部的 17442 端口映射到主机的 8998 端口

数据库服务配置

ytdl-mongo-db:
    image: mongo:4
    logging:
        driver: "none"          
    container_name: mongo-db
    restart: always
    volumes:
        - ./db/:/data/db

关键配置说明：

1. 镜像选择：

   • 使用 MongoDB 4.x 版本
   • 对于 Raspberry Pi 等 ARM 设备，建议使用 mongo:4.4.18

2. 日志配置：

   • 禁用日志记录以减少资源占用

3. 数据持久化：

   • 将 MongoDB 数据目录挂载到主机的 ./db 目录

部署步骤

1. 创建项目目录并进入：

   mkdir youtubedl-material && cd youtubedl-material
   

2. 创建 docker-compose.yml 文件，将上述配置内容复制进去

3. 启动服务：

   docker-compose up -d
   

4. 等待容器启动完成后，访问 http://你的服务器IP:8998 即可使用

数据管理

所有重要数据都通过卷挂载方式存储在主机上：

• 应用数据：存储在 ./appdata 目录
• 下载内容：分别存储在 ./audio 和 ./video 目录
• 数据库数据：存储在 ./db 目录

这种设计确保了即使容器被删除或重建，数据也不会丢失。

性能优化建议

1. 硬件加速：

   • 对于视频处理，可以考虑添加 GPU 支持

2. 资源限制：

   • 在生产环境中，建议为容器设置 CPU 和内存限制

3. 网络优化：

   • 对于大量下载需求，可以调整网络相关参数

常见问题解决

1. 端口冲突：

   • 如果 8998 端口已被占用，可以修改 docker-compose.yml 中的端口映射

2. 权限问题：

   • 确保挂载目录对 Docker 有读写权限

3. ARM设备兼容性：

   • 如运行在树莓派等 ARM 设备上，需按注释修改 MongoDB 镜像版本

升级维护

要升级到最新版本，只需执行：

docker-compose pull && docker-compose up -d

这将拉取最新镜像并重新创建容器，同时保留所有配置和数据。

通过以上步骤，您已成功部署了一个功能完整的 YoutubeDL-Material 服务，可以开始使用它来下载和管理视频内容了。