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-downloaderdouyin-downloader 是一个 Pythonasyncioaiohttp编写的抖音批量下载工具覆盖单条链接与作者主页两级范围的无水印下载视频、图文图集、合集与音乐原声并内置并发限速、指数退避重试和 SQLite 去重。一切由一份 YAML 配置加一条python run.py -c config.yml命令驱动。硬性前提是有效的抖音 Cookie 登录态由 tools/cookie_fetcher.py 获取且自 2026-08 起平台风控已封锁大部分 API 直连路径能力边界必须先看清再动手。先看清单支持什么、被风控挡住什么、前提是什么适合两类人需要按作者归档抖音作品库的开发者以及要做本地内容备份的管理者。它解决的是多链接、去重、可重复执行的批量问题而不是单次下载。可用作者主页作品下载当前唯一走得通的 API 外围路径是浏览器兜底、直播录制实验性、热搜榜与关键词搜索的 JSONL 导出--hot-board/--search、REST API 服务模式--serve需fastapiuvicorn。被 403 拦截2026-08 起单条视频/图文、合集、音乐、点赞列表、收藏夹的 CLI 直连接口均被 ArgusSecurityPlugin 拒绝刷新 Cookie 无法修复主页作品仅能走 Playwright 浏览器兜底且官方声明不保证成功。明确不支持抖音放映厅影视内容lvdetailDRM 加密无成片可取HLS 直播源只保存 playlist 文件而非可播放视频需 ffmpeg 后处理。前提条件有效 CookiemsToken、ttwid、odin_tt、passport_csrf_token等键浏览器兜底与取 Cookie 都依赖playwright chromiumffmpeg、OpenAI 密钥、fastapi/uvicorn均为可选依赖。第一次运行5 步完成安装、登录与首次下载克隆仓库并安装核心依赖要求 Python 3.9Windows/macOS/Linux 均可git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt安装浏览器组件。取 Cookie 和翻页兜底共用这一套缺一不可python -m pip install playwright python -m playwright install chromium复制配置并完成 Cookie 登录。命令会打开浏览器进入抖音手动登录后回到终端按回车Cookie 自动写入config.ymlcp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml写最小配置。示例里number.post: 1只抓 1 条首次验证建议改成小整数确认无误再放开为0不限link: - https://www.douyin.com/user/YOUR_SEC_UID path: ./Downloaded/ mode: - post number: post: 10执行第一条下载命令。临时追加链接不改配置用可重复的-u参数--help可查看全部选项-p改目录、-t改并发等python run.py -c config.yml配置速查10 个最常改的参数及其默认值参数作用默认值备注/限制link下载目标字符串或数组单条作品与主页链接可混排短链自动解析无必填收藏夹场景指向自己主页mode主页抓取范围post/like/mix/allmix/music可组合[post]collect/collectmix必须单独使用number各模式数量上限0表示不限全0注意config.example.yml里post: 1只是示例thread并发下载 worker 数5调高易触发限流video_quality画质选档highestoriginal每条作品多发一次探测请求10s 超时分辨率档匹配不到时降级到最接近可用档start_time/end_time作品发布时间区间YYYY-MM-DD空不限含 end 当天整天increase各模式增量开关true跳过已下载作品全true依赖databaseredownload_missing_files磁盘主文件缺失时是否重下truefalse时数据库记录有效则继续跳过database/database_pathSQLite 去重与下载历史true/dy_downloader.db关库后增量与去重同时失效browser_fallback.headless兜底浏览器是否无头false有头便于人工过验证enabled默认truemax_scrolls240wait_timeout_seconds600场景走查一次作者主页增量下载 一次自己的收藏夹场景 A下载某作者指定时间段的全部作品6 步在 config.example.yml 基础上把link填为主页地址start_time/end_time限定区间number.post: 0表示全量。执行python run.py -c config.ymlcli/main.py 校验配置、按需初始化 SQLite再逐条遍历链接。短链先由 core/api_client.py 重定向解析core/url_parser.py 从 URL 中提取sec_uid并输出链接类型。core/downloader_factory.py 把user类型分发给 core/user_downloader.py按mode执行 core/user_modes/ 下的策略post策略按游标翻页作品发布时间越过时间上界即提前停止core/user_modes/post_time_boundary.py。每条作品进入 core/video_downloader.py 挑选无水印源、按video_quality选档thread默认 5个 worker 并发拉流单请求限速 2 次/秒control/rate_limiter.py失败重试 3 次、退避 1s/2s/5scontrol/retry_handler.py。API 翻页被拒时由 core/api_client.py 启动浏览器兜底读取页面自己发出的作品列表请求最多等 600 秒人工过验证文件经 storage/file_manager.py 落盘storage/database.py 用aweme表记录 文件名中的aweme_id双重去重。场景 B下载自己的收藏夹4 步mode设为[collect]收藏文件夹或collectmix收藏合集link指向自己主页这两者与post/like/mix/music不可混用core/user_downloader.py 在_validate_mode_scope中直接拦截。收藏夹仅对当前 Cookie 对应的账号生效列表由 core/api_client.py 拉取。现实约束2026-08 起收藏夹接口的非浏览器请求被 403CLI 没有签名通道此场景大概率整体不可用跑之前要有预期。能通过的部分下载、命名与去重路径与场景 A 第 6 步完全一致。六个常见现象的排查路径现象主页任务最终只抓到前几十条甚至失败。原因API 翻页被风控拒绝浏览器兜底是唯一路径且官方不保证成功。处理确认browser_fallback.enabled: true、headless: false在 600 秒窗口内手动完成验证仍无果属于平台现状不是配置问题。现象单条视频/点赞/收藏/合集/音乐接口返回 403Blocked by ArgusSecurityPlugin。原因平台边缘风控拦截非浏览器请求与 Cookie 新旧无关。处理不要再反复刷 Cookie这类内容当前只有同后端桌面版可用。现象想重下某作品却被跳过。原因去重是数据库记录 文件名aweme_id双重判断只删了其中一份仍算已下载。处理同时删除Downloaded/{作者}/{模式}/*_{aweme_id}/目录与aweme表对应记录。现象增量模式仍重复下载旧作品。原因database: false或对应模式increase为false。处理置database: true、increase: true反过来想强制重下并覆盖就把increase置false。现象速度慢、重试日志频繁。原因并发过高或 IP 被限流。处理调低thread、配置proxy走代理单请求 2 次/秒的限速与 1s/2s/5s 退避是内置行为属正常现象。现象任务中途提示登录态失效。原因Cookie 过期。处理交互环境下工具会自动开浏览器重登一次并重跑当前链接非交互环境手动重跑python -m tools.cookie_fetcher --config config.yml。合规边界开始下载前自问五条下载内容仅限个人学习、研究与本地归档不做二次分发或商业用途。遵守抖音平台条款与所在司法辖区法规不批量采集特定账号的私密数据不侵犯创作者版权。平台接口与风控策略随时调整会导致功能降级本工具已先后经历 2026-08、2026-09 两轮封锁这是需要接受的正常技术风险。CLI 为非浏览器直连高频高并发会增加限流与账号风险用thread与proxy自行控制节奏。使用行为与后果由使用者自行承担。工具适合需要搭建本地抖音内容归档库的开发者与内容管理者完整参数清单与默认值见 config.example.yml。【免费下载链接】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），仅供参考