抖音主页去水印批量下载完整跑通一条最小可运行路径【免费下载链接】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抖音主页里的视频没法在官方 App 去水印保存想回头补抓又得一条条手动下载。douyin-downloader 是一个 Python 命令行的抖音去水印批量下载工具把主页或合集链接贴进去它走接口拉取作品列表、挑最高码率的无水印文件落盘并把每个作品写进本地数据库文件SQLite重复运行不会重复下载。本文从一个真实任务倒推最小配置集最后留一份跑不通时按顺序排查的清单。上图是同仓库桌面版的任务配置界面供对照CLI 由一份 config.yml 驱动。只写 3 个键先把最小流程跑通这一节能让你对一个主页下载出第一批视频全程只动 3 个配置键。先拉代码装依赖Python 3.8git 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 里只填这 3 个键link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 10link 是主页地址mode: post 表示作品模式number.post: 10 只抓最近 10 条写 0 为不限。也可以不改文件用 -u 传链接、-t 传并发默认 5、-p 传保存目录。执行后文件落在Downloaded/作者名/post/日期_标题_aweme_id/python run.py -c config.yml获取 Cookie 的最快方式这一节解决首次使用最常见的卡点 没有有效 Cookie 时作品列表往往只能翻到 20 条就停。用自带扫码脚本一次搞定pip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml浏览器里扫完码回终端按 Enter工具会把拿到的 Cookie 写回 config.yml过期就重跑这条命令。存档竞品主页一个真实任务的配置内容团队跟踪竞品更新想把对方近 30 天的新作品全部存下来、每周归档一次。配置只需在最小版上多两个键link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 video_quality: highest两个键要知道video_quality定保存画质默认 highest从码率阶梯里挑最高档改成 original 会先探测上传原片比最高转码档大就存它代价是每条作品多一次探测请求也可直接指定 1080p 这类分辨率匹配不到时自动降级。稳定性参数并发 thread 默认 5家庭宽带建议 5~8、retry_times 默认 3失败按 1s/2s/5s 退避、rate_limit 为 2 请求/秒。翻页被风控截断时browser_fallback默认开启会自动弹出 Chromium 窗口人工过一遍验证即可继续滚得不够深就调大 max_scrolls默认 240 轮。增量去重与删文件后怎么办这一节解释第二次运行为什么不会重复。去重是双层的dy_downloader.db里的 SQLite 记录 本地目录名里的 aweme_id作品唯一标识。所以删掉本地文件后下次运行仍会跳过确实要重下删掉对应记录sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id aweme_id;跑不通时按这个顺序排查这一节是一张清单按出现频率从高到低排只抓到 20 条就停→ Cookie 过期重跑上文的 cookie_fetcher 命令。反复弹浏览器窗口、翻页被截断→ 接口翻页被风控保持 browser_fallback.headless: false默认在窗口里手动过验证。下载全部失败→ 网络环境复杂给 proxy 填一个代理地址API 请求和媒体流都走它。单个作品链接报 403→ 单作品接口有风控门禁主页作品改用 post 模式 浏览器兜底更稳。要改代码或接自动化流水线先看这几个入口core/user_modes/post / like / mix / music 四种模式各是一个策略类新增内容类型 加一个策略类并注册core/url_parser.py短链与主页链接解析新增链接格式从这里进加--serve --serve-port 8000可起 REST 服务需 fastapi uvicornPOST /api/v1/download 提交任务 把这份最小配置存好每周重跑同一条命令主页存档就会自动补上新作品。【免费下载链接】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），仅供参考