YTPTube：自托管的 yt-dlp 视频下载管理器 #

YTPTube 是什么？ #

YTPTube 是一款开源、可自托管的视频下载管理器，它在业界广泛使用的命令行下载引擎 yt-dlp 之上，构建了一套完整的浏览器图形界面。你不再需要在终端里反复输入命令和参数，只要打开网页，把视频或播放列表链接粘进去，剩下的排队、下载、归档就交给它完成。

它的典型使用场景是把下载任务放到一台长期开机的设备上：家用 NAS、树莓派、云服务器或家庭小主机。这样无论你身处哪个网络环境，用手机还是电脑浏览器都能提交任务、查看进度、管理已下载的媒体文件。相比单机下载工具，YTPTube 解决的是"多设备提交、任务持续运行、批量与自动化"的问题——尤其是面对动辄上百个条目的播放列表和需要长期追更的频道时，优势非常明显。

项目由开发者 arabcoders 维护，采用 Python 编写，官方主推 Docker 部署方式，同时也为 Windows、Linux、macOS 提供了开箱即用的独立可执行包。

YTPTube 有哪些亮点特色？ #

• 自托管私有部署：整套服务运行在你自己的服务器或电脑上，下载记录、媒体文件、Cookie 与配置全部保存在本地，不经过任何第三方云服务，隐私与数据主权完全由你掌握。
• 完整的 Web 图形界面：把 yt-dlp 的命令行能力包装成直观的网页操作，粘贴链接、选择预设、点击加入队列即可，无需记忆任何参数，手机浏览器同样可以顺畅使用。
• 内置任务队列与并发下载：支持同时处理多个下载任务，队列中的条目可以暂停、恢复、重试与排序，长列表批量抓取时不必守在电脑前等待。
• 播放列表批量处理：面对包含大量条目的播放列表或频道链接，可以一次性提交并按预设规则批量下载，自动跳过已下载内容，避免重复劳动。
• 订阅与定时任务：可以为常用频道或播放列表建立订阅，让服务按设定周期自动检查更新并下载新内容，实现"一次配置、长期追更"。
• 灵活的预设系统：可保存多套下载预设，分别为不同场景指定画质、音频格式、字幕、缩略图、元数据、输出路径等参数，下载时一键套用，无需每次重复配置。
• 实时进度与通知：界面实时反馈下载进度、速度与剩余时间，并支持在任务完成或失败时推送通知，适合放在无人值守的服务器上运行。
• 跨平台部署方式：既可以用 Docker 一键拉起服务，也可以直接下载对应系统的独立可执行包运行，Windows、Linux（amd64/arm64）与 macOS（arm64）均有官方构建。

免费下载 YTPTube #

以下为官方提供的各平台安装包，点击链接即可下载。请根据自己的操作系统与处理器架构选择对应版本，其中 amd64 对应常见的 Intel/AMD 64 位处理器，arm64 对应 ARM 架构设备（如部分服务器、Apple 芯片 Mac、树莓派等）。

提示：上述安装包版本号均为 v2.7.4，具体更新日期与校验信息官网未说明，建议以项目仓库 Releases 页面为准。Intel 芯片 Mac 的构建版本在本次下载数据中未提供。

YTPTube 如何使用？ #

YTPTube 的使用逻辑是"先启动服务，再用浏览器操作"，整体流程对新手相当友好：

1. 启动服务：通过 Docker 拉取并运行容器，或解压下载的独立可执行包后直接运行。启动成功后，终端或容器日志会输出访问地址与端口（默认端口通常为 8081，具体以实际启动日志为准）。
2. 打开 Web 界面：在同一台机器的浏览器访问 http://localhost:8081，如果在其他设备上访问，则把 localhost 换成服务器所在的内网或公网 IP 地址。若你在配置中启用了访问密码，此时需要先登录。
3. 提交下载任务：把视频、播放列表或频道链接粘贴到界面顶部的输入框中，如果有多个链接，可以按行分别粘贴。随后在下载前选择合适的预设与输出目录。
4. 选择预设与参数：预设决定了画质、音频格式、是否下载字幕与缩略图、文件命名规则等。你可以先用默认预设下载一次，确认效果后再针对不同场景建立自己的专属预设。
5. 在队列中管理任务：提交后的任务会进入队列，你可以查看实时进度、速度与剩余时间，也可以暂停、恢复、重试或删除条目。任务完成后，文件会出现在你设定的输出目录中。
6. 配置订阅（可选）：如果需要长期追更某个频道或播放列表，可将其添加为订阅并设定检查周期，之后 YTPTube 会自动检测新内容并加入下载队列。

对于进阶用户，YTPTube 也保留了 yt-dlp 的大量原生能力（例如通过 cookies 文件处理需要登录的站点、自定义命令行参数等），这些可以在界面的配置项中按需启用，具体支持的参数项请以项目文档为准。

YTPTube 的常见问题？ #

YTPTube 和 yt-dlp 是什么关系？ YTPTube 并不是另写一套下载引擎，而是以 yt-dlp 作为底层核心，在其之上增加了 Web 界面、任务队列、订阅管理和预设系统。因此 yt-dlp 所支持的站点与能力，基本都能在 YTPTube 中以更直观的方式使用。

