抖音下载器 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很多人对抖音下载的刻板印象还停留在那个场景复制链接、打开某个在线去水印网站、等解析、关掉三个弹窗广告、再小心翼翼保存——麻烦不说还经常下到带水印的糊版。而 douyin-downloader 这个开源项目把这件事压缩成了一条命令视频、图文、合集、音乐、直播回放都能存作者主页几百个作品也能一次拉完默认还自带去重、重试和进度展示。下面这份上手指南我会从怎么把程序跑起来讲到批量下载怎么配置再给你几个让工具更好用的小开关全程不写一行代码逻辑复制粘贴就能跟着走。先花一分钟看看它到底能干什么能力一句话说明单个视频/图文/合集/音乐下载把链接扔进配置或命令行参数即可抖音短链也会自动解析作者主页批量下载一次拉完某创作者的作品、点赞、合集、音乐四类可分可合直播录制支持 FLV / HLS 两种流主播下播后已录内容自动保留智能去重SQLite 数据库 本地文件双重检查同一个作品不会下第二遍增量下载上次下到哪了它记得住下次只补新内容细节兜底无水印优先、自动选最高清、失败指数退避重试、时间范围过滤延伸能力评论采集、热搜榜导出、关键词搜索、REST API 服务、下载完成推送通知你可能会想功能这么多是不是配置很复杂其实恰恰相反它的默认配置就能直接跑下面从零开始走一遍。从零到跑通只需要四条命令第一步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt注意克隆下来后主程序在douyin-downloader这个子目录里之后的命令都要在这里执行。环境要求是 Python 3.8 及以上Windows、macOS、Linux 都支持。如果你后面想用浏览器兜底翻页或自动获取 Cookie这两项能力再补装一个 Playwrightpip install playwright python -m playwright install chromium这一步不是必须的可以先跑起来遇到翻页受限时再回来装。第二步让程序认领你的身份Cookie 认证抖音的部分数据需要登录态才能访问douyin-downloader 把获取 Cookie 这件事做成了全自动python -m tools.cookie_fetcher --config config.yml运行后会自动打开一个浏览器窗口你正常扫码登录一次抖音回到终端按一下回车认证信息就被写进配置文件了。整个过程不用碰开发者工具也不用复制粘贴那一长串看不懂的字符。第三步写一份最小配置从项目里复制一份模板改成下面的样子就能用cp config.example.yml config.ymllink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成你自己的链接 path: ./Downloaded/ # 下载文件的保存目录 mode: - post # 下载该作者发布的作品 number: post: 10 # 只下载最新的 10 个0 表示全部下载 thread: 5 # 并发下载数网络好可以调大 retry_times: 3 # 单个文件失败重试次数 database: true # 开启 SQLite 去重和历史记录第四步运行python run.py -c config.yml看到一行行刷新的进度条就是它开始干活了。下面的截图就是批量下载时的真实界面进度百分比、成功/失败计数一目了然你只管盯着看就行。三个高频场景照着抄就能用场景一刷到喜欢的视频一条命令收进硬盘不用建配置文件命令行直接追加链接就行python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789-u后面是视频链接-c指定配置文件。如果手头只有分享出来的短链比如https://v.douyin.com/xxxxx/也支持自动解析。下载完成后程序会在目录里同时生成视频本体、封面图、背景音乐和一份 JSON 元数据——以后想回溯这个作品的作者、发布时间、点赞数翻开 JSON 就有。场景二宝藏创作者主页整页打包带走假设你发现一个作者想把他主页的作品、点赞过的视频、做的合集、用的原声全部保存。手动翻页能翻到怀疑人生而这个工具只需在配置里列出来link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作者发布的作品 - like # 作者点赞的作品 - mix # 作者创建的合集 - music # 使用该作者原声的作品 number: post: 50 # 发布作品下 50 个 like: 0 # 点赞作品不限数量运行后它会按作者名建好目录四类内容分门别类存放同一个作品即使在不同模式下重复出现也会被自动去重不会占两份硬盘。Downloaded/ └── 作者名/ ├── post/ # 作者发布的作品 ├── like/ # 作者点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品场景三直播结束前自己动手录一份直播和短视频不一样错过就真的错过了。把直播间链接放进配置再给一点录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最多录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30程序会自动解析出直播流地址读取标题、在线人数和清晰度选项然后开始录制。录好的文件存在Downloaded/作者名/live/下还附带一份直播间信息快照*_room.json。一个细节提醒FLV 格式录完直接能播放HLS 源只保存了 playlist 文件需要用 ffmpeg 做一下后处理。另外直播录制属于实验性功能遇到没覆盖的场景不要慌核心的短视频批量下载路径是非常稳定的。三个小开关让批量下载更省心开关一增量下载只补新的批量下载最怕的就是重复劳动。开启数据库去重和增量模式后它就像一个随身的账本上次下到哪、哪些已存过心里全有数database: true # 开启 SQLite 去重和历史记录 increase: post: true # 只下载新发布的 like: true mix: true之后每次运行只补新增内容配合下面的目录组织方式素材库会一直保持清爽。每个作品单独一个文件夹命名带日期和标题哪个文件在哪一眼就能定位。开关二按时间筛选只想保留某个时间段内的内容加两行即可start_time: 2024-01-01 # 只下载这个日期之后发布的 end_time: 2024-12-31留空就表示不限格式统一是YYYY-MM-DD。开关三下载完自动通知批量任务动辄几十分钟没必要一直盯着。配置好通知后完成或失败都会推送到手机notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY除了 Bark还支持 Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人地址多个 provider 会并发推送单个失败不会阻塞下载主流程。进阶玩家的附加工具箱如果你已经用顺手了下面几项属于锦上添花。热搜榜与关键词搜索想做内容选题或追热点不用打开 App 慢慢翻python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果会以 JSONL 文件导出到Downloaded/hot_board/和Downloaded/search/方便后续做数据分析。REST API 服务模式想把下载能力包装成 HTTP 接口集成进自己的系统pip install fastapi uvicorn python run.py --serve --serve-port 8000之后通过POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查询任务状态即可适合有自动化需求的玩家。桌面版 Douzy不喜欢命令行项目基于同一套后端做了桌面客户端目前内测中粘贴链接就能下载、同步关注列表、实时看每个任务的进度。命令行适合脚本化桌面版适合日常点鼠标两条路线共用一套内核。新手最容易遇到的几个坎问为什么只能抓到 20 条作品这是抖音翻页风控的典型现象。解决办法确认配置里browser_fallback.enabled: true且headless: false浏览器窗口弹出后手动过一下验证码不要急着关掉程序会自己继续翻页。问Cookie 失效了怎么办重新跑一次自动获取命令即可几十秒的事python -m tools.cookie_fetcher --config config.yml问下载速度慢怎么优化把配置里的thread从默认的 5 调到 8 试试另外优先在网络状况好的时段跑差异会很明显。如果网络不稳反而建议调低并发避免触发风控。问怎么查看下载历史数据库就在当前目录一条 SQL 就能查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;问想重新下载某个作品怎么办程序靠数据库记录 本地文件双重判断是否已下载所以要删掉对应作品目录再从数据库里删掉记录两个动作缺一不可sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id 作品ID;给你的行动清单到这里工具的全貌你已经清楚了。接下来只需要做四件事克隆项目并安装依赖本文第一节的三条命令跑一次 Cookie 自动获取完成身份认证先下 1 个作品试水确认流程跑通再上批量配置从单个作者的主页开始逐步扩展到多模式。想深入研究的读者可以直接翻项目的源码结构下载主流程在core/目录存储与数据库逻辑在storage/认证相关在auth/配套的自动化测试集中在tests/看代码比看任何教程都更接近真相。最后照例提醒一句工具让下载变得简单但也请把它用在正道上——仅限个人学习研究与数据备份遵守平台规则尊重创作者版权。好的工具配上正确的使用方式才能长久地为你服务。下一次看到那个让你心动的视频或者错过就要再等很久的直播时你已经有办法把它留住了。打开终端敲下第一行命令吧。【免费下载链接】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），仅供参考 抖音下载器 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很多人对抖音下载的刻板印象还停留在那个场景复制链接、打开某个在线去水印网站、等解析、关掉三个弹窗广告、再小心翼翼保存——麻烦不说还经常下到带水印的糊版。而 douyin-downloader 这个开源项目把这件事压缩成了一条命令视频、图文、合集、音乐、直播回放都能存作者主页几百个作品也能一次拉完默认还自带去重、重试和进度展示。下面这份上手指南我会从怎么把程序跑起来讲到批量下载怎么配置再给你几个让工具更好用的小开关全程不写一行代码逻辑复制粘贴就能跟着走。先花一分钟看看它到底能干什么能力一句话说明单个视频/图文/合集/音乐下载把链接扔进配置或命令行参数即可抖音短链也会自动解析作者主页批量下载一次拉完某创作者的作品、点赞、合集、音乐四类可分可合直播录制支持 FLV / HLS 两种流主播下播后已录内容自动保留智能去重SQLite 数据库 本地文件双重检查同一个作品不会下第二遍增量下载上次下到哪了它记得住下次只补新内容细节兜底无水印优先、自动选最高清、失败指数退避重试、时间范围过滤延伸能力评论采集、热搜榜导出、关键词搜索、REST API 服务、下载完成推送通知你可能会想功能这么多是不是配置很复杂其实恰恰相反它的默认配置就能直接跑下面从零开始走一遍。从零到跑通只需要四条命令第一步获取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader/douyin-downloader pip install -r requirements.txt注意克隆下来后主程序在douyin-downloader这个子目录里之后的命令都要在这里执行。环境要求是 Python 3.8 及以上Windows、macOS、Linux 都支持。如果你后面想用浏览器兜底翻页或自动获取 Cookie这两项能力再补装一个 Playwrightpip install playwright python -m playwright install chromium这一步不是必须的可以先跑起来遇到翻页受限时再回来装。第二步让程序认领你的身份Cookie 认证抖音的部分数据需要登录态才能访问douyin-downloader 把获取 Cookie 这件事做成了全自动python -m tools.cookie_fetcher --config config.yml运行后会自动打开一个浏览器窗口你正常扫码登录一次抖音回到终端按一下回车认证信息就被写进配置文件了。整个过程不用碰开发者工具也不用复制粘贴那一长串看不懂的字符。第三步写一份最小配置从项目里复制一份模板改成下面的样子就能用cp config.example.yml config.ymllink: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 换成你自己的链接 path: ./Downloaded/ # 下载文件的保存目录 mode: - post # 下载该作者发布的作品 number: post: 10 # 只下载最新的 10 个0 表示全部下载 thread: 5 # 并发下载数网络好可以调大 retry_times: 3 # 单个文件失败重试次数 database: true # 开启 SQLite 去重和历史记录第四步运行python run.py -c config.yml看到一行行刷新的进度条就是它开始干活了。下面的截图就是批量下载时的真实界面进度百分比、成功/失败计数一目了然你只管盯着看就行。三个高频场景照着抄就能用场景一刷到喜欢的视频一条命令收进硬盘不用建配置文件命令行直接追加链接就行python run.py -c config.yml -u https://www.douyin.com/video/1234567890123456789-u后面是视频链接-c指定配置文件。如果手头只有分享出来的短链比如https://v.douyin.com/xxxxx/也支持自动解析。下载完成后程序会在目录里同时生成视频本体、封面图、背景音乐和一份 JSON 元数据——以后想回溯这个作品的作者、发布时间、点赞数翻开 JSON 就有。场景二宝藏创作者主页整页打包带走假设你发现一个作者想把他主页的作品、点赞过的视频、做的合集、用的原声全部保存。手动翻页能翻到怀疑人生而这个工具只需在配置里列出来link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post # 作者发布的作品 - like # 作者点赞的作品 - mix # 作者创建的合集 - music # 使用该作者原声的作品 number: post: 50 # 发布作品下 50 个 like: 0 # 点赞作品不限数量运行后它会按作者名建好目录四类内容分门别类存放同一个作品即使在不同模式下重复出现也会被自动去重不会占两份硬盘。Downloaded/ └── 作者名/ ├── post/ # 作者发布的作品 ├── like/ # 作者点赞的作品 ├── mix/ # 合集内容 └── music/ # 音乐作品场景三直播结束前自己动手录一份直播和短视频不一样错过就真的错过了。把直播间链接放进配置再给一点录制参数link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 最多录制 1 小时0 表示录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30程序会自动解析出直播流地址读取标题、在线人数和清晰度选项然后开始录制。录好的文件存在Downloaded/作者名/live/下还附带一份直播间信息快照*_room.json。一个细节提醒FLV 格式录完直接能播放HLS 源只保存了 playlist 文件需要用 ffmpeg 做一下后处理。另外直播录制属于实验性功能遇到没覆盖的场景不要慌核心的短视频批量下载路径是非常稳定的。三个小开关让批量下载更省心开关一增量下载只补新的批量下载最怕的就是重复劳动。开启数据库去重和增量模式后它就像一个随身的账本上次下到哪、哪些已存过心里全有数database: true # 开启 SQLite 去重和历史记录 increase: post: true # 只下载新发布的 like: true mix: true之后每次运行只补新增内容配合下面的目录组织方式素材库会一直保持清爽。每个作品单独一个文件夹命名带日期和标题哪个文件在哪一眼就能定位。开关二按时间筛选只想保留某个时间段内的内容加两行即可start_time: 2024-01-01 # 只下载这个日期之后发布的 end_time: 2024-12-31留空就表示不限格式统一是YYYY-MM-DD。开关三下载完自动通知批量任务动辄几十分钟没必要一直盯着。配置好通知后完成或失败都会推送到手机notifications: enabled: true on_success: true on_failure: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY除了 Bark还支持 Telegram以及企业微信、飞书、钉钉这类 Webhook 机器人地址多个 provider 会并发推送单个失败不会阻塞下载主流程。进阶玩家的附加工具箱如果你已经用顺手了下面几项属于锦上添花。热搜榜与关键词搜索想做内容选题或追热点不用打开 App 慢慢翻python run.py --hot-board 30 -p ./Downloaded python run.py --search 猫咪 --search-max 100 -p ./Downloaded结果会以 JSONL 文件导出到Downloaded/hot_board/和Downloaded/search/方便后续做数据分析。REST API 服务模式想把下载能力包装成 HTTP 接口集成进自己的系统pip install fastapi uvicorn python run.py --serve --serve-port 8000之后通过POST /api/v1/download提交链接、GET /api/v1/jobs/{job_id}查询任务状态即可适合有自动化需求的玩家。桌面版 Douzy不喜欢命令行项目基于同一套后端做了桌面客户端目前内测中粘贴链接就能下载、同步关注列表、实时看每个任务的进度。命令行适合脚本化桌面版适合日常点鼠标两条路线共用一套内核。新手最容易遇到的几个坎问为什么只能抓到 20 条作品这是抖音翻页风控的典型现象。解决办法确认配置里browser_fallback.enabled: true且headless: false浏览器窗口弹出后手动过一下验证码不要急着关掉程序会自己继续翻页。问Cookie 失效了怎么办重新跑一次自动获取命令即可几十秒的事python -m tools.cookie_fetcher --config config.yml问下载速度慢怎么优化把配置里的thread从默认的 5 调到 8 试试另外优先在网络状况好的时段跑差异会很明显。如果网络不稳反而建议调低并发避免触发风控。问怎么查看下载历史数据库就在当前目录一条 SQL 就能查sqlite3 dy_downloader.db SELECT aweme_id, title, author_name, datetime(download_time, unixepoch, localtime) FROM aweme ORDER BY download_time DESC LIMIT 20;问想重新下载某个作品怎么办程序靠数据库记录 本地文件双重判断是否已下载所以要删掉对应作品目录再从数据库里删掉记录两个动作缺一不可sqlite3 dy_downloader.db DELETE FROM aweme WHERE aweme_id 作品ID;给你的行动清单到这里工具的全貌你已经清楚了。接下来只需要做四件事克隆项目并安装依赖本文第一节的三条命令跑一次 Cookie 自动获取完成身份认证先下 1 个作品试水确认流程跑通再上批量配置从单个作者的主页开始逐步扩展到多模式。想深入研究的读者可以直接翻项目的源码结构下载主流程在core/目录存储与数据库逻辑在storage/认证相关在auth/配套的自动化测试集中在tests/看代码比看任何教程都更接近真相。最后照例提醒一句工具让下载变得简单但也请把它用在正道上——仅限个人学习研究与数据备份遵守平台规则尊重创作者版权。好的工具配上正确的使用方式才能长久地为你服务。下一次看到那个让你心动的视频或者错过就要再等很久的直播时你已经有办法把它留住了。打开终端敲下第一行命令吧。【免费下载链接】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），仅供参考