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 是一款开源的抖音下载工具把视频、图集、合集、音乐批量存成本地无水印文件还能录直播、抓评论。本文写给第一次上手的普通用户和需要定期保存内容的创作者按安装 → 登录 → 配置 → 运行的顺序完整走一遍。一、盘点 douyin-downloader 的功能一次看懂能下什么、产出什么上手前先花一分钟对照这张表确认它覆盖不覆盖你的需求核心功能适用场景最终产出单条视频 / 图文下载保存某一条作品或图集无水印文件 封面、BGM、元数据 JSON作者主页批量下载整页归档某位创作者的作品、点赞、合集、音乐按作者分目录的成批文件增量补更定期追更避免重复下载只落盘数据库里没有的新作品收藏夹同步把自己账号点赞过收藏夹里的内容存到本地当前登录账号收藏内容的本地副本合集与原声音乐整套教程合集、单首背景音乐整组合集文件 / 音乐文件直播录制开播时挂机下播后补看FLV 录像 直播间元数据 JSON评论与热搜数据内容研究、选题观察结构化 JSON / JSONL 数据文件两个默认行为值得记住媒体文件优先选择无水印源并在多档清晰度里自动挑码率最高的一档。二、安装依赖并获取 Cookie十分钟完成第一次无水印下载1. 克隆项目并确认 Python 版本要求Python 3.8 及以上macOS / Linux / Windows 均可python --version git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader你应该看到python --version输出 3.8 或更高进入目录后能看到run.py、config.example.yml、requirements.txt这几个文件说明项目完整。2. 安装依赖pip install -r requirements.txt你应该看到结尾出现Successfully installed ...没有红色 ERROR。提示如果安装很慢或报网络错误临时换用国内镜像源pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple之后如果打算用浏览器兜底批量下载被限流时的备用通道后面会讲再补装一套浏览器组件pip install playwright python -m playwright install chromium3. 复制配置模板并获取登录凭证抖音的完整内容只对已登录用户开放所以需要先拿到你的登录凭证——Cookie。你可以把Cookie 理解成进展会的胸牌服务器看到它才认定这个请求来自一个真实登录的账号。cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml你应该看到自动弹出浏览器用手机抖音扫码登录回到终端按一次回车Cookie 就写进了config.yml。它只保存在你本地。注意胸牌有有效期Cookie 一般一两周过期。过期后不用动任何其他配置重跑上面第二条命令即可。4. 修改最小配置打开config.yml把link换成你要下载的视频或图文链接其余项保持模板默认即可link: - https://www.douyin.com/video/XXXXXXXXX # 换成你的视频/图文链接 path: ./Downloaded/ # 文件保存目录 music: true # 同时下载背景音乐 cover: true # 同时下载封面图 json: true # 保存作品元数据标题、发布时间、点赞数等全部字段的含义可以参考 douyin-downloader/config.example.yml。5. 运行下载任务python run.py -c config.yml你应该看到终端先打印链接解析结果和下载配置总数、线程数、保存路径随后出现进度条推进到 100%最后输出下载完成和保存位置。6. 查看下载结果Downloaded/目录下会出现一个以作品命名的文件夹内容整整齐齐Downloaded/ └── 作者昵称/ └── post/ └── 2024-06-15_作品标题_作品ID/ ├── 2024-06-15_作品标题_作品ID.mp4 # 无水印视频 ├── 2024-06-15_作品标题_作品ID_cover.jpg # 封面图 ├── 2024-06-15_作品标题_作品ID_music.mp3 # 背景音乐 └── 2024-06-15_作品标题_作品ID_data.json # 元数据命令行展示了时间范围过滤、下载配置、进度条和底部下载统计可对照确认任务是否成功结束、文件落在哪个路径到这里你的第一条无水印视频已经到手。三、跑三个高频场景批量保存作者主页、增量补更、录制直播场景 1整页保存一位作者的作品关注一位创作者很久想把他发布的内容整体归档把主页链接填进去、指定模式就行link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 作者主页链接 mode: - post # 只下他发布的作品还支持 like/mix/music number: post: 50 # 只下载最近 50 个0 表示全部 start_time: 2024-06-01 # 起始日期只取这个日期之后发布的作品 end_time: 2024-06-30 # 截止日期两个时间都留空则不限制其中thread: 5表示同时用 5 个人手并行下载就像超市多开几个收银台数量越大提速越明显。你会得到每个作品一条独立进度条并行推进失败的自动重试文件按作者 → 模式 → 作品三级目录归位。批量下载时每个作品都有独立进度条并发执行可直观确认并行与重试是否生效下载完成后的目录按日期_标题_作品ID分门别类存放可确认命名规则是否符合预期场景 2开启增量模式只拉新作品上周已经存了 50 条这周作者又更新了你不想把旧内容再下一遍。打开增量开关database: true # 开启 SQLite 记录库每次下载的作品 ID 都记一笔 increase: post: true # 只下载数据库里没有的新作品这相当于一本借阅台账每次借出都登记在册下次再跑同一个作者时台账里有记录的一律跳过只发新书。你会得到工作目录生成dy_downloader.db台账文件再次运行时旧作品显示跳过已存在磁盘上只有新增内容。场景 3挂机录制一场直播博主开播时你没空守着把直播间链接写进配置让它替你守夜link: - https://live.douyin.com/123456789 # 直播间链接 live: max_duration_seconds: 3600 # 录满 1 小时自动收尾填 0 则录到主播下播你会得到FLV一种可直接播放的视频格式录像保存在Downloaded/{作者}/live/下附带直播间元数据 JSON 快照。中途下播或按 CtrlC 中断已录制的部分都会自动保留不会白等。录制前会列出可选清晰度和直播流地址输入编号即可开始可确认直播间信息与流地址是否正常解析四、配置进阶能力去重续传、API 服务与完成通知跑通基础流程后这几项能力可以让任务更省心按需开启即可断点续传与完整性校验中断后重跑会跳过已完成文件每个文件还会和服务端声明的大小做一次比对——像快递员拿秤核对包裹重量缺斤少两就自动清理重下。REST API 服务模式先执行pip install fastapi uvicorn再运行python run.py --serve --serve-port 8000就可以通过POST /api/v1/download提交下载任务、查询任务状态适合接进自己的自动化流程。完成通知推送notifications.enabled: true并配置 Bark / Telegram / Webhook 任一渠道任务成功或失败时手机即时收到推送。视频语音转写transcript.enabled: true并设置OPENAI_API_KEY环境变量后每个视频会额外生成.transcript.txt文字稿方便检索。自定义命名模板filename_template: {date}_{title}_{id}可自由组合{date}、{title}、{author}、{id}四个变量必须包含{id}避免重名覆盖。项目还配套了处于内测期的桌面客户端基于同一套后端粘贴链接即可开始下载任务中心可以逐条回看每个任务的状态与耗时桌面版任务中心逐任务展示状态与结果可确认长任务最终是否成功、耗时多少更完整的参数说明见 douyin-downloader/README.zh-CN.md。五、排查常见问题Cookie 过期、翻页受限、中断与慢速现象一报 403 或提示未登录现象终端出现403 Forbidden或任务解析不出任何作品。原因Cookie 过期这是最高频的情况。解法重新运行python -m tools.cookie_fetcher --config config.yml扫码后按回车。建议每周固定刷新一次。现象二批量下载卡在二三十条不动现象抓取作者主页到 20~30 条左右就不再增长。原因抖音对连续翻页做了风控限制API 不再发放下一页。解法开启浏览器兜底——相当于线上窗口办不了时安排工作人员陪你到线下柜台人工核验browser_fallback: enabled: true headless: false # 保持窗口可见方便你手动完成验证弹窗出现后手动完成验证即可别急着关窗口等它跑完自然补齐。现象三中断之后担心要全部重来现象网络断开或手动停止后不知道已完成的部分还算不算数。原因其实工具内置了去重与完整性校验已完成的作品都记录在案。解法确认配置中database: true已开启直接重跑python run.py -c config.yml已完成文件会显示跳过已存在只补缺的部分。现象四下载速度明显偏慢现象进度条推进缓慢偶尔出现超时重试。原因网络环境不稳或并发开得太高导致重试变多。解法把并发调小、重试调大有代理环境就填上代理地址thread: 3 # 并发数从默认 5 调小 retry_times: 5 # 失败重试次数 proxy: http://127.0.0.1:7890 # 代理地址不用则留空写在最后按这个顺序开始先跑单条视频完整走完第二节确认环境和 Cookie 都没问题再试整页批量挑一位你真喜欢的作者用modenumber限定数量感受批量下载的节奏最后打开进阶开关按需启用增量补更、时间过滤、直播录制和完成通知让工具贴合你的使用习惯。无水印、有目录、可追溯——让内容从云端随时会消失变成硬盘上随时能翻出的东西才是收藏这件事真正的落点。【免费下载链接】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），仅供参考