企业官网建设流程全解析

免费抖音批量下载工具：5分钟搞定无水印视频、图集与音乐原声

【免费下载链接】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，它会无水印批量下载视频、图集与音乐原声，并按「作者 / 模式 / 日期_标题」自动归档。这篇教程带你从零跑通第一次下载：5 个步骤装好环境，3 份照抄即用的配方，外加常见坑的处理方法，所有命令复制即用。

它替你干掉的重复活

douyin-downloader 是一个免费的、配置驱动的命令行下载工具，适合需要批量留存抖音素材的人：自媒体运营、内容整理者、音乐创作者。你只负责写一份配置文件，它负责挑无水印源、按规则归档、用 SQLite 记录历史、失败自动重试。被它替代的手工动作如下：

一句话：它把「手工保存 N 次」压缩成「配置一次、运行一次」。

5步上手：从克隆代码到看到下载产物

环境要求只有 Python 3.8+，Windows / macOS / Linux 都能跑。

1. 获取代码并安装依赖

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

依赖很轻，requirements.txt 里核心是 aiohttp、rich、pyyaml 等几个库。如果你还想用浏览器兜底或自动获取 Cookie，再装一下：

pip install playwright python -m playwright install chromium

2. 写最小配置

cp config.example.yml config.yml

打开 config.yml，把link换成你手边的第一条视频，其余保留必要字段即可：

link: - https://www.douyin.com/video/7604129988555574538 path: ./Downloaded/ # 保存目录 mode: - post number: post: 0 # 0 表示不限制数量 thread: 5 # 并发数 retry_times: 3 # 失败重试次数 database: true # SQLite 历史与去重

3. 获取登录凭证（唯一需要手工的步骤）

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

浏览器会自动打开抖音登录页，登录一次后回到终端按 Enter，Cookie 就自动写进配置，长期可用。这个脚本就是 tools/cookie_fetcher.py，只负责开浏览器和回写。

4. 运行第一次下载

python run.py -c config.yml

屏幕上 Rich 进度条实时刷新，完成后输出成功数统计。不想改配置也能临时追加链接：python run.py -c config.yml -u "https://www.douyin.com/video/..." -t 8 -p ./Downloaded。

5. 查看产物

Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_作品标题_aweme_id/ ├── 2024-02-07_作品标题_aweme_id.mp4 ├── ..._cover.jpg ├── ..._music.mp3 └── ..._data.json

download_manifest.jsonl是下载清单，每行一条作品记录，含 ID、标题、标签和文件路径，方便程序化检索。文件名的日期是作品发布时间而非下载时间，按时间归档很省事。📦

它能做什么：能力清单与当前边界

有两条边界要先知道：浏览器兜底目前只针对post模式完整验证，like/mix/music主要依赖 API 正常分页；collect/collectmix收藏夹模式只支持当前登录账号且必须单独使用，直播的 HLS 源只保存 playlist、需要 ffmpeg 后处理。

同一套后端还孵化了桌面版 Douzy（内测中），提供多链接队列、任务中心这类可视化管理界面：

3个照抄即用的配置：素材库、原声、直播存档

配方一：自媒体素材库（主页批量 + 增量更新）

适用人群：需要持续跟踪某个作者新作品的运营者。

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 替换为作者主页 sec_uid mode: - post # 发布作品 - like # 顺手备份点赞 number: post: 0 # 0 = 不限数量 like: 0 increase: post: true # 增量：只下载新发布的 like: true database: true thread: 5

注意点：第一次跑全量，之后每次只补新增，配合文末的 crontab 就能让素材库自动维护。

配方二：音乐原声收集

适用人群：需要采样、remix 素材的音乐制作人。

link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx # 音乐账号主页 mode: - music # 该账号的原声 music: true # 保存音频文件 cover: false json: true number: music: 0 path: ./音乐素材/

注意点：原声文件优先保存，缺失时自动回退到该音乐下的首条作品，做采样足够用。

配方三：直播回放存档

适用人群：想完整留存某场直播的人。

link: - https://live.douyin.com/房间号 live: max_duration_seconds: 0 # 0 = 录到主播下播 chunk_size: 65536 idle_timeout_seconds: 30

注意点：FLV 保存在Downloaded/{作者}/live/下，附带直播间元数据快照；主播下播或断网时已录制的字节会保留。

参数调优、排错与下一步

只抓到 20 条左右作品就停了？典型的翻页风控。确认browser_fallback.enabled: true且headless: false，浏览器弹窗出现后手动完成验证，别急着关窗口。

提示登录失效？重跑一次python -m tools.cookie_fetcher --config config.yml，重新登录按回车即可，几十秒的事。

想重新下载某个作品？去重是「数据库记录 + 本地文件」双重检查。先删掉对应作品目录，再删数据库记录：sqlite3 dy_downloader.db "DELETE FROM aweme WHERE aweme_id = '<作品ID>';"。注意只删库不删文件不会触发重新下载。

没生成转写文件？按顺序检查：transcript.enabled是否为 true、下载的是否为视频（图文不转写）、OPENAI_API_KEY是否有效、response_formats是否包含 txt 或 json。

跑通第一条下载后，建议按这个顺序继续：

1. 保留一条单视频：最小配置 +python run.py -c config.yml，约 5 分钟完成全部设置
2. 换成主页批量：link改为主页地址并加mode，确认第一次全量跑通
3. 打开增量与通知：increase.*: true+notifications，之后不用盯着终端
4. 加定时任务：Linux 写一条 crontab，0 2 * * * cd /path/to/douyin-downloader && python run.py -c config.yml >> download.log 2>&1；Windows 用任务计划程序执行同样命令
5. 更多字段查 config.example.yml 的完整注释，完整用法见 README.zh-CN.md

下载他人作品请遵守平台规则与版权约定，本工具仅适用于个人数据管理与学习研究。

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