douyin-downloader 实操手册从零开始完成抖音无水印下载与批量拉取【免费下载链接】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 是一个命令行抖音无水印下载工具单视频、图集、音乐可以直接解析用户主页作品可以批量拉取文件附带封面、原声与 JSON 元数据重复任务用 SQLite内置关系数据库自动去重。能力速览能力说明单视频 / 图文下载短链自动解析默认挑选无水印源用户主页批量作品 / 点赞 / 合集 / 音乐四种模式跨模式去重直播回放录制FLV/HLS 流中断后保留已录数据断点与续跑已下载文件跳过不完整文件自动重下元数据导出每件作品一个_data.json外加 JSONL 下载清单时间过滤start_time/end_time按发布时间截取区间装好并跑通第一次下载第一步克隆仓库并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt克隆代码并装好运行所需的全部依赖后续所有命令都在仓库目录内执行。第二步把示例配置复制为工作配置填入第一条下载链接cp config.example.yml config.yml生成你的config.yml编辑时只改link其余字段先保持默认。第三步启动 Cookie 获取并扫码登录Cookie 是抖音识别你登录身份的凭据没有它大部分接口会拒绝访问python -m tools.cookie_fetcher --config config.yml该命令基于 Playwright浏览器自动化库需要pip install playwright弹出浏览器扫码完成后自动把 Cookie 写回配置。第四步执行下载并验证产物python run.py -c config.yml运行入口是 core/url_parser.py 所在的主流程跑完后在Downloaded/目录下能找到视频文件、封面和_data.json即算跑通。Cookie 认证自动获取与手动填写怎么选自动获取推荐重跑上面的cookie_fetcher命令即可。它启动 Chromium开源浏览器内核让你扫码结束后自动把msToken、ttwid、odin_tt、passport_csrf_token四个必需字段回写到配置不需要手动复制粘贴适合绝大多数人。手动填写浏览器登录抖音网页版从开发者工具的 Application → Cookies 里复制上述字段填进config.yml的cookies段。适合无图形界面的服务器环境。Cookie 有效期不长失效时接口会提示登录态问题重跑自动获取命令就能恢复。获取工具的实现见 tools/cookie_fetcher.py。单视频、主页批量、直播回放三种模式各一行命令单视频python run.py -c config.yml -u https://www.douyin.com/video/7341234567890。-u传入的链接会追加到配置的link列表适合临时补下某一条。主页批量link填https://www.douyin.com/user/MS4wLjABAAAAxxxx配置中设mode: - post number: post: 50mode: post表示拉取该作者发布的全部作品post: 50限制只下前 50 条填0表示不限。直播回放link填https://live.douyin.com/房间号配置中设live: max_duration_seconds: 3600 idle_timeout_seconds: 30录满 1 小时自动停止把max_duration_seconds设为 0 会一直录到主播下播。配置文件关键项thread: 5 retry_times: 3 start_time: 2024-01-01 end_time: 2024-12-31 database: truethread是并发下载数家庭网络 5 足够retry_times控制失败重试次数时间两项按作品发布时间过滤区间格式YYYY-MM-DDdatabase: true开启 SQLite 去重与历史记录。底层机制core/downloader_factory.py 中的工厂类根据链接类型把任务分发给对应的下载器你不需要自己判断。下载过程由 control/queue_manager.py 按thread并发调度RateLimiter 把请求速率压在默认 2 次/秒RetryHandler 按 1s、2s、5s 指数退避重试。源地址默认优先无水印下载前会对比 Content-Length响应头中声明的文件大小校验不通过的文件自动删除并重下。排错速查现象主页只抓到 20 条 → 原因翻页触发风控 → 解法开启browser_fallback.enabled: true保持headless: false弹出浏览器后手动完成验证。现象提示登录态失效 → 原因Cookie 过期 → 解法重跑python -m tools.cookie_fetcher --config config.yml。现象日志刷屏、进度看不清 → 原因未开静默日志 → 解法配置中设progress.quiet_logs: true。现象个别文件损坏或大小异常 → 原因网络中断导致下载不全 → 解法程序会按 Content-Length 自动清理重下反复失败时调小thread。进阶玩法SQLite 去重开启database: true后每件作品的aweme_id作品唯一编号会记入dy_downloader.db重跑同一链接已下载的内容直接跳过。想看下载历史用sqlite3查aweme表即可。定时增量配合increase.post: true每次运行只补拉上次之后新发布的作品0 3 * * * cd /path/to/douyin-downloader python run.py -c config.ymlcrontab系统定时任务每天凌晨 3 点只下增量适合长期跟踪固定账号。合规与社区只下载公开内容尊重创作者版权下载的数据不用于商用传播Cookie 等同于账号凭据不要分享给他人。功能问题与平台接口变更的反馈建议到仓库 Issue 区提交附上日志和链接便于复现。下一步先跑通一个单视频确认Downloaded/里有完整产物再用-u追加一条主页链接把批量流程也验证一遍。【免费下载链接】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），仅供参考