douyin-downloader 使用指南4 步完成抖音去水印批量下载【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloaderdouyin-downloader 是一个面向抖音内容的开源批量下载工具支持单条视频、图文作品、用户主页、主题合集、音乐原声与直播间去水印抓取内置并发调度、SQLite 去重与增量下载机制提供 Python 命令行版与 Douzy 桌面版两套入口共用同一套下载后端。四步跑通首次抖音批量下载环境要求 Python 3.9支持 Windows、macOS、Linux。第 1 步克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium第 2 步获取并保存登录 Cookiecp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml在弹出的浏览器中登录抖音回到终端按 EnterCookie 自动写入config.yml。Cookie 共有三种配置方式脚本自动获取手动在配置中填写cookies键值对msToken、ttwid、odin_tt、passport_csrf_token等或粘贴整串 Cookie用环境变量DOUYIN_COOKIE覆盖配置文件。优先级为命令行 环境变量 配置文件 默认值。第 3 步把示例链接换成目标链接link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/number.post控制下载条数0表示不限详见 config.example.yml。第 4 步运行下载python run.py -c config.yml运行时可看到进度、并发数与成功/失败统计。完整参数用python run.py --help查看-t调并发-v输出详细日志-u追加链接。抖音去水印下载支持的内容类型全景下载对象典型 URL 格式处理说明单个视频/video/{aweme_id}解析作品 ID 后直接请求无水印源文件图文作品/note/{note_id}另识别/gallery/、/slides/逐张下载图集媒体与视频共用同一套命名与去重规则用户主页/user/{sec_uid}翻页收集作品按modepost/like/mix 等与number上限筛选主题合集/collection/{mix_id}或/mix/{mix_id}展开合集中全部作品逐条下载支持数量上限音乐原声/music/{music_id}提取作品使用的原声音乐文件直播间live.douyin.com/{room_id}实时录制直播流可设最大时长、分块大小与空闲超时命令行版以抖音为主桌面版 Douzy 在同一套后端之上扩展了 TikTok、YouTube、Telegram、X 等平台粘贴链接即可发起任务。输入、处理、输出抖音批量下载任务的数据流输入段工具读取config.yml与命令行参数按默认值 配置文件 环境变量DOUYIN_COOKIE、DOUYIN_PATH、DOUYIN_THREAD、DOUYIN_PROXY 命令行逐级合并。URL 解析器识别链接类型video/note/user/collection/music/live主页类任务先翻页收集作品 ID 列表再按start_time/end_time格式YYYY-MM-DD含结束日当天与number数量上限筛选把任务清单收窄到真正需要处理的作品。处理段队列由thread控制的并发工作器消费默认 5 并发接口请求统一受rate_limit默认 2 次/秒附加随机抖动约束避免请求过于激进触发风控。每条作品走请求接口 → 校验媒体信息 → 落盘文件路径失败时按 1 秒、2 秒、5 秒退避重试默认最多重试 3 次retry_times: 3。去重发生在本段入口先查磁盘是否存在非空主媒体文件再查 SQLite 下载记录两层都命中直接跳过因此同一批链接重复运行只会补下新增或缺失的文件。输出段媒体文件按作者/模式/文件结构写入path目录作者层默认用昵称可切换为sec_uid或nickname_uid文件名由filename_template渲染默认{date}_{title}_{id}。每条作品同时向download_manifest.jsonl追加一条 JSON 记录database: true时作品明细写入 SQLite 库dy_downloader.db的aweme表供历史查询与增量去重使用。抖音下载故障场景与系统行为对照故障场景系统行为单次请求失败、网络抖动进入指数退避重试等待节奏 1 秒、2 秒、5 秒默认最多重试 3 次retry_times: 3单条作品持续失败该条标记失败并跳过队列继续消费后续任务批次结束后统一输出失败汇总视频已被删除或设为私密判定为源不可用自动跳过不阻塞整批任务主页作品列表分页受限browser_fallback.enabled: true默认时触发 Playwright 浏览器兜底采集作品 ID再回接口补全详情遇验证码页需headless: false人工完成验证单视频、合集、音乐等接口被风控CLI 无法绕过更新 Cookie 或反复重试均无效建议改用 Douzy 桌面版⚠️ 需要说明README 已明确当前抖音接口风控会阻止 CLI 下载单条视频/图文、合集、音乐、喜欢与收藏主页浏览器兜底不保证成功直播录制属于实验功能HLS 源仅保存播放列表而非可直接播放的视频。平台策略变化可能随时影响任意功能可用性。抖音批量下载关键配置项速查配置项说明取值示例filename_template/folder_template命名模板可用变量{id}、{title}、{author}、{date}、{year}、{mode}等保留{id}可避免重名覆盖{date}_{title}_{id}默认start_time/end_time按作品发布时间过滤含结束日当天2026-01-01/2026-06-30number.post各模式下载数量上限0不限或10thread并发下载线程数5默认可上调video_quality画质档位original探测上传原片探测失败自动回退最高转码档highest默认/original/1080pincreaseredownload_missing_files增量下载总开关主媒体文件缺失时是否补下increase.post: truedatabase是否写入 SQLite 下载历史库true默认proxy接口请求与下载走代理http://127.0.0.1:7890live.max_duration_seconds直播录制最大时长0表示录到主播下播0notifications.enabled完成通知providers 支持 bark / telegram / webhookfalse默认完整字段与默认值见 config/default_config.py命名变量的渲染与清理逻辑见 utils/naming.py。三个真实用法组合定时增量收集把start_time设为最近 7 天保持各模式increase: true与database: true用 cron 按周执行python run.py -c config.yml二次运行只补新增作品同时开启notifications并配置 Bark 或 Telegram任务结束自动推送到手机夜间挂机跑批无需守在终端前。竞品监控与素材归档mode: [post]number.post限定条数 json: true归档作品元数据author_dir: nickname_uid防止作者改名导致目录分裂排障时加-v查看详细日志定位卡在接口阶段还是传输阶段。免配置日常使用日常抓取用 Douzy 桌面版左侧边栏管理账号与订阅任务中心跟踪每条批量任务状态粘贴链接、勾选内容类型即可发起任务无需接触配置文件TikTok、YouTube 等平台的链接任务也走同一套后端。需要把下载能力挂到自有系统时可启动可选的 REST API 服务模式python run.py --serve --serve-port 8000需额外安装 fastapi 与 uvicornjob 记录默认保留 24 小时。抖音去水印下载高频问题解答提示 Cookie 失效或需要登录怎么办重新运行python -m tools.cookie_fetcher --config config.yml浏览器里完成登录后按 Enter 覆盖保存即可。注意更新 Cookie 不能解决接口风控本身造成的限制。主页只获取到少量作品保持browser_fallback.enabled: true且headless: false程序检测到验证码页会等待你在浏览器中人工验证验证后自动继续采集风控严重时仍可能受限。个别视频持续失败是什么原因大概率是源作品已被作者删除或设为私密属于源头不可用系统自动跳过并继续后续任务不影响整批结果。文件名混乱甚至互相覆盖检查filename_template是否包含{id}变量这是保证唯一性的关键字段缺失值会被渲染为空串模板过短或缺少{id}时容易同名。二次运行会不会重复下载保持database: true且各模式increase为trueSQLite 记录加磁盘文件校验的双重去重只会处理新出现的作品。需要强制重下时把对应模式的increase设为false无需清空数据库。下载速度不达预期如何排查先上调thread观察吞吐变化再检查网络环境必要时填写proxy走代理用-v输出详细日志确认瓶颈在接口请求还是文件传输阶段。适用人群与使用合规这套工具适合三类人需要周期性收集作者内容的素材整理者定时任务 increase增量下载 notifications推送做竞品监控的运营人员主页批量抓取 json: true元数据归档 时间区间过滤希望免配置直接使用的普通用户Douzy 桌面版粘贴链接即完成一次抖音合集批量下载。它不适合以破解付费内容为目的的场景也不适合要求 100% 稳定绕过平台风控的用途接口策略变化随时会影响可用性。请在合法合规的个人数据管理场景下使用本工具尊重原创者的版权与劳动成果遵守平台规则与隐私要求并自行承担使用责任。准备好环境后先完成克隆仓库、保存第一个 Cookie、填入一条目标链接这三件事一个完整的抖音去水印批量下载流程在半小时内即可跑通。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考