去水印批量下载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 是命令行抖音去水印批量下载工具视频、图集、合集、音乐原声都能整页拉走适合内容创作者和竞品分析师。它自动挑无水印源、按作者分目录、用 SQLite 防重复。过去逐条点开抠水印的事现在一条命令出原片。为什么不用手动搞了把旧做法和工具的做法放一起看差别一下就清楚了你原来要做的douyin-downloader 帮你做的逐条点开、单独下载再手动抠掉水印自动选无水印源多条并发一起拉下过第二遍重复文件占硬盘SQLite 历史 磁盘双查重跳过已有下到一半断了就从头再来失败按 1s/2s/5s 指数退避自动重试文件堆一个文件夹找不到按作者/模式/日期自动建子目录一句话省掉的是点、抠、判重、归档这几件纯体力活你只负责给链接。五分钟跑通环境、认证到首次下载第 1 步装环境和依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt要求 Python 3.8macOS / Linux / Windows 都行。跑完最后一行没有红字报错就说明依赖装好了。第 2 步拿 Cookie新手最容易卡的一步Cookie 是访问抖音接口的登录凭证没有它分页和去水印都受限。先装浏览器组件供自动抓取用pip install playwright python -m playwright install chromium自动获取推荐新手复制一份配置再跑抓取脚本cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml它会弹出一个浏览器窗口你在里面登录抖音回到终端按回车Cookie 就自动写进config.yml了。手动配置适合能自己抠 Cookie 的老手打开config.yml最下面的cookies段把ttwid、odin_tt、passport_csrf_token等字段填上来源是浏览器登录抖音后从开发者工具复制出来的同名 Cookie。第 3 步首次下载配置里link填一条视频或主页地址然后python run.py -c config.yml执行后你会看到终端滚出并发进度条Downloaded/下按作者名分好文件夹。如果你更习惯图形界面项目自带桌面端 Douzy与命令行共享同一套后端粘个链接就能一键开始完整工作流把一位博主的 20 条作品存下来选一个真实场景走一遍——把某位创作者最近的 20 条作品整批存下来。1. 编辑config.yml只留这几行就够link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 只下作者自己发的作品 number: post: 20 # 20 最近 20 条0 全量2. 运行python run.py -c config.yml3. 预期结果20 条作品并发拉取每条一个子目录目录里是...mp4视频本体加上可选的封面、音乐、JSON 元数据。文件落在Downloaded/作者名/post/日期_标题_id/。4. 再看一次任务状态桌面端任务中心会列出每个任务的成败和数量统计还能一键打开输出目录5. 增量再跑博主又更新了新作品时把increase.post设为true再跑一次磁盘里已有的作品会被跳过只补新增的。整个过程你只改了数字、跑了两条命令。进阶玩法增量定时、自定义命名与 API 服务✅如果你需要每天凌晨自动拉新配合系统定时任务 增量开关不用盯着它跑。# crontab -e 里加一行每天 2 点增量拉取 0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml配置里保留increase.post: true本地已存在的主文件会被自动跳过只补新作品。✅如果你想自己定文件怎么放命名模板支持一组变量目录层级也能按年月排filename_template: {author}_{date}_{title}_{id} folder_template: {year}/{month}/{author} author_dir: nickname_uid # 昵称_唯一ID避免重名博主被合并模板里必须带{id}否则重名会互相覆盖。完整变量列表和取值见 config.example.yml。✅如果你想把它变成服务被别的程序调用装两个可选依赖起一个本地 REST 接口pip install fastapi uvicorn python run.py --serve --serve-port 8000 curl -X POST http://127.0.0.1:8000/api/v1/download -d {url: https://www.douyin.com/video/xxx}提交后返回job_id再GET /api/v1/jobs/{job_id}查进度和结果。踩坑速查高频问题一句话解法⚠️只拉到约 20 条就停了原因触发了分页风控接口不再往后翻页。 解法browser_fallback.enabled: true且headless: false会弹出浏览器让你手动过一次验证别关早了。Cookie 过期、请求被拒、下不动原因登录凭证失效。 解法重跑python -m tools.cookie_fetcher --config config.yml重新登录一次。想强制重新下载某一条却跳过了原因工具用数据库记录 本地文件双查重只删一处不够。 解法删掉含该aweme_id的本地文件夹再用sqlite3从dy_downloader.db删对应记录。进度刷屏、日志吵原因日志静默没打开。 解法配置里progress.quiet_logs: true需要排查时临时加--show-warnings或-v。想要原画拿到的却偏糊原因默认video_quality: highest只挑最高转码档不是上传原片。 解法改video_quality: original去探测原片每条多一次探测请求失败会退回转码档。谁最适合用 收尾它最对路的三类人追素材的自媒体创作者、攒课程案例的教育工作者、盯竞品内容的分析师——共同点都是要存得多、要存得齐、不想重复劳动。项目基于 MIT 协议开源可自由使用、修改和分发。觉得哪里不顺用欢迎去提 issue 或直接提个 PR。【免费下载链接】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），仅供参考