douyin-downloader 完整使用指南3 步配置抖音无水印下载、批量归档与直播录制【免费下载链接】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 是一个面向个人内容管理的抖音下载工具支持无水印视频下载、作者主页批量下载、直播录制以及评论、热搜榜与关键词搜索的数据导出。本文按你要完成什么任务组织内容帮助你在 3 步内完成安装与首次下载。项目速览维度说明定位命令行抖音下载工具默认带进度展示、指数退避重试与 SQLite 历史记录下载模式单个视频/图文/合集/音乐用户主页批量post/like/mix/music登录账号收藏夹collect/collectmix直播录制live.douyin.com/{room_id}链接触发自动挑选可用最高清晰度流数据导出按作品采集评论可选二级回复、--hot-board热搜榜、--search关键词搜索均落盘 JSONL/JSON接入方式配置文件 CLI 参数可选 REST API 服务模式与 Docker 部署环境要求Python 3.9pyproject.toml声明requires-python 3.9macOS / Linux / Windows如果你的网络环境会触发抖音翻页风控它还内置了浏览器兜底browser_fallback翻页被拦截时自动拉起浏览器由你手动完成验证后继续抓取。快速上手3 步完成安装与首次无水印下载第 1 步安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如需使用浏览器兜底或自动获取 Cookie再安装pip install playwright python -m playwright install chromium第 2 步创建配置cp config.example.yml config.yml打开config.yml只需关注三处link要下载的链接列表、path保存目录、mode下载模式默认post。其余键位均有合理默认值。第 3 步获取 Cookie 并运行python -m tools.cookie_fetcher --config config.yml在弹出的浏览器中登录抖音回到终端按 EnterCookie 会自动写入配置。随后执行python run.py -c config.yml完成后在path指定目录下即可看到无水印视频文件。桌面版 Douzy 提供了同一后端的图形界面粘贴链接即可开始下载任务执行过程中的状态与结果可以在任务中心里查看失败项支持重试按任务办事四个典型目标的配置方式批量归档某位创作者的全部作品何时用需要长期保存某账号的作品并且希望定期同步新内容而不重复下载。怎么做link填作者主页链接https://www.douyin.com/user/{sec_uid}mode设为- postnumber.post设为0不限条数。保持increase.post: true默认开启程序会检查磁盘主文件已存在的作品直接跳过下次运行只补齐新增内容。如需按时间截取配合start_time/end_time格式YYYY-MM-DD。预期结果作品按作者目录 / post / 日期_标题_aweme_id落盘SQLite 数据库dy_downloader.db记录元数据去重采用数据库记录加本地文件的双重检查跨模式也不会重复下载同一aweme_id。注意磁盘文件缺失会触发重新下载只删数据库不删文件则不会重下。持续录制直播内容何时用直播内容结束后难以回看需要完整留存。怎么做link填直播间链接https://live.douyin.com/{room_id}。用live.max_duration_seconds控制录制时长0表示直到主播下播live.idle_timeout_seconds用于网络静默时提前结束。运行后无需干预程序自动选择可用清晰度中最高的一档ORIGINFULL_HDHDSD逐级降级。预期结果FLV 文件与*_room.json元数据保存在作者目录的live/下主播下播、网络中断或手动 CtrlC 时已录制的字节都会保留临时文件会被提升为正式文件。数据采集评论、热搜榜与关键词搜索何时用做内容分析、舆情跟踪只需要结构化数据而不下媒体文件。怎么做评论采集配置中设置comments.enabled: trueinclude_replies: true会额外抓取二级回复max_comments控制每条作品抓取上限每个作品旁生成{标题}_{aweme_id}_comments.json。热搜榜python run.py --hot-board 30 -p ./Downloaded结果写入Downloaded/hot_board/日期时间.jsonl。关键词搜索python run.py --search 关键词 --search-max 100 -p ./Downloaded结果写入Downloaded/search/关键词_日期时间.jsonl。预期结果JSONL 文件按行存储可直接用 pandas 或 jq 做后续统计。接入自动化REST API 服务模式何时用已有采集管道或脚本希望通过接口提交任务、轮询状态而不是手动跑命令行。怎么做一次性安装可选依赖pip install fastapi uvicorn。启动服务python run.py --serve --serve-port 8000默认监听 127.0.0.1。通过POST /api/v1/download提交{url: ...}拿到job_id再用GET /api/v1/jobs/{job_id}轮询状态GET /api/v1/jobs列出近期任务GET /api/v1/health用于健康探测。预期结果服务在内存中保留任务记录server.max_jobs默认 500与server.job_ttl_seconds默认 24 小时控制清理策略进行中的任务不会被清除。配置要点只改这三处就够了并发与限速config.example.yml中可调thread: 5 # 并发下载数默认 5 rate_limit: 2 # 请求限速默认 2 次/秒 retry_times: 3目录与命名默认folderstyle: true每个作品独立子目录filename_template/folder_template支持{date} {title} {id} {author} {mode}等变量要求模板至少包含{id}防止重名覆盖author_dir可选nickname/sec_uid/nickname_uid三种作者目录命名方式folderstyle: true filename_template: {date}_{title}_{id} author_dir: nickname_uid完成通知下载结束成功或失败时可并行推送多个渠道某个渠道失败不会阻塞下载流程notifications: enabled: true providers: - type: webhook url: 你的机器人地址webhook 渠道兼容企业微信 / 飞书 / 钉钉机器人地址此外还支持 Bark 与 Telegram。桌面端的对应设置界面如下避坑指南四种常见现象的原因与解法只拿到约 20 条作品原因抖音翻页风控拦截了后续分页。解法确认browser_fallback.enabled: true且headless: false浏览器弹出后手动完成验证不要提前关闭窗口注意该兜底目前仅对post模式完整验证过like/mix/music主要依赖 API 正常分页。Cookie 失效接口返回登录错误原因Cookie 过期或被平台刷新。解法重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录即可。下载速度慢或频繁失败原因并发过高触发限流或网络出口不稳定。解法适当调低thread配合proxy配置代理程序自带指数退避重试1s、2s、5s与 Content-Length 完整性校验不完整文件会自动清理重下一般不需要人工介入。想查下载历史原因历史记录在dy_downloader.db的aweme表中。解法用 sqlite3 查询例如SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;。需要强制重下时删除本地文件目录并同步删除数据库对应记录两者都要动。douyin-downloader 项目在 gitcode.com/GitHub_Trending/do/douyin-downloader源码模块划分可在仓库 README 与core/、storage/目录中查阅。建议先用单条视频链接跑通全流程再切换到批量归档和直播录制等重任务。【免费下载链接】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），仅供参考 douyin-downloader 完整使用指南：3 步配置抖音无水印下载、批量归档与直播录制
douyin-downloader 完整使用指南3 步配置抖音无水印下载、批量归档与直播录制【免费下载链接】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 是一个面向个人内容管理的抖音下载工具支持无水印视频下载、作者主页批量下载、直播录制以及评论、热搜榜与关键词搜索的数据导出。本文按你要完成什么任务组织内容帮助你在 3 步内完成安装与首次下载。项目速览维度说明定位命令行抖音下载工具默认带进度展示、指数退避重试与 SQLite 历史记录下载模式单个视频/图文/合集/音乐用户主页批量post/like/mix/music登录账号收藏夹collect/collectmix直播录制live.douyin.com/{room_id}链接触发自动挑选可用最高清晰度流数据导出按作品采集评论可选二级回复、--hot-board热搜榜、--search关键词搜索均落盘 JSONL/JSON接入方式配置文件 CLI 参数可选 REST API 服务模式与 Docker 部署环境要求Python 3.9pyproject.toml声明requires-python 3.9macOS / Linux / Windows如果你的网络环境会触发抖音翻页风控它还内置了浏览器兜底browser_fallback翻页被拦截时自动拉起浏览器由你手动完成验证后继续抓取。快速上手3 步完成安装与首次无水印下载第 1 步安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt如需使用浏览器兜底或自动获取 Cookie再安装pip install playwright python -m playwright install chromium第 2 步创建配置cp config.example.yml config.yml打开config.yml只需关注三处link要下载的链接列表、path保存目录、mode下载模式默认post。其余键位均有合理默认值。第 3 步获取 Cookie 并运行python -m tools.cookie_fetcher --config config.yml在弹出的浏览器中登录抖音回到终端按 EnterCookie 会自动写入配置。随后执行python run.py -c config.yml完成后在path指定目录下即可看到无水印视频文件。桌面版 Douzy 提供了同一后端的图形界面粘贴链接即可开始下载任务执行过程中的状态与结果可以在任务中心里查看失败项支持重试按任务办事四个典型目标的配置方式批量归档某位创作者的全部作品何时用需要长期保存某账号的作品并且希望定期同步新内容而不重复下载。怎么做link填作者主页链接https://www.douyin.com/user/{sec_uid}mode设为- postnumber.post设为0不限条数。保持increase.post: true默认开启程序会检查磁盘主文件已存在的作品直接跳过下次运行只补齐新增内容。如需按时间截取配合start_time/end_time格式YYYY-MM-DD。预期结果作品按作者目录 / post / 日期_标题_aweme_id落盘SQLite 数据库dy_downloader.db记录元数据去重采用数据库记录加本地文件的双重检查跨模式也不会重复下载同一aweme_id。注意磁盘文件缺失会触发重新下载只删数据库不删文件则不会重下。持续录制直播内容何时用直播内容结束后难以回看需要完整留存。怎么做link填直播间链接https://live.douyin.com/{room_id}。用live.max_duration_seconds控制录制时长0表示直到主播下播live.idle_timeout_seconds用于网络静默时提前结束。运行后无需干预程序自动选择可用清晰度中最高的一档ORIGINFULL_HDHDSD逐级降级。预期结果FLV 文件与*_room.json元数据保存在作者目录的live/下主播下播、网络中断或手动 CtrlC 时已录制的字节都会保留临时文件会被提升为正式文件。数据采集评论、热搜榜与关键词搜索何时用做内容分析、舆情跟踪只需要结构化数据而不下媒体文件。怎么做评论采集配置中设置comments.enabled: trueinclude_replies: true会额外抓取二级回复max_comments控制每条作品抓取上限每个作品旁生成{标题}_{aweme_id}_comments.json。热搜榜python run.py --hot-board 30 -p ./Downloaded结果写入Downloaded/hot_board/日期时间.jsonl。关键词搜索python run.py --search 关键词 --search-max 100 -p ./Downloaded结果写入Downloaded/search/关键词_日期时间.jsonl。预期结果JSONL 文件按行存储可直接用 pandas 或 jq 做后续统计。接入自动化REST API 服务模式何时用已有采集管道或脚本希望通过接口提交任务、轮询状态而不是手动跑命令行。怎么做一次性安装可选依赖pip install fastapi uvicorn。启动服务python run.py --serve --serve-port 8000默认监听 127.0.0.1。通过POST /api/v1/download提交{url: ...}拿到job_id再用GET /api/v1/jobs/{job_id}轮询状态GET /api/v1/jobs列出近期任务GET /api/v1/health用于健康探测。预期结果服务在内存中保留任务记录server.max_jobs默认 500与server.job_ttl_seconds默认 24 小时控制清理策略进行中的任务不会被清除。配置要点只改这三处就够了并发与限速config.example.yml中可调thread: 5 # 并发下载数默认 5 rate_limit: 2 # 请求限速默认 2 次/秒 retry_times: 3目录与命名默认folderstyle: true每个作品独立子目录filename_template/folder_template支持{date} {title} {id} {author} {mode}等变量要求模板至少包含{id}防止重名覆盖author_dir可选nickname/sec_uid/nickname_uid三种作者目录命名方式folderstyle: true filename_template: {date}_{title}_{id} author_dir: nickname_uid完成通知下载结束成功或失败时可并行推送多个渠道某个渠道失败不会阻塞下载流程notifications: enabled: true providers: - type: webhook url: 你的机器人地址webhook 渠道兼容企业微信 / 飞书 / 钉钉机器人地址此外还支持 Bark 与 Telegram。桌面端的对应设置界面如下避坑指南四种常见现象的原因与解法只拿到约 20 条作品原因抖音翻页风控拦截了后续分页。解法确认browser_fallback.enabled: true且headless: false浏览器弹出后手动完成验证不要提前关闭窗口注意该兜底目前仅对post模式完整验证过like/mix/music主要依赖 API 正常分页。Cookie 失效接口返回登录错误原因Cookie 过期或被平台刷新。解法重新执行python -m tools.cookie_fetcher --config config.yml走一遍登录即可。下载速度慢或频繁失败原因并发过高触发限流或网络出口不稳定。解法适当调低thread配合proxy配置代理程序自带指数退避重试1s、2s、5s与 Content-Length 完整性校验不完整文件会自动清理重下一般不需要人工介入。想查下载历史原因历史记录在dy_downloader.db的aweme表中。解法用 sqlite3 查询例如SELECT aweme_id, title, author_name FROM aweme ORDER BY download_time DESC LIMIT 20;。需要强制重下时删除本地文件目录并同步删除数据库对应记录两者都要动。douyin-downloader 项目在 gitcode.com/GitHub_Trending/do/douyin-downloader源码模块划分可在仓库 README 与core/、storage/目录中查阅。建议先用单条视频链接跑通全流程再切换到批量归档和直播录制等重任务。【免费下载链接】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），仅供参考