douyin-downloader 快速教程:把抖音主页作品批量下载到本地

发布时间:2026/9/18 21:31:45
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你刷到某个博主的主页想把 TA 的作品整批存到本地逐个点开、手动截图、再给文件一个个改名折腾半天还容易漏。douyin-downloader抖音批量下载工具就是为这种场景做的——把主页链接写进配置文件指定模式它就能把无水印视频、图文、合集、音乐一次拉下来进度展示、失败重试、数据库去重都默认开着你只管等。它能帮你解决的几件事链接即下载单个视频、图文、合集、音乐链接以及用户主页链接都能识别并下载视频优先选无水印源并在多个清晰度里自动挑最高码率。主页批量抓取按post作品、like点赞、mix合集、music音乐等模式批量拉取number里填数量上限填 0 就是全量。不白下、不重复SQLite 数据库加本地文件双重去重跨模式也不会重复配合增量开关和时间范围只追新作品。文件自动归档按作者、模式分目录文件名带发布日期和作品 ID旁边还生成封面、音乐、元数据 JSON 和一份下载清单download_manifest.jsonl。三步装好从克隆到第一次下载第一步装环境。需要 Python 3.8 及以上克隆仓库后装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt第二步准备 Cookie。复制一份配置文件然后跑内置的 Cookie 获取工具它会打开浏览器带你登录抖音登录完回终端按 Enter认证信息自动写入配置认证信息只存在本地cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml第三步开下。打开config.yml把要下的链接写进link把mode设为post、number.post填想下载的数量比如 50path填保存目录然后运行python run.py -c config.yml命令行还能临时覆盖配置比如加链接、改并发、改目录python run.py -c config.yml -u 链接 -t 8 -p ./Downloaded。首次建议先只下 2、3 个作品确认目录结构和文件都符合预期再放大数量。核心工作流按任务来下载存档一个具体链接把/video/...、/note/...、/collection/...或/music/...链接放进link即可v.douyin.com短链会自动解析。音乐链接会优先下载原声文件拿不到时回退到使用该音乐的首条作品。这是最轻量的用法适合就这一个帮我存下来的需求。批量拉取一位作者的主页想整理某位创作者的内容时链接换成/user/{sec_uid}形式mode决定拉哪类内容number控制每种模式拉多少link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, mix] number: { post: 100, mix: 0 }多种模式可以并列写同一个作品在不同模式里命中也只下载一次。另外/user/self?showTabfavorite_collection配collect/collectmix模式可以批量下载当前登录账号自己的收藏夹和收藏合集这两种模式需单独使用。只追新增增量与时间范围定期跑同一个作者时打开increase对应模式的开关程序会按数据库里的记录跳过已下载的作品只下新的。再配合start_time/end_time格式YYYY-MM-DD可以把范围收窄到某段时间——做资料归档时特别有用。下载完文件长什么样默认folderstyle: true目录按作者 → 模式 → 单个作品组织Downloaded/ ├── download_manifest.jsonl # 每次下载追加一条记录 └── 作者名/ └── post/ └── 2024-06-15_作品标题_aweme_id/ ├── ...mp4 # 无水印视频 ├── ..._cover.jpg ├── ..._music.mp3 └── ..._data.json # 完整元数据日期取的是作品发布时间而不是下载时间同一天的作品排在一起肉眼就能按时间线浏览。数据库默认dy_downloader.db里还有一份aweme明细表和任务历史表想查上周下了什么直接用 SQL 就行。进阶能力按使用价值分组请求被限制时浏览器兜底主页翻页经常被风控截断常见现象是只抓到 20 条。项目在browser_fallback里内置了兜底方案开启后建议headless: false它会启动一个真实浏览器替你翻页弹出验证码时你手动过掉即可。用到这个能力需要先装 Playwright 并下载 Chromium。网络不稳定时还可以给 API 和媒体下载统一挂代理proxy配置项并发和重试次数thread/retry_times也都可以按需收紧。让内容更深一层下载不止是存视频。comments配置项可抓每个作品的评论含二级回复可选输出 JSONtranscript开启后会调用 OpenAI 转写接口给视频生成 txt 和 json 两种格式的文稿适合做内容分析和字幕--hot-board与--search两条命令能把热搜榜、关键词搜索结果导出成 JSONL做选题参考很方便。另外直播房间链接live.douyin.com/{room_id}支持实验性录制中断或下播时已录的片段都会保留。这些功能的源码分别在 core/comments_collector.py 与 cli/whisper_transcribe.py 一带有兴趣可以顺着看。当服务跑或用桌面版加--serve可以把下载器变成一个本地 REST 服务提交链接拿job_id再轮询状态方便嵌进自己的脚本或系统。也提供 Dockerfile挂载配置文件和输出目录即可容器化部署。同仓库还配套了内测中的桌面客户端 Douzy粘贴链接即可开始、可同步关注列表、任务中心里看进度和重试失败项对受风控限制较多的下载场景更友好。排障速查只抓到 20 条左右就停了→ 翻页被风控截断 → 确认browser_fallback.enabled: true且headless: false弹窗出来手动过验证码别急着关窗口。部分接口 403、整体下不动→ 抖音侧风控门禁升级CLI 直连受限 → 换桌面版 Douzy内置登录窗口代发请求或等浏览器兜底生效。Cookie 失效→ 重新跑一次python -m tools.cookie_fetcher --config config.yml即可无需改其他配置。想重新下载某条作品却跳过了→ 程序同时查数据库和本地文件 → 数据库记录和对应文件目录要一起删只删一个不生效。进度条刷屏、日志太吵→progress.quiet_logs: true默认已开启调试时再加-v或--show-warnings。没生成转写文件→ 依次查transcript.enabled是否为 true、是不是视频图文不转写、API Key 是否有效。下一步douyin-downloader 的价值在于把下载变成一件可重复、可追溯、不重复劳动的事配置一次之后就是增量追新、自动归档、随时可查。建议你先从一个单视频链接开始跑通第一次下载然后挑一位作者试 10 条批量最后再打开增量、评论和转写这些进阶项。最后提醒一句请仅把学习、研究和个人备份作为用途尊重创作者的劳动成果与平台规则下载的内容不要用于商业传播或侵犯他人权益。【免费下载链接】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),仅供参考