抖音批量下载完整上手指南30 分钟备份一个作者的全部作品无水印【免费下载链接】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就是为这件事写的开源工具——作者主页全量批量下载、无水印、视频/图文/音乐/封面一并打包还内置了去重、重试和断点续传。这篇指南会带你从零跑通第一个下载任务再逐步解锁增量备份、直播录制这类进阶玩法。读完这篇你能带走 6 个具体能力用一条命令把一个抖音视频存成无水印的本地文件15 分钟内配好环境把某个作者主页的几百个作品批量搬回家彻底搞懂 Cookie 是怎么回事不再被未登录三个字劝退学会增量下载作者更新了作品你一条命令就把新的补全遇到只抓到 20 条下载到一半断了时知道该往哪排查摸清直播录制、评论采集、REST API 这些高阶玩法在哪里开启先花 30 秒判断这个工具适不适合你它适合这样的人手机里攒了一堆舍不得删的抖音内容想要的是批量、可重复、不会漏的本地备份并且能接受编辑一个 yml 文件这种程度的操作。它也确实是为命令行设计的——别怕全文只需要你复制粘贴命令不需要懂编程。如果你完全不想碰终端项目还附带了一个桌面版客户端 Douzy目前内测中界面就是下面的截图操作更直观但功能迭代和稳定性不如命令行版。我的建议是命令行版打底桌面版尝鲜。第一个实战任务把一位作者的主页备份到本地接下来的目标很具体挑一位你喜欢的创作者把他最近的 50 个作品完整下载到本地。每一步我都会告诉你这段在做什么以及怎么验证它成功了。第 1 步确认 Python 环境项目要求 Python 3.8 以上。终端里敲这一条有版本号输出就说明环境没问题python --version没有 Python 的话先去官网装一个全程默认选项即可大概 5 分钟。第 2 步拿到代码与依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader注意项目仓库里套着一个douyin-downloader目录V2 版本的代码都在里面requirements.txt也在这里。接下来装依赖python -m pip install -r requirements.txt小提示如果你网络不好可以在命令末尾加上国内镜像源-i https://pypi.tuna.tsinghua.edu.cn/simple加速。还有一条可选但强烈建议的命令——项目靠 Playwright 做浏览器兜底翻页被风控时自动开浏览器帮你过验证装好后能省掉很多麻烦python -m pip install playwright python -m playwright install chromium第 3 步配置只改一处复制配置模板然后打开config.ymlcp config.example.yml config.yml这个文件有上百行但新手只需要改link那一段。找到你喜欢的作者主页链接在抖音 App 里点作者头像 → 右上角分享 → 复制链接把它填进去link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ mode: - post number: post: 50上面这几行的含义分别是下载这个主页、保存到Downloaded/目录、post模式下载作者发布的作品不是点赞、最多下 50 个。如果想全量下载把post: 50改成post: 0即可。第 4 步搞定 Cookie绕过未登录抖音的接口需要登录态也就是 Cookie。项目提供了自动获取工具会打开一个浏览器窗口你扫码登录抖音后按一下回车它会自动把 Cookie 写进config.ymlpython -m tools.cookie_fetcher --config config.yml放心Cookie 只保存在你本机的配置文件里不会上传到任何服务器。它一般不会马上失效但某天下载报未登录了重新跑一次这条命令就行。第 5 步先拿单个视频试链路不建议上来就批量。把config.yml里的link临时换成一条分享链接App 里分享 → 复制链接出来的那种https://v.douyin.com/xxxx/短链也支持工具会自动解析然后运行python run.py -c config.yml正常的话你会看到类似下面这样的命令行界面有进度条、有跳过已存在的去重提示最后显示成功 1/1。第 6 步正式批量备份链路通了把link换回作者主页链接number.post保持 50再跑一次python run.py -c config.yml第 7 步看看成果长什么样下载完成后目录结构是这样的——按作者、按模式、按作品分门别类非常清爽Downloaded/ └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 # 无水印视频 ├── 2024-02-07_作品标题_aweme_id_cover.jpg # 高清封面 ├── 2024-02-07_作品标题_aweme_id_music.mp3 # 原声音乐 └── 2024-02-07_作品标题_aweme_id_data.json # 作品元数据注意文件名前缀的日期是作品发布时间不是你下载的时间——这一点对后期整理特别友好。进阶地图从会下载到用好它工具跑通之后你值得拥有一张能力地图。我把它的高阶功能按四个方向归好类每项都是一句话价值加最小配置按需取用即可。数据层让备份越来越省心增量下载——第一次全量备份后作者每发新作品你只需补新的。这是最有价值的一个功能increase: post: true database: true # 增量依赖 SQLite 数据库记录时间过滤——只想备份某段时间的作品避免把作者三年前的黑历史也搬回来start_time: 2024-06-01 end_time: 2024-06-30命名模板——不想用默认的{date}_{title}_{id}支持{year}、{month}、{author}等变量随意组合模板里记得保留{id}防止重名覆盖filename_template: {date}_{title}_{id} folder_template: {date}_{title}_{id}下载历史都会记在dy_downloader.db里你可以随时查询哪些作品下过、什么时候下的sqlite3 dy_downloader.db SELECT title, author_name, datetime(download_time,unixepoch,localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;内容层视频之外的东西也能要直播录制——支持live.douyin.com直播间实时录制主播下播时已录的数据会保留FLV 可直接播放link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0 # 0 录到主播下播评论采集——需要做内容分析的场景可以按作品抓评论支持二级回复输出结构化 JSONcomments: enabled: true include_replies: false # true 会多拉二级回复请求量翻倍 max_comments: 500自动化层让工具自己干活REST API 服务模式——把下载能力暴露成接口方便接到自己的系统里python -m pip install fastapi uvicorn python run.py --serve --serve-port 8000启动后POST /api/v1/download提交链接就能创建任务GET /api/v1/jobs查询状态适合做自动化流水线。完成通知推送——下载完自动通知你支持 Bark / Telegram / Webhooknotifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY热搜榜与关键词搜索——不下载视频也能抓取数据快照python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded可视化层看得到进度才不慌命令行自带的 Rich 进度条支持任务统计、实时事件日志还能用progress.quiet_logs: true关掉刷屏。如果你更习惯图形界面桌面版 Douzy 的任务中心长这样——每个任务的状态、进度、事件流都一目了然。翻车急救站五个高频翻车现场与自救方法下面这些场景基本每个用这个工具的人都遇到过。按症状 → 原因 → 解法对照排查即可。点下回车却什么都没发生症状python run.py -c config.yml运行后像石沉大海没有任何输出。原因绝大多数情况是 Cookie 缺失或已失效。解法重新跑一遍python -m tools.cookie_fetcher --config config.yml扫码登录后确认config.yml里cookies段有内容。只抓到 20 条作品就停了症状明明设置了number.post: 0全量结果列表停在 20 条。原因这是抖音翻页风控的典型表现API 分页被拦了。解法确认配置里browser_fallback.enabled: true、browser_fallback.headless: false。运行时会弹出浏览器窗口出现验证码时手动完成验证别急着关窗口程序会继续往下翻。下载到一半断了留下一个坏文件症状视频下到 80% 断网重启后那个文件还在。原因下载中断导致文件不完整。解法不用手动清理。工具内置了完整性校验比对 Content-Length不完整的文件会被自动删掉并重试配合retry_times: 3重跑一次命令就能补齐。第二次下载同一个作者好像重复下了一遍症状日志里出现大量跳过已存在但你还是有点慌。原因这恰恰是去重在生效。工具通过SQLite 数据库记录 本地文件双重检查判断是否已下载。解法什么都不用做。如果想强制重新下载某个作品需要同时删掉对应文件目录和数据库里的记录DELETE FROM aweme WHERE aweme_idxxx;——只删一边都不会触发重下。进度条疯狂刷屏看得头疼症状终端像弹幕一样滚动找不到关键信息。原因默认其实已经开了progress.quiet_logs: true如果你改过或者加了-v参数就会进入详细日志模式。解法确认quiet_logs为true调试完去掉-v即可。三件小事今天就能做今天完成 clone 装依赖 用一条单视频链接跑通链路全程约 15 分钟。本周跑一次cookie_fetcher配好 Cookie挑一位作者用post模式备份 50 个作品。长期打开increase.post和database让以后的补新变成一条命令的事。最后提醒一句内容请仅用于个人学习、研究或备份尊重创作者的劳动成果。工具本身只是把收藏这件事做得更体面——好工具不是用来收藏的是用来跑起来的。现在去把你的第一条命令敲下去吧。【免费下载链接】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），仅供参考
