3步跑通抖音/TikTok批量下载工具从单链接到服务器部署的完整指南【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloaderDouK-Downloader原 TikTokDownloader是一款基于 HTTPX 的免费抖音/TikTok 批量下载工具支持账号作品、合集、图集、评论数据、直播拉流等 40 余项功能内置 Cookie 鉴权、断点续传与作品下载记录可以按个人终端 → 团队 API → 生产容器三档逐步演进。按需求跳转 只下几个作品看「最短路径上手」4 个命令跑通 给团队提供下载接口看「进阶实战」第 2 档 Web API 模式 7×24 无人值守看「进阶实战」第 3 档 Docker 部署一、为什么你需要一个下载器三个具体痛点抖音/TikTok 的短链并不直接包含文件地址分享链接需要跳转解析才能提取出 19 位数字作品 ID私密账号的发布作品必须携带已登录 Cookie 才能获取数据且登录账号还需关注该私密账号批量请求受平台频控约束连续高频访问会触发限流。这三点恰好是本项目设计对应的三块能力痛点项目对策相关参数短链跳转、ID 提取内置链接提取器自动展开短链src/link/extractor.pyCookie 失效导致数据缺失剪贴板写入 后台周期刷新任务cookie/cookie_tiktok批量下载易漏易重断点续传 作品 ID 记录跳过max_retry: 5、Record 开关二、最短路径上手四步跑通第 1 步获取源码。git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader第 2 步创建虚拟环境并安装依赖建议 Python 3.12 或更高版本。python -m venv venv source venv/bin/activate pip install -r requirements.txt第 3 步启动程序首次运行会展示免责声明输入 YES 确认并自动在项目根目录生成settings.json。python main.py启动后主界面长这样选择「终端交互模式」进入功能菜单第 4 步写入 Cookie 再开始下载。参考 Cookie获取教程 复制 Cookie 到剪贴板回到主菜单选择「从剪贴板读取 Cookie」随后进入「终端交互模式」→「批量下载链接作品」粘贴作品链接即可下载。三、核心机制拆解三个模块看清原理3.1 短链解析从分享链接到 19 位作品 ID一句话概括先用请求器展开短链跳转再用正则表从地址中抠出作品 ID。src/link/extractor.py中的关键代码规则表 分发逻辑一目了然detail_id compile(r\b(\d{19})\b) # 作品 ID detail_link compile( r\S*?https://www\.douyin\.com/(?:video|note|slides)/([0-9]{19})\S*? ) async def run(self, text, type_detail, proxyNone): text await self.requester.run(text, proxy) # 先展开短链 match type_: case detail: return self.detail(text) case user: return self.user(text)3.2 并发与容错信号量限流 Range 续传一句话概括全局信号量把并发钉死在 4 个任务请求头天然携带 Range 支持续传失败按max_retry上限自动重试。src/downloader/download.py的类级信号量是并发的总闸门class Downloader: semaphore Semaphore(MAX_WORKERS) # MAX_WORKERS 4src/custom/internal.py中所有下载请求默认携带续传头配合settings.json里的chunk: 20971522MB 分块与max_retry: 5重试上限 5 次大文件断网后重启即可从中断处继续DOWNLOAD_HEADERS { Accept: */*, Range: bytes0-, Referer: https://www.douyin.com/?recommend1, User-Agent: USERAGENT, }3.3 配置驱动一份 settings.json 管住所有行为一句话概括账号清单、命名规则、存储格式全部落盘在settings.json程序每次启动自动补齐缺失参数。# settings.json 核心字段默认值节选自 src/config/settings.py accounts_urls: [{mark: , url: , tab: post, earliest: , latest: , enable: True}], name_format: create_time type nickname desc, chunk: 2097152, # 每次接收 2MB timeout: 10, # 单请求 10 秒 max_retry: 5, # 单文件最多重试 5 次 storage_format: # 设为 csv/xlsx/sqlite 则持久化元数据启用主菜单里的「作品下载记录」后已下载作品 ID 会写入本地数据库二次运行自动跳过这是增量同步的全部秘密。四、进阶实战三档部署配置要点4.1 个人终端交互 定时增量配置要点把常用账号写进settings.json的accounts_urlstab可选 post 发布 / favorite 喜欢 / collection 收藏mark填自定义标识避免昵称变更导致文件混乱。accounts_urls: [ {mark: tech, url: https://www.douyin.com/user/xxx, tab: post, enable: true} ]python main.py提示主菜单里把「作品下载记录」切到启用状态配合earliest/latest两个日期字段每周重跑一次即可只补新作品。Cookie 只在失效后需要重写并非每次运行都要更新。4.2 小团队Web API 模式做共享服务配置要点主菜单选择「Web API 模式」程序基于 FastAPI 在127.0.0.1:5555起服务所有接口都要带token请求头鉴权接口清单可访问/docs或/redoc查阅。curl -H token: 你的token \ -X POST http://127.0.0.1:5555/douyin/comment \ -d {detail_id: 0123456789, pages: 2}警告服务默认只绑定本机地址。如需开放给局域网同事请确保 token 已正确配置避免无鉴权接口暴露采集页数用pages控制避免单请求翻页过深触发频控。4.3 生产环境Docker 容器 代理配置要点仓库自带 Dockerfile镜像内数据统一落在/app/Volume只需挂载一个卷即可持久化 Cookie、下载记录与已存文件。docker build -t dok-downloader . docker run -p 5555:5555 -v dok_volume:/app/Volume -it dok-downloader在settings.json配置proxyTikTok 平台对应proxy_tiktok做 IP 轮换max_pages限制单次翻页深度。警告容器无法访问宿主机浏览器「从浏览器读取 Cookie」不可用Cookie 必须走剪贴板或配置文件写入max_pages保持 0不限时喜欢/收藏类任务可能耗时很长建议显式设值。五、故障排查决策树下载失败先对号入座90% 的问题落在前三个分支解析失败短链已过期或页面改版提取不到 19 位作品 ID 时只能换有效链接无权限数据私密账号未登录或登录 Cookie 未关注目标账号请求被限流降低批量频率走proxy轮换出口 IP文件不完整网络抖动超过max_retry默认 5 次上限调大后重跑命名乱name_format组合的字段过长调整desc_length默认 64/name_length默认 128六、进阶避坑两个反直觉的正确做法误区一把并发调得越高越好。src/custom/static.py里MAX_WORKERS 4不是保守而是平台频控下的平衡点——单 IP 的请求频率阈值通常比你的出口带宽先被触发并发从 4 拉到 10 时失败重试反而吃掉带宽实际吞吐不升反降。建议先保持 4确认日志无大量重试后再小步上调。误区二断点续传可以替代下载记录。Range 续传只保单文件不保任务级——批量任务中断后重跑跳过已下载作品靠的是 Record 记录的作品 ID。关掉记录功能再重跑等于把整个账号作品从头再下一遍。另外timeout默认 10 秒、max_size为 0 表示不限制大小随意改成极小值会直接截断长视频改参数前先看一眼src/config/settings.py的默认值注释。七、延伸学习路线链接解析src/link/extractor.py、src/link/requester.py接口层账号/评论/直播/搜索各一文件src/interface/下载执行与进度src/downloader/download.py配置与校验逻辑src/config/settings.py、src/config/parameter.py加密参数已停更需自备生成代码src/encrypt/Web API 服务实现src/application/main_server.pyCookie 获取图文教程docs/Cookie获取教程.md容器化Dockerfile掌握顺序建议先读extractor.py搞懂链接怎么变 ID再读download.py搞懂文件怎么落盘最后看settings.py把所有可调参数过一遍——这条线走完你就能独立完成参数调优和二次开发了。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
3步跑通抖音/TikTok批量下载工具：从单链接到服务器部署的完整指南
3步跑通抖音/TikTok批量下载工具从单链接到服务器部署的完整指南【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloaderDouK-Downloader原 TikTokDownloader是一款基于 HTTPX 的免费抖音/TikTok 批量下载工具支持账号作品、合集、图集、评论数据、直播拉流等 40 余项功能内置 Cookie 鉴权、断点续传与作品下载记录可以按个人终端 → 团队 API → 生产容器三档逐步演进。按需求跳转 只下几个作品看「最短路径上手」4 个命令跑通 给团队提供下载接口看「进阶实战」第 2 档 Web API 模式 7×24 无人值守看「进阶实战」第 3 档 Docker 部署一、为什么你需要一个下载器三个具体痛点抖音/TikTok 的短链并不直接包含文件地址分享链接需要跳转解析才能提取出 19 位数字作品 ID私密账号的发布作品必须携带已登录 Cookie 才能获取数据且登录账号还需关注该私密账号批量请求受平台频控约束连续高频访问会触发限流。这三点恰好是本项目设计对应的三块能力痛点项目对策相关参数短链跳转、ID 提取内置链接提取器自动展开短链src/link/extractor.pyCookie 失效导致数据缺失剪贴板写入 后台周期刷新任务cookie/cookie_tiktok批量下载易漏易重断点续传 作品 ID 记录跳过max_retry: 5、Record 开关二、最短路径上手四步跑通第 1 步获取源码。git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader cd TikTokDownloader第 2 步创建虚拟环境并安装依赖建议 Python 3.12 或更高版本。python -m venv venv source venv/bin/activate pip install -r requirements.txt第 3 步启动程序首次运行会展示免责声明输入 YES 确认并自动在项目根目录生成settings.json。python main.py启动后主界面长这样选择「终端交互模式」进入功能菜单第 4 步写入 Cookie 再开始下载。参考 Cookie获取教程 复制 Cookie 到剪贴板回到主菜单选择「从剪贴板读取 Cookie」随后进入「终端交互模式」→「批量下载链接作品」粘贴作品链接即可下载。三、核心机制拆解三个模块看清原理3.1 短链解析从分享链接到 19 位作品 ID一句话概括先用请求器展开短链跳转再用正则表从地址中抠出作品 ID。src/link/extractor.py中的关键代码规则表 分发逻辑一目了然detail_id compile(r\b(\d{19})\b) # 作品 ID detail_link compile( r\S*?https://www\.douyin\.com/(?:video|note|slides)/([0-9]{19})\S*? ) async def run(self, text, type_detail, proxyNone): text await self.requester.run(text, proxy) # 先展开短链 match type_: case detail: return self.detail(text) case user: return self.user(text)3.2 并发与容错信号量限流 Range 续传一句话概括全局信号量把并发钉死在 4 个任务请求头天然携带 Range 支持续传失败按max_retry上限自动重试。src/downloader/download.py的类级信号量是并发的总闸门class Downloader: semaphore Semaphore(MAX_WORKERS) # MAX_WORKERS 4src/custom/internal.py中所有下载请求默认携带续传头配合settings.json里的chunk: 20971522MB 分块与max_retry: 5重试上限 5 次大文件断网后重启即可从中断处继续DOWNLOAD_HEADERS { Accept: */*, Range: bytes0-, Referer: https://www.douyin.com/?recommend1, User-Agent: USERAGENT, }3.3 配置驱动一份 settings.json 管住所有行为一句话概括账号清单、命名规则、存储格式全部落盘在settings.json程序每次启动自动补齐缺失参数。# settings.json 核心字段默认值节选自 src/config/settings.py accounts_urls: [{mark: , url: , tab: post, earliest: , latest: , enable: True}], name_format: create_time type nickname desc, chunk: 2097152, # 每次接收 2MB timeout: 10, # 单请求 10 秒 max_retry: 5, # 单文件最多重试 5 次 storage_format: # 设为 csv/xlsx/sqlite 则持久化元数据启用主菜单里的「作品下载记录」后已下载作品 ID 会写入本地数据库二次运行自动跳过这是增量同步的全部秘密。四、进阶实战三档部署配置要点4.1 个人终端交互 定时增量配置要点把常用账号写进settings.json的accounts_urlstab可选 post 发布 / favorite 喜欢 / collection 收藏mark填自定义标识避免昵称变更导致文件混乱。accounts_urls: [ {mark: tech, url: https://www.douyin.com/user/xxx, tab: post, enable: true} ]python main.py提示主菜单里把「作品下载记录」切到启用状态配合earliest/latest两个日期字段每周重跑一次即可只补新作品。Cookie 只在失效后需要重写并非每次运行都要更新。4.2 小团队Web API 模式做共享服务配置要点主菜单选择「Web API 模式」程序基于 FastAPI 在127.0.0.1:5555起服务所有接口都要带token请求头鉴权接口清单可访问/docs或/redoc查阅。curl -H token: 你的token \ -X POST http://127.0.0.1:5555/douyin/comment \ -d {detail_id: 0123456789, pages: 2}警告服务默认只绑定本机地址。如需开放给局域网同事请确保 token 已正确配置避免无鉴权接口暴露采集页数用pages控制避免单请求翻页过深触发频控。4.3 生产环境Docker 容器 代理配置要点仓库自带 Dockerfile镜像内数据统一落在/app/Volume只需挂载一个卷即可持久化 Cookie、下载记录与已存文件。docker build -t dok-downloader . docker run -p 5555:5555 -v dok_volume:/app/Volume -it dok-downloader在settings.json配置proxyTikTok 平台对应proxy_tiktok做 IP 轮换max_pages限制单次翻页深度。警告容器无法访问宿主机浏览器「从浏览器读取 Cookie」不可用Cookie 必须走剪贴板或配置文件写入max_pages保持 0不限时喜欢/收藏类任务可能耗时很长建议显式设值。五、故障排查决策树下载失败先对号入座90% 的问题落在前三个分支解析失败短链已过期或页面改版提取不到 19 位作品 ID 时只能换有效链接无权限数据私密账号未登录或登录 Cookie 未关注目标账号请求被限流降低批量频率走proxy轮换出口 IP文件不完整网络抖动超过max_retry默认 5 次上限调大后重跑命名乱name_format组合的字段过长调整desc_length默认 64/name_length默认 128六、进阶避坑两个反直觉的正确做法误区一把并发调得越高越好。src/custom/static.py里MAX_WORKERS 4不是保守而是平台频控下的平衡点——单 IP 的请求频率阈值通常比你的出口带宽先被触发并发从 4 拉到 10 时失败重试反而吃掉带宽实际吞吐不升反降。建议先保持 4确认日志无大量重试后再小步上调。误区二断点续传可以替代下载记录。Range 续传只保单文件不保任务级——批量任务中断后重跑跳过已下载作品靠的是 Record 记录的作品 ID。关掉记录功能再重跑等于把整个账号作品从头再下一遍。另外timeout默认 10 秒、max_size为 0 表示不限制大小随意改成极小值会直接截断长视频改参数前先看一眼src/config/settings.py的默认值注释。七、延伸学习路线链接解析src/link/extractor.py、src/link/requester.py接口层账号/评论/直播/搜索各一文件src/interface/下载执行与进度src/downloader/download.py配置与校验逻辑src/config/settings.py、src/config/parameter.py加密参数已停更需自备生成代码src/encrypt/Web API 服务实现src/application/main_server.pyCookie 获取图文教程docs/Cookie获取教程.md容器化Dockerfile掌握顺序建议先读extractor.py搞懂链接怎么变 ID再读download.py搞懂文件怎么落盘最后看settings.py把所有可调参数过一遍——这条线走完你就能独立完成参数调优和二次开发了。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
)
