🚀快速开始

只需 4 个步骤，30 秒内启动你的 Ytify 服务器

1

下载项目

从 GitHub 克隆项目到你的电脑

git clone https://github.com/Jeffrey0117/Ytify.git
cd Ytify
2

执行启动脚本

Windows 执行 run.bat，Linux/Mac 执行 ./run.sh

run.bat # Windows
./run.sh # Linux/Mac
3

选择启动模式

不确定选哪个？直接按 Enter 选默认的推荐选项

💡 脚本会自动检测并安装 Python、FFmpeg、Git，即使没加入 PATH 也会自动找到
4

开始使用

打开浏览器前往下载页面

http://localhost:8765/download

⚙️启动模式

根据你的电脑配置选择最适合的模式

🐳 Docker 模式

适合高配电脑，隔离环境更干净

  • ⚠️ 需要 4GB+ RAM
  • ✓ 自动更新 (Watchtower)
  • ✓ 容器化隔离

🐍 Python 模式

最轻量，适合临时使用或低配电脑

  • ✓ 资源需求最低
  • ✓ 启动最快
  • ⚠️ 需手动更新

🚀 Python + 自动更新

轻量且自动保持最新，适合大多数人

  • ✓ 资源需求低
  • ✓ 每 5 分钟自动更新
  • ✓ 无需 Docker

🌐远程访问

想从手机或外网使用？两种方式任你选

⚡ 快速隧道

无需域名，最简单的方式

  • ✓ 零配置，一行命令
  • ✓ 不需要域名
  • ⚠️ 每次网址会变
cloudflared tunnel --url http://localhost:8765
📝 产生临时网址如：https://xxx-yyy.trycloudflare.com

🔗 固定网址

长期使用，永久固定网址

  • ✓ 网址永远不变
  • ✓ run.bat 自动启动
  • ⚠️ 需要自己的域名
# 首次设置（只需一次）
cloudflared tunnel login
cloudflared tunnel create ytify
cloudflared tunnel route dns ytify 你的网址
🚀 执行设置向导一键完成：setup-tunnel.bat

🔧Tampermonkey 安装

3 分钟完成设置，在 YouTube 页面一键下载

1

安装 Tampermonkey 扩展

根据你的浏览器选择对应的安装链接：

🌐 Chrome 🦊 Firefox 📘 Edge
2

添加 Ytify 脚本

  1. 点击浏览器右上角的 Tampermonkey 图标
  2. 选择「新建脚本」
  3. 删除默认内容，粘贴 scripts/ytify.user.js 的全部内容
  4. 按 Ctrl + S 保存
💡 脚本文件在项目的 scripts/ytify.user.js
3

开始使用

  1. 确认 Ytify 服务器已启动
  2. 前往任意 YouTube 视频页面
  3. 视频右下角会出现红色「下载」按钮
  4. 点击选择画质即可下载
🔧 若要连接远程服务器，点击「Info」按钮可修改服务器地址

❓常见问题

下载的视频没有声音？
安装 FFmpeg：

Windows: winget install FFmpeg
Linux: sudo apt install ffmpeg
Tampermonkey 脚本没反应？
1. 确认 Ytify 服务已启动
2. 点击脚本的 Info 按钮检查连接状态
3. 如果是远程服务器，修改脚本中的服务器地址
自动更新会中断下载吗？
不会！Ytify 有「优雅重启」机制，会等所有下载任务完成后才更新重启。
支持哪些网站？
Ytify 使用 yt-dlp，支持 YouTube、Bilibili、Twitter 等 1000+ 网站。
完整列表：yt-dlp 支持网站
窗口一闪就关掉了？
run.bat 会自动检测并安装 Python、FFmpeg、Git。如果已安装但没加入 PATH，脚本会自动找到并使用。

如果还是有问题，请确认你使用的是 Windows 10 1709+ 或 Windows 11（需要 winget）。

📋版本历史

v10.7 2025-01 LATEST
  • NEW 失败任务「重试」按钮
  • NEW 任务「关闭」按钮（手动关闭完成/失败任务）
  • NEW 面板「清除」按钮（一键清除所有任务）
  • FIX 多任务下载不再阻塞
  • FIX 快速连续下载时任务卡住的问题
v10.6 2025-01
  • NEW 并发下载支持（最多 3 个同时下载）
  • NEW 「合并中」状态显示（FFmpeg 处理阶段）
  • NEW 优雅重启机制（自动更新不中断下载）
  • NEW 离线时可直接修改服务器地址
v10.5 2025-01
  • NEW 连接状态即时检测
  • NEW 离线友好提示 popup
v10.0 2024-12
  • NEW WebSocket 即时进度推送
  • NEW 播放列表批量下载
  • NEW 下载历史持久化
  • NEW 代理池支持
  • NEW 智能重试与画质降级