douyin-downloader 抖音无水印批量下载实用指南：从单条视频到作者主页

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 是一个开源的命令行（CLI）下载工具，用于无水印下载抖音内容。它支持单条视频、图文、合集、音乐，也支持按作者主页批量抓取作品，内置进度显示、失败重试、SQLite 去重和浏览器兜底能力。如果你需要把抖音公开内容归档到本地、做素材整理或数据备份，这个项目值得作为首选方案。

适用对象与典型任务

• 想保存单条视频、图文或原声音乐到本地，且要求无水印
• 需要按作者主页批量下载作品（post 模式），或抓取点赞列表（like 模式）
• 需要把某个账号的收藏内容（collect / collectmix 模式）整理到本地
• 要做直播留档、评论采集、热搜/关键词检索等轻量数据任务

环境准备与首次运行

环境要求：Python 3.8+，支持 macOS / Linux / Windows。

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

浏览器兜底和自动获取 Cookie 依赖 Playwright，按需安装：

pip install playwright python -m playwright install chromium

接着把示例配置复制为正式配置，并自动写入登录凭证（Cookie）：

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

终端会弹出登录窗口，登录抖音后回到终端按 Enter，Cookie 就写进了 config.example.yml 同结构的配置里。最小运行命令只有一条：

python run.py -c config.yml

下载单条作品

适用场景：只保存某一条视频、图文、合集或音乐。在配置中只写link即可，链接支持/video/、/note/、/collection/、/music/四类地址，以及v.douyin.com短链。

link: - https://www.douyin.com/video/7604129988555574538

输出结果：媒体文件保存在path指定目录下，默认./Downloaded/。注意：按 README 的限制说明，2026-09 起抖音边缘安全门禁会拦截 CLI 对单条视频/图文、合集、音乐的直连请求，这类下载目前更适合用桌面版 Douzy，或等待浏览器兜底策略适配。

批量下载作者主页作品

适用场景：需要归档某位创作者的全部或部分作品。mode支持post（作品）、like（点赞）、mix（合集）、music（音乐）；number下按模式设置数量上限，0表示不限制。

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50

也可以一条命令临时追加链接、并发和输出目录，覆盖配置文件内容：

python run.py -c config.yml \ -u "https://www.douyin.com/user/MS4wLjABAAAAxxxx" \ -t 8 -p ./Downloaded

注意两点：collect/collectmix（当前登录账号的收藏）必须单独使用，不能和post/like/mix/music混写；跨模式下载时同一作品不会重复落盘。

增量跟更与时间过滤

适用场景：定期回来抓新作品，而不是每次全量重下。增量开关按模式设置：

increase: post: true

设为true后，本地已存在主媒体文件的作品会被跳过；删掉文件则会重新下载。配合start_time/end_time（格式YYYY-MM-DD）可以只取指定时间区间的内容，例如只抓 2025 年之后发布的作品。

直播录制与数据检索

直播录制为实验性功能，link指向直播间地址即可开始：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600

FLV 文件保存到Downloaded/{作者}/live/下，附带直播间元数据快照；中断时已录部分会保留。检索类任务不经过下载流程，直接产出 JSONL 文件：

python run.py --hot-board 30 -p ./Downloaded python run.py --search "猫咪" --search-max 100 -p ./Downloaded

前者输出到Downloaded/hot_board/，后者输出到Downloaded/search/。

高频配置项速查

完整字段和注释见 config.example.yml。

桌面版 Douzy：可视化管理任务

仓库同时维护一个桌面客户端 Douzy（内测），基于同一套后端，提供链接粘贴下载、任务中心、收藏同步等界面。批量任务跑起来后，可以在任务中心按状态筛选并打开对应输出目录：

收藏与喜欢内容可以直接按合集整包下载：

排障与边界说明

• 现象：只抓到 20 条左右作品。可能原因：翻页触发风控。处理：保持browser_fallback.enabled: true且headless: false，浏览器弹出后手动完成验证，不要提前关闭窗口。
• 现象：单条视频、合集、音乐请求 403。可能原因：抖音ArgusSecurityPlugin门禁拦截 CLI 直连请求（2026-08 起影响点赞/收藏类，2026-09 起扩展到单条内容）。处理：这类场景改用桌面版 Douzy；主页作品（post）可保留浏览器兜底尝试。
• 现象：Cookie 过期、请求异常。处理：重新执行python -m tools.cookie_fetcher --config config.yml。
• 现象：进度输出刷屏。处理：默认quiet_logs: true已抑制；调试时临时加--show-warnings或-v。
• 现象：想重下某条作品但没触发。原因：程序按"数据库记录 + 本地文件"双重判断。处理：本地文件和数据库记录要一起清理，只删其中一侧行为不一致（只删数据库仍会因文件名去重而跳过）。
• 现象：没有生成 transcript 文件。依次检查transcript.enabled、是否为视频作品、OPENAI_API_KEY是否有效、response_formats是否含txt。

进阶组合

• REST 服务模式：pip install fastapi uvicorn后执行python run.py --serve --serve-port 8000，通过POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查进度，方便接进自己的脚本或前端。
• 完成通知：notifications支持 Bark / Telegram / Webhook（企业微信、飞书、钉钉机器人 URL 均可），长任务结束不用盯着终端。
• 定时增量：把增量配置写好，用系统计划任务周期性执行python run.py -c config.yml，即可实现"每天只补新作品"。
• 合规边界：只下载公开内容，尊重创作者版权，不要用于侵犯隐私或商业侵权场景。

下一步

1. 先用number.post: 1的最小配置跑通一遍，确认 Cookie、目录结构和文件命名符合预期。
2. 批量任务固定使用increase+database组合，配合系统定时任务做增量跟更。
3. 遇到翻页限制时不要反复重试，保留browser_fallback开启并手动过一次验证。

【免费下载链接】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