服务器上也能自动发视频tiktok-uploader 无头模式部署终极指南【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader很多做 TikTok 运营的朋友都遇到过这样的痛点视频剪辑好了却因为时差、作息或人手不够错过了最佳发布时机。今天要介绍的tiktok-uploader是一个基于 Playwright 的TikTok 自动上传工具它支持无头模式headless部署到服务器让你不用打开浏览器也能定时、批量地自动发视频真正实现 7×24 小时无人值守运营。这篇终极指南将带你从零开始完成服务器部署。一、tiktok-uploader 是什么能帮你做什么简单来说tiktok-uploader 是一个用 Python 编写的自动化上传器它通过Playwright 驱动浏览器模拟真实用户在 TikTok 网页端完成从填写文案到点击发布的全流程。它的核心亮点包括功能说明 自动上传支持 mp4、mov、avi、webm 等常见视频格式 定时发布指定 UTC 时间自动发布无需守着电脑 批量上传一次上传多个视频支持列表批量处理️ 自定义封面可为视频指定 png / jpg 封面图 代理支持可配置代理 IP适合多账号场景 Cookies 认证复用浏览器登录态无需每次手动登录整个上传逻辑集中在 src/tiktok_uploader/upload.py核心类是TikTokUploader它支持懒加载浏览器、自动注入 cookies并在上传完成后优雅关闭浏览器。二、部署前的准备工作清单在服务器上部署之前建议先准备好以下三样东西一台 Linux 服务器本文以 Ubuntu/Debian 为例Windows 服务器同理一个 TikTok 账号建议使用小号或运营账号避免影响主号cookies.txt 文件关键无头模式登录依赖它⚠️ 官方在 README 中明确提示这不是一个刷量工具频繁上传可能导致视频发布失败建议当作定时发布器使用而不是群发轰炸机。如何快速拿到 cookies.txt最简单的方式是在浏览器中访问 TikTok 网站登录后通过浏览器开发者工具F12导出 cookies保存为 NetScape 格式的cookies.txt。认证逻辑可以参考 src/tiktok_uploader/auth.py 中的AuthBackend类——它会解析 cookies 文件并注入浏览器上下文其中sessionid是唯一必需的 cookie。三、一键安装步骤服务器环境搭建第一步安装 Python 与 Playwrighttiktok-uploader 要求 Python 3.10 及以上版本。安装依赖只需两条命令pip install tiktok-uploader playwright installplaywright install会下载浏览器内核这一步在服务器上可能需要几分钟请耐心等待。项目依赖声明在 pyproject.toml核心依赖包括playwright、pydantic、pytz和toml。第二步克隆项目源码可选如果你希望修改源码、定制上传行为也可以通过以下命令获取源码git clone https://gitcode.com/gh_mirrors/ti/tiktok-uploader cd tiktok-uploader uv sync uv run playwright install项目使用uv作为包管理器安装速度非常快。配置文件位于 src/tiktok_uploader/config.toml你可以按需调整超时时间、支持的文件类型等参数。四、最快配置方法三步启动自动上传方式一命令行CLI直接发布把视频和 cookies 文件放到服务器上然后执行tiktok-uploader -v video.mp4 -d 我的第一条自动发布视频 #fyp -c cookies.txt --headlessCLI 的入口在 src/tiktok_uploader/cli.py支持以下常用参数参数作用-v视频文件路径必填-d视频描述文案-ccookies 文件路径-t定时发布时间UTC--headless无头模式运行--proxy代理配置--visibility可见范围everyone / friends / only_you--cover自定义封面图方式二Python API 灵活集成如果你要接入自己的运营系统推荐使用 Python API。参考 examples/basic_upload.pyfrom tiktok_uploader.upload import TikTokUploader uploader TikTokUploader(cookiescookies.txt, headlessTrue) uploader.upload_video( video.mp4, description服务器自动发布的视频 #fyp, )只需要在初始化时传入headlessTrue浏览器就会在后台静默运行不弹出任何窗口这正是服务器无头部署的核心。无头模式的浏览器创建逻辑位于 src/tiktok_uploader/browsers.py。方式三批量上传多个视频运营多个账号或需要一次发布多条内容参考 examples/multiple_videos_at_once.pyfrom tiktok_uploader.upload import TikTokUploader videos [ {path: video1.mp4, description: 第一条视频}, {path: video2.mp4, description: 第二条视频}, ] uploader TikTokUploader(cookiescookies.txt, headlessTrue) failed uploader.upload_videos(videosvideos) print(上传失败:, failed)upload_videos会返回上传失败的视频列表方便你重试或排查问题。五、进阶技巧定时发布与无人值守设置定时发布 定时发布是运营的刚需。通过-t参数或 Python 的schedule参数你可以指定发布时间import datetime from tiktok_uploader.upload import TikTokUploader schedule datetime.datetime(2026, 8, 25, 10, 0) # UTC 时间 uploader TikTokUploader(cookiescookies.txt, headlessTrue) uploader.upload_video(video.mp4, description定时发布测试, scheduleschedule)几点注意事项发布时间使用UTC 时区发布前记得换算定时时间必须至少在未来 20 分钟最远不超过10 天分钟数会被自动修正为 5 的倍数如 13:07 会被调整为 13:10用 Cron 实现真正的无人值守定时发布 Cron 定时任务就可以实现到点自动发视频。例如每天上午 9 点UTC 1 点自动发布0 1 * * * cd /opt/tiktok-uploader tiktok-uploader -v video.mp4 -d 每日更新 -c cookies.txt --headless从 Excel 批量管理视频对于内容量大的团队可以参考 examples/series_upload.py用 pandas 读取 Excel 表格逐行读取file_path和description上传成功后才把状态标记为已上传实现可断点续传的批量发布流程。六、常见问题排查与避坑指南1. 上传失败怎么办上传流程在 src/tiktok_uploader/upload.py 的complete_upload_form函数中依次完成进入上传页 → 上传文件 → 填写描述 → 设置互动选项 → 点击发布。如果失败优先检查cookies 是否过期重新导出即可视频格式是否在支持列表内mp4/mov/avi/wmv/flv/webm/mkv 等描述文案是否超过 150 字符限制2. 无头模式下浏览器被识别怎么办项目内置了反检测机制在 src/tiktok_uploader/browsers.py 中浏览器启动时会自动添加--disable-blink-featuresAutomationControlled参数并通过注入脚本隐藏webdriver特征同时伪装 User-Agent。绝大多数场景下无需额外配置。3. 需要多账号同时运营推荐为每个账号准备独立的cookies.txt配合代理使用tiktok-uploader -v video.mp4 -c account1.txt --proxy user:passhost:port --headless代理目前仅支持 Chrome 浏览器内核需要注意。七、总结借助tiktok-uploader 无头模式你可以轻松实现 TikTok 视频的服务器自动上传、定时发布和批量管理把人力从重复劳动中解放出来。无论你是个人创作者还是内容团队这套方案都能帮你稳定地维持发布节奏不错过任何一个流量高峰。最后提醒一句任何自动化工具都应该合规使用控制发布频率、使用真实账号内容才能让账号长期健康运营。祝你的 TikTok 账号早日起飞【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考