企业官网建设流程全解析

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 是一个命令行抖音下载工具，无水印批量下载视频、图文、合集和音乐，按作者和日期自动归档。它带进度展示、失败重试和浏览器兜底，从克隆仓库到第一次成功下载，只需要三步。

🎯 核心能力速览

• 无水印源自动选择，最高码率优先
• 单条、合集、音乐、图文链接均可下载
• 创作者主页批量下载，四种模式可选
• 按发布时间过滤，支持增量跳过
• 并发重试、去重、完整性校验内置

⚡ 三步跑通第一次下载

第一步：获取项目并安装依赖

# 克隆项目 git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader # 安装运行时依赖 pip install -r requirements.txt

预期看到：pip 正常安装完毕，无报错。

第二步：准备配置并获取 Cookie

# 以示例配置为模板创建自己的配置 cp config.example.yml config.yml # 自动获取 Cookie：会打开浏览器，登录抖音后回终端按 Enter python -m tools.cookie_fetcher --config config.yml

预期看到：弹出浏览器完成扫码登录后，Cookie 自动写回config.yml，无需手动复制。若希望保留浏览器兜底能力，建议顺手装上 Playwright：

# 可选：安装浏览器兜底所需的 chromium pip install playwright python -m playwright install chromium

第三步：执行下载

# 用命令行参数追加一个视频链接直接下载 python run.py -c config.yml -u "https://www.douyin.com/video/7604129988555574538"

预期看到：终端出现 Rich 进度条，跑完后Downloaded/作者名/post/下生成带作品 ID 的 mp4 及配套文件。

命令行参数只覆盖配置文件中的对应项，两者可以混用。常用参数见 config.example.yml 与 README.zh-CN.md。

📂 进阶：批量下载、时间筛选与增量更新

单条链接只是起点。把链接换成创作者主页，就能一次拉下整个人的内容。

主页批量下载与模式选择

# 下载某创作者最近 50 条作品 link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx mode: - post number: post: 50 # 0 表示不限数量

主页链接配合mode决定拉取范围：

多个模式可写进同一份配置，跨模式会自动去重，同一条作品不会下载两次。

按时间筛选与增量更新

# 只下载指定时间段内发布的内容 start_time: "2025-01-01" end_time: "2025-12-31" # 增量模式：本地已有文件则跳过 increase: post: true

增量判断看的是磁盘上的主媒体文件：文件存在就跳过，删掉文件下次就会重新下载。这样长期跟踪某个创作者时，每次运行只补新内容，不重复占流量。

桌面版 Douzy（内测中）

同一套后端还提供了一个桌面客户端 Douzy：粘贴链接即可开始，任务中心里能看到每个任务的状态与结果，失败可一键重试。

任务中心汇总所有下载记录，成功和失败的条目一目了然。

💻 典型使用场景

如果你要完整存档某位创作者，那么用主页链接配mode: [post]、number.post: 0全量拉取，folderstyle: true会让每个作品单独建目录，视频、封面、音乐、JSON 元数据各就各位，后续找素材不用翻文件。

如果你只关心某个时间段的内容，比如复盘 2025 年的爆款素材，那么加上start_time/end_time两个字段即可，下载清单download_manifest.jsonl里还记录了发布日期和标签，方便后续检索。

如果你持续跟踪关注的博主，那么把increase.post设为true后定期运行同一份配置，新增作品会自动补进本地库，已有内容原样跳过。桌面版的关注同步列表也适合这类需求。

🩺 避坑与排查

现象：只下载了约 20 条就停了。原因：触发了分页风控，接口不再继续翻页。解决：确认browser_fallback.enabled: true且headless: false，翻页受阻时会自动弹出浏览器，手动完成验证后不要提前关闭窗口。

现象：报登录失效、拿不到数据。原因：Cookie 过期是常态。解决：重跑python -m tools.cookie_fetcher --config config.yml重新登录即可，无需手改配置。

现象：删了数据库记录，同一作品却不再重下。原因：程序用"数据库记录 + 本地文件"双重判断去重，本地文件还在时仍会跳过。解决：文件与数据库记录要么都删、要么按目标保留，想强制重下就把两者一起清掉。

另外两条调优建议：下载慢时把thread从 5 调到 3 试试，网络波动大的环境配合retry_times重试即可；日志刷屏可开启progress.quiet_logs: true，需要排错时再用-v临时打开详细日志。

📝 写在最后

douyin-downloader 把无水印下载、批量抓取、归档管理压进了一份 YAML 配置和一条run.py命令里，是个人素材存档和内容跟踪的实用工具。使用前请确认遵守抖音平台规则，下载内容仅用于个人学习、研究或合理使用范围，不要侵犯创作者的版权与隐私。

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