企业官网建设流程全解析

douyin-downloader 实战指南：3 条命令跑通抖音无水印批量下载

【免费下载链接】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 批量下载就是解决这件事的：直连抖音接口拿无水印源，单条、主页、合集、音乐一次搞定，还自带去重和重试。

定位：它和解析站的差别在哪

在线解析站靠网页抓取，域名三天两头换，Cookie 还可能被拿去二次利用。这个项目走的是另一条路：用你登录后的 Cookie 直接请求官方接口（core/api_client.py），解析、下载、去重、重试全在本地闭环完成，默认还带浏览器兜底——API 翻页被风控时自动开浏览器继续滚动。

适合谁：想把某博主作品备份到本地的追更党、运营调研要评论数据的人、以及任何"下过一次就别再下一次"的强迫症。

安装依赖与获取 Cookie：唯一的硬门槛

准备 Python 3.9+，然后克隆并安装：

git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt

这条命令把源码拉到本地并装好全部依赖，一两分钟完成。

Cookie 是门槛：没有登录态，接口只能看到部分内容。项目自带一个自动获取脚本，比手抄浏览器 Cookie 省事得多：

cp config.example.yml config.yml python -m tools.cookie_fetcher --config config.yml

第一条把配置模板复制成你自己的文件；第二条会弹出一个浏览器，你扫码登录抖音后回终端按回车，Cookie 自动写回config.yml（tools/cookie_fetcher.py）。

可选：想启用"浏览器兜底"或自动获取 Cookie 的完整能力，补装 Playwright：

pip install playwright python -m playwright install chromium

填链接跑首次下载：3 条命令的主线

编辑config.yml，只填三处就能跑：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ mode: - post

link是下载目标，短链v.douyin.com/...也能自动解析。然后启动：

python run.py -c config.yml

终端会滚动显示解析链接、创建下载器、进度条，完成品落在Downloaded/作者名/post/日期_标题_aweme_id/三层目录里，好找。不想改配置的话，也可以命令行直传：

python run.py -u "https://www.douyin.com/video/7604129988555574538" -p ./Downloaded

-u追加链接、-p指定输出目录、-t 8调并发，免改文件。

能力地图：改一行 link 就能换玩法

单条与整包下载。视频、图文（/note/）、合集（/collection/）、音乐（/music/）都走同一个link字段，工具按 URL 自动路由到对应下载器（core/downloader_factory.py）。音乐优先下载原声文件，取不到时回退到该音乐下的首条作品，你不会拿到空文件。

主页批量与增量追更。把link换成博主主页地址，number.post: 0表示不限数量全量拉取：

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 0 increase: post: true

increase打开后，工具靠 SQLite 数据库（默认dy_downloader.db）比对历史记录，第二次运行只下新作品，追更成本趋近于零。like下载博主点赞过、mix下合集、music下其音乐，同一作者可一次声明多个模式，跨模式自动去重。

收藏夹本地化。只支持当前登录账号，且必须单独运行：

link: - https://www.douyin.com/user/self?showTab=favorite_collection mode: - collect number: collect: 0

collect下收藏作品、collectmix下收藏合集，别和post混在同一次运行里。

直播录制。填入直播间地址即可开录，FLV 文件存在Downloaded/{作者}/live/下：

link: - https://live.douyin.com/123456789 live: max_duration_seconds: 0

0表示录到主播下播为止；断流或 Ctrl+C 中断时，已录字节会保留为正式文件，不会白跑。

评论采集与数据导出。调研场景加一段配置，每个作品旁会多出一个_comments.json：

comments: enabled: true include_replies: false max_comments: 500

不想下载媒体的话，两条独立命令直接拿数据：python run.py --hot-board 30 -p ./Downloaded抓热搜前 30 名导出 JSONL，python run.py --search "关键词" --search-max 100 -p ./Downloaded按词搜作品落盘，都能直接进分析流程。

出问题时查这三处

现象：只抓到 20 条就停。原因：主页翻页触发了风控。解决：确认browser_fallback.enabled: true且headless: false，弹出验证码时手动过一下，别急着关窗口。这是默认配置里就开着的保险丝，没生效多半是 Playwright 没装全。

现象：跑着跑着提示登录态失效。原因：Cookie 有有效期。解决：重跑python -m tools.cookie_fetcher --config config.yml，交互式环境下程序检测到失效还会自动开浏览器重登一次再重试。

现象：想重下某条视频却被跳过。原因：去重是"数据库记录 + 本地文件"双保险。解决：两边都清，数据库那条删掉后工具才会重新下载：

sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<aweme_id>';"

再删掉对应的本地文件夹即可。只删文件不删库会重下，只删库不删文件不会。

现象：下载慢或大文件反复失败。原因：并发过高被限流，或网络需要代理。解决：把thread降到 3，有本地代理就填proxy: "http://127.0.0.1:7890"，它对 API 请求和媒体下载同时生效。

服务化与通知：给自动化留的接口

想把工具接进自己的脚本？pip install fastapi uvicorn后运行python run.py --serve --serve-port 8000，提交POST /api/v1/download带{"url": "..."}即异步排队，GET /api/v1/jobs/{job_id}查进度。批量任务跑完不想守终端，就配通知推送：

notifications: enabled: true providers: - type: bark url: https://api.day.app/YOUR_DEVICE_KEY

Bark、Telegram、Webhook 三选一或并行，单个渠道失败不阻塞下载。完全不想碰命令行的用户，项目还有基于同一后端的桌面客户端 Douzy，链接粘贴、任务跟踪全可视化：

收尾

主线其实就三件事：装依赖、跑 Cookie 脚本、填链接执行。剩下的都是在这个骨架上加开关——增量、直播、评论、服务化。最后提醒一句：本项目定位为个人数据备份与技术研究用途，下载的内容请勿二次传播，尊重创作者版权，合规使用。

核心关键词：douyin-downloader 批量下载；长尾关键词：抖音无水印视频下载、抖音主页批量备份、抖音直播录制 FLV

【免费下载链接】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