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-downloader想备份某位博主主页的最新作品时逐条手动保存既慢又带水印导出几百条更是无从下手。douyin-downloader 是一个 Python 编写的抖音批量下载工具粘贴链接即可下载视频、图文、合集与音乐原声自动挑选无水印的最高码率源并通过 SQLite 记录实现去重第二次运行只拉取新增内容。本文面向需要批量管理抖音内容的内容运营者、研究者以及想把下载流程接进自己脚本的开发者。 项目速览维度说明项目定位抖音单条与主页批量下载工具去水印、可增量开发语言Python 3.9异步 IOaiohttp/aiosqlite核心能力视频/图文/合集/音乐下载、Cookie 自动获取、SQLite 去重、失败重试、浏览器兜底翻页适用对象需要本地归档抖音内容的运营人员、研究者与二次开发者部署方式命令行 / DockerMIT 协议开源⚙ 环境准备与安装在任意支持 macOS / Linux / Windows 的机器上准备 Python 3.9 以上版本然后整体执行以下命令git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt cp config.example.yml config.yml如果您希望启用浏览器兜底翻页被风控时自动拉起浏览器过验证和 Cookie 自动获取再补装 Playwrightpip install playwright python -m playwright install chromium配置文件config.yml由仓库自带的config.example.yml复制而来所有下载行为都在这一个文件里声明无需记参数。 首次运行从 Cookie 到第一条下载第一次跑通只需要四步按顺序完成即可获取 Cookie执行python -m tools.cookie_fetcher --config config.yml在弹出的浏览器里扫码登录抖音回到终端按 Enter程序会把ttwid、odin_tt、passport_csrf_token等字段自动写入配置逻辑见 Cookie 管理器。填写下载目标在config.yml的link里粘贴作品链接或主页链接并在mode里选一个模式如post下载发布作品。启动下载执行python run.py -c config.yml终端会出现 Rich 进度条默认 5 线程并发、2 请求/秒限速。核对产物完成后查看Downloaded/目录文件按作者/模式/日期_标题_作品ID/组织同时在工作目录生成dy_downloader.db记录历史。 场景清单按需求选模式下载单个视频或图文把分享短链https://v.douyin.com/...或网页直链放进link即可解析器会自动识别类型见 URL 解析。适合偶尔保存单个作品的场景产物为无水印 MP4 或高清图文。批量下载某位博主的主页link填/user/{sec_uid}主页链接mode可组合post发布、like点赞收藏、mix合集、music使用其 BGM 的作品。适合建立某个账号的完整内容档案跨模式自动按作品 ID 去重同一作品不会下载两遍。备份自己账号的收藏夹link填https://www.douyin.com/user/self?showTabfavorite_collectionmode用collect收藏作品或collectmix收藏合集。仅支持当前登录 Cookie 对应的账号且必须单独使用。录制直播实验性link填https://live.douyin.com/{room_id}可设置最长录制时长与空闲超时。主播下播或中断时已录制的 FLV 数据会保留并附带直播间元数据快照。采集评论或热搜数据开启comments.enabled后可按作品导出*_comments.json可含二级回复或用python run.py --hot-board 30、python run.py --search 关键词导出 JSONL 快照适合做内容监测与数据分析。 关键配置5 个真正影响结果的开关mode决定拉取哪类内容post/like/mix/music可多选收藏夹模式collect/collectmix需单独使用。number.post等数量上限每种模式各有一个数字0表示不限全量抓取50表示只取前 50 条控制单轮下载量最直接的旋钮。thread并发下载数默认 5。机器带宽充足可上调到 8~10追求稳定建议保持默认。browser_fallback.enabled与headless翻页被风控时是否自动打开浏览器headless: false允许您手动过验证码批量抓取主页时强烈建议开启。start_time/end_time按YYYY-MM-DD过滤作品发布时间只下载某一时间段的内容。其余如proxy代理、folderstyle子目录组织、filename_template命名模板、progress.quiet_logs进度日志静默等都有合理默认值保持不动即可。 进阶技巧增量下载开启increase.post: true后已存在于本地的作品会被跳过只下载新增内容适合每周定期同步博主主页。配合database: true还能用sqlite3查询下载历史。重试与限速失败请求按 1s/2s/5s 指数退避自动重试retry_times控制重试次数默认限速 2 请求/秒减少触发风控的概率。附加产物json: true会保存每条作品的元数据 JSONcover/music/avatar分别保存封面、原声 MP3 与作者头像为后续内容分析提供结构化数据。完成通知配置notifications后下载成功或失败会推送到 Bark / Telegram / Webhook企业微信、飞书机器人地址同样可用挂机跑长任务时不必守在终端前。 排障速查现象处理办法主页只能抓到约 20 条就停确认browser_fallback.enabled: true且headless: false浏览器弹出后手动完成验证再关闭请求频繁失败、提示鉴权问题重新执行python -m tools.cookie_fetcher --config config.yml刷新 Cookie进度条重复刷屏保持progress.quiet_logs: true需要调试时临时加--show-warnings或-v下载的文件不完整程序会按 Content-Length 校验并自动清理重试仍失败可删除对应目录后重跑想重新下载某条作品删除本地作品目录并执行sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id ID;两处都清才会重下⚖ 边界与合规本项目仅用于技术研究、学习与个人数据管理请遵守抖音平台服务条款尊重原创内容的版权不得用于侵犯隐私或商业盈利。直播录制属于实验性功能平台接口策略变化导致功能失效属于正常技术风险。✅ 下一步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-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考