🚀快速開始

只需 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 智慧重試與畫質降級