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 是一个本地化的抖音批量下载工具把作者主页链接写进一份 YAML 配置它就能抓取无水印作品、按层级存好文件、记录下载历史。它面向需要持续归档或分析抖音内容的创作者、运营和数据研究者。仓库提供两个入口仅支持抖音的 Python 命令行版以及粘贴链接即可用的 Douzy 桌面版。项目定位为什么选这套本地批量下载方案手动归档抖音内容很繁琐链接逐条复制存下来的文件带水印又散落各处目录里没有标题和互动数据重跑一遍还会重复下载。这个项目用一份配置文件取代这些手工步骤抓取、去重、归档、历史查询都发生在你自己的机器上。需要知道的一点现状抖音接口风控在收紧命令行版目前主要用于作者主页作品的批量抓取可配合浏览器兜底不保证成功日常使用建议用 Douzy 桌面版支持抖音、TikTok、YouTube 等平台在窗口里粘贴链接、跟踪任务、浏览本地档案。三个核心价值本地去重与增量是否跳过以磁盘上的主媒体文件核查为准dy_downloader.db与download_manifest.jsonl同步记录历史重跑不会下载同一作品两次。元数据随作品落地视频之外可附带封面、音乐、头像、JSON、评论清单与转写文本全部放在同一目录。浏览器兜底翻页被风控拦下时自动打开真实浏览器你手动完成验证后继续抓取。功能说明下载效率、文件组织与数据如何落地这一节按三组说明能力抓得快不快、文件怎么摆、还能留下哪些数据。下载效率作者主页支持post、like、mix、music等多种模式number按模式限制条数0表示全量。默认thread: 5并发下载失败按 1s、2s、5s 阶梯等待后重发retry_times默认 3 次视频源优先选无水印地址video_quality可在默认的最高转码档、原画与固定分辨率之间切换。文件组织产物按「作者—模式—作品」三层存放文件名日期前缀取作品发布时间模板由filename_template统一生成默认{date}_{title}_{id}start_time/end_time按发布日期圈定范围download_pinned控制是否包含置顶作品。数据与元数据除视频本体外path根目录会写清单download_manifest.jsonl每行一条 JSON含发布日期、作品 ID、标签、文件路径开启comments或transcript后对应数据文件与视频同目录。是否写入 SQLite 由database开关控制默认开启更细的设计与规划文档见 docs/。首次运行从安装到出文件只需三步Python 3.9 及以上即可。每一步做完核对「预期结果」不一致就停下来排错。装依赖。拉取代码并安装包含 Cookie 获取与浏览器兜底所需的浏览器组件git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader python -m pip install -r requirements.txt python -m pip install playwright python -m playwright install chromium预期结果终端无报错运行python run.py --help能打印参数列表说明命令行可用。配置认证Cookie。复制模板配置 config.example.yml 并运行内置获取器cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml预期结果浏览器打开登录抖音后回到终端按 Enterconfig.yml的cookies段msToken、ttwid 等自动填好已有 Cookie 可直接手填到该段。填链接并运行。把config.yml里link的示例改成目标作者的主页地址python run.py -c config.yml预期结果./Downloaded/出现「作者名/模式/作品」三层文件-v输出详细日志-u可临时追加链接-t调整并发数。实战用法三个高频需求与最小配置挑出你要经常跑的需求每个给最小配置即可。批量归档多位作者你的目标一次把两三个对标作者的作品按量存下来。link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: [post, mix] number: post: 100 mix: 0得到两种模式的作品分目录存放post与mix中重复出现的作品去重后只存一份number.post: 100表示最多抓 100 条0不限。定期增量补档你的目标定期重跑同一份配置只补新发布的作品。increase: post: true mix: true得到重跑时磁盘上主文件已存在的作品直接跳过只抓新作品。想强制重下并覆盖把它设为false即可不必清空数据库redownload_missing_files默认true负责补缺失文件。评论与转写随作品导出你的目标文件之外还要数据比如把抖音评论导出成可分析的 JSON。comments: enabled: true max_comments: 500 transcript: enabled: true model: gpt-4o-mini-transcribe得到每个作品目录多出一份{作品名}_comments.json评论清单视频作品另有.transcript.txt/.transcript.json转写文本密钥从OPENAI_API_KEY环境变量读取图文不参与转写。常见问题抓取变少、登录失效与转写缺失先判断原因再动手处理以下办法都能在 README 和配置模板中对应到。为什么主页只抓到少量作品通常是翻页被风控验证拦下。把browser_fallback.enabled设为true、headless设为false触发拦截时会弹出浏览器窗口手动完成验证后继续抓取不要提前关闭窗口。也要知道现状限制个别作品、合集、音乐、喜欢等接口目前在 CLI 下也被风控拦截刷新 Cookie 或重试都无效这类需求建议改用 Douzy 桌面版。Cookie 过期了怎么办Cookie 是有时效的登录凭证过期后接口会要求重新登录。重跑获取器即可刷新python -m tools.cookie_fetcher --config config.yml浏览器登录成功后按 Enter 生效获取逻辑在 tools/cookie_fetcher.py可自行查看实现。转写文件为什么没生成按三步核对transcript.enabled是否为true作品是否为视频图文不转写OPENAI_API_KEY环境变量是否为有效密钥。三项都满足后重跑任务到作品目录找.transcript.txt/.transcript.json。下载变慢或中断了怎么办并发过高容易触发限流。把thread调低例如 3再用-v详细日志定位卡在哪一步内置重试会按 1s、2s、5s 阶梯重发少量瞬时失败通常自行恢复。想省空间可用start_time/end_time缩小范围或调低number的条数上限。如果你需要长期归档这套工具把下载、去重、增量与历史查询都留在了本地数据不出机器。平台风控持续变化保持项目更新、定期校验 Cookie 是稳定运行的关键。下载内容请仅用于个人学习、研究与备份尊重创作者合法权益不用于商业用途。【免费下载链接】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），仅供参考