下载需要登录的视频时怎么办？ 常见做法是通过 cookies 文件提供登录凭证：在浏览器中导出目标站点的 cookies.txt，然后在 YTPTube 的配置中指定该文件路径。这样服务在请求受限内容时就能以你的登录身份访问。具体配置项的字段名请以当前版本的项目文档为准。

为什么某些下载任务速度很慢或长时间卡住？ 这通常与目标站点的限速策略、网络环境或 yt-dlp 的版本兼容性有关。可以尝试降低并发数量、更换网络出口，或更新到较新的构建版本——由于站点规则变化频繁，下载引擎本身也需要持续跟进更新。

YTPTube 能不能长期挂在服务器上自动下载？ 可以，这正是它的主要设计目标之一。配合订阅与定时任务功能，服务会按设定周期检查更新并自动下载新内容；开启通知后，任务完成或失败时会主动推送提醒，适合无人值守运行。

支持 Windows 和 macOS 吗？ 支持。官方为 Windows（amd64 / arm64）和 Apple 芯片版 macOS 提供了独立可执行包，Linux 则提供 amd64 与 arm64 两个版本，同时也推荐使用 Docker 部署。Intel 芯片 Mac 的原生构建是否存在，官网未说明。

下载的文件保存在哪里？ 保存位置由你设定的输出目录决定。使用 Docker 部署时，需要把容器内目录映射到宿主机的实际路径，否则文件会留在容器内部；使用独立包运行时，则对应你配置的本地目录。（参考社区常见反馈）

YTPTube 如何安装？ #

YTPTube 提供两种主流安装方式，官方更推荐 Docker 部署，因为它能隔离依赖、便于升级。

方式一：Docker 部署（推荐） #

1. 在服务器或本机安装 Docker 环境（Windows 与 macOS 可使用 Docker Desktop，Linux 使用发行版对应的 Docker Engine）。
2. 拉取并运行 YTPTube 镜像，同时把服务端口映射到宿主机（通常为 8081），并把下载目录与配置目录挂载到宿主机路径，以免升级容器时数据丢失。
3. 启动后访问 http://<服务器地址>:8081，确认界面可以正常打开。
4. 进入设置页配置输出目录、预设与访问密码。
5. 后续升级时，拉取新版本镜像并重新创建容器即可。具体的镜像名称与完整启动命令请以项目仓库 README 为准。

方式二：使用独立可执行包 #

1. 根据操作系统与处理器架构，从上方下载表格中选择对应的压缩包。
2. Windows：解压压缩包到任意目录（建议路径不含中文与空格），直接双击可执行文件启动。若系统弹出安全提示，请确认文件来源后允许运行；如需后台长期运行，可将其注册为服务或加入到开机启动项。
3. macOS：解压后首次运行时，若被系统拦截，可在"系统设置 → 隐私与安全性"中允许该应用运行，或在终端中执行解除隔离属性的命令后再启动。
4. Linux：解压后为可执行文件赋予运行权限（chmod +x），然后直接运行；如需长期运行，建议配合 systemd 服务或进程守护工具管理。
5. 启动完成后，同样通过浏览器访问输出提示中的地址即可进入 Web 界面。

注意事项：独立包与 Docker 方式都会在本地生成配置文件与数据库，请不要随意删除这些文件，否则已有的订阅、队列与设置会丢失。使用旧版本升级时，建议先备份配置目录。具体版本要求与参数细节，官网未说明。

YTPTube 如何卸载？ #

卸载前建议先停止正在运行的下载任务，并备份你希望保留的媒体文件与配置文件。

Windows #

1. 在任务管理器中结束 YTPTube 相关进程；如果之前注册过系统服务或开机启动项，需要一并删除。
2. 直接删除解压后的程序目录即可。YTPTube 为免安装的独立包形式，一般不会写入系统注册表。
3. 检查配置目录与下载目录中是否残留数据库、日志或临时文件，确认不需要后手动删除。

macOS #

1. 停止正在运行的进程，删除应用程序目录中的 YTPTube 文件夹。
2. 检查用户目录下的配置与数据文件夹，如有残留可一并清理。
3. 若曾将其添加为登录项，请在"系统设置 → 通用 → 登录项"中移除。

Linux #

1. 使用 kill 或 systemctl stop 停止正在运行的服务进程；若注册过 systemd 服务，请删除对应的服务文件并执行 systemctl daemon-reload。
2. 删除可执行文件与所在目录。
3. 清理配置目录、数据库与日志文件；如果下载目录中有需要保留的内容，请在删除前先行转移。

Docker 部署方式 #

1. 执行 docker stop 停止容器，再执行 docker rm 删除容器。
2. 如不再使用，可执行 docker rmi 删除对应镜像以释放磁盘空间。
3. 最后删除挂载到宿主机的配置目录与数据目录。这一步不可逆，其中的订阅记录、队列状态与设置都会一并丢失，请务必确认后再操作。

无论是哪种安装方式，YTPTube 都不会主动删除你已经下载完成的媒体文件；这些文件需要你自行决定保留或清理。（参考社区常见反馈）