| name | setup-auth |
| description | Configure authentication for various video platforms (YouTube, Bilibili, Instagram, Xiaohongshu). |
平台认证配置
配置各视频平台的认证信息,解决下载限制问题。
支持的平台
| 平台 | 认证方式 | 是否必需 |
|---|
| YouTube | Cookies | 强烈推荐 |
| Bilibili | Cookies | 高清需要 |
| Instagram | Cookies | 必需 |
| 小红书 | Cookies | 必需 |
| 抖音 | 无需 | - |
| TikTok | 无需 | - |
使用方法
帮我配置 YouTube 的认证
设置 B站 cookies
Instructions
方法 1: 浏览器导出 Cookies
Chrome 用户
mkdir -p ./config
Firefox 用户
mv ~/Downloads/cookies.txt ./config/cookies.txt
方法 2: 使用 yt-dlp 直接提取
yt-dlp --cookies-from-browser chrome --cookies ./config/cookies.txt --version
yt-dlp --cookies-from-browser firefox --cookies ./config/cookies.txt --version
yt-dlp --cookies-from-browser safari --cookies ./config/cookies.txt --version
yt-dlp --cookies-from-browser edge --cookies ./config/cookies.txt --version
方法 3: 平台专用配置
YouTube
mkdir -p ./config
cat > ./config/cookies.txt << 'EOF'
EOF
echo "请将 YouTube cookies 粘贴到 ./config/cookies.txt"
Bilibili
cat > ./config/bilibili_cookies.txt << 'EOF'
EOF
Instagram
cat > ./config/instagram_cookies.txt << 'EOF'
EOF
方法 4: 使用 Cobalt(无需 Cookies)
export COBALT_API="https://api.cobalt.tools"
export COBALT_API="http://localhost:9000"
echo "COBALT_API=$COBALT_API" >> ./config/.env
验证配置
if [ -f "./config/cookies.txt" ]; then
echo "✅ Cookies 文件存在"
head -5 ./config/cookies.txt
if grep -q "# Netscape HTTP Cookie File\|# HTTP Cookie File" ./config/cookies.txt; then
echo "✅ 格式正确"
else
echo "⚠️ 格式可能不正确,请确保是 Netscape 格式"
fi
else
echo "❌ Cookies 文件不存在"
fi
echo "测试 YouTube 下载..."
yt-dlp --cookies ./config/cookies.txt \
--simulate \
"https://www.youtube.com/watch?v=dQw4w9WgXcQ"
配置文件结构
./config/
├── cookies.txt # 通用 cookies (YouTube 默认使用)
├── bilibili_cookies.txt # B站专用
├── instagram_cookies.txt # Instagram 专用
├── xiaohongshu_cookies.txt # 小红书专用
└── .env # 环境变量 (API 密钥等)
环境变量
COBALT_API=https://api.cobalt.tools
OPENAI_API_KEY=sk-xxx
RAPIDAPI_KEY=xxx
常见问题
Q: Cookies 过期怎么办?
A: 重新登录网站并导出新的 cookies
Q: Chrome 无法导出 cookies
A: 尝试使用 Firefox,或使用 yt-dlp 的 --cookies-from-browser 选项
Q: YouTube 仍然报 bot 检测
A:
- 确保 cookies 来自已登录的账号
- 尝试使用 Cobalt API
- 考虑使用 RapidAPI 付费服务
安全提示
⚠️ Cookies 包含登录凭证,请勿分享!
- 不要上传到公开仓库
- 添加到 .gitignore
- 定期更换
echo "config/cookies*.txt" >> .gitignore
echo "config/.env" >> .gitignore