tiktok-uploader 保姆级安装教程：从 pip 安装到 Playwright 浏览器配置避坑指南

tiktok-uploader 保姆级安装教程从 pip 安装到 Playwright 浏览器配置避坑指南【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader想给 TikTok 批量发布视频却不想一个个手动操作tiktok-uploader就是一个基于 Playwright 自动化浏览器的免费开源视频上传工具它通过复用你浏览器里的登录 Cookie让 TikTok 以为真人在后台帮你发视频。本教程将从零开始手把手带你完成 tiktok-uploader 安装、Playwright 浏览器配置并总结新手最容易踩的 5 大坑让你 10 分钟就能跑通第一次自动上传。一、安装前需要准备什么在开始 tiktok-uploader 安装之前请先确认你的电脑满足以下 3 个条件Python 3.10 或更高版本项目在 pyproject.toml 中明确要求requires-python 3.10一个可用的 TikTok 账号用于导出登录 Cookie网络能正常访问 TikTok支持 Windows、macOS、Linux 三大系统无需区分环境下文命令通用。二、最快安装方法pip 一键安装官方推荐使用 pip 直接安装这是最快、最省事的 tiktok-uploader 安装方式。打开终端Windows 用 CMD 或 PowerShell依次执行pip install tiktok-uploader安装完成后立即执行 Playwright 浏览器安装命令这是整个安装流程中最关键的一步playwright installplaywright install会下载自动化所需的浏览器内核Chromium 等如果跳过这一步运行工具时一定会报错这是新手踩坑率最高的地方。验证安装是否成功在终端输入tiktok-uploader -h如果能看到参数帮助信息说明 tiktok-uploader 安装成功。命令行入口定义在 cli.py 中核心参数包括-v视频路径、-d描述、-cCookie 文件等。三、从源码安装的备选方案如果你想修改源码来扩展功能也可以从源码安装。需要先安装极速包管理器uv然后克隆仓库git clone https://gitcode.com/gh_mirrors/ti/tiktok-uploader cd tiktok-uploader uv sync uv run playwright install uv run tiktok-uploader这种方式的灵活性更高适合想深入研究 upload.py 上传逻辑的开发者。四、Playwright 浏览器配置避坑指南重点很多用户卡在装完库却跑不起来问题几乎都出在 Playwright 浏览器配置上。下面按优先级列出最常见的坑和解决方法坑 1忘记安装 Playwright 浏览器现象报错Executable doesnt exist或找不到 Chromium解决执行playwright install等待下载完成后再运行坑 2浏览器选择错误导致无法启动tiktok-uploader 默认使用Chrome反检测策略也针对它做了优化。如果你没有安装 Chrome默认模式会启动失败。此时有两种选择安装 Google Chrome然后保持默认配置指定其他浏览器工具支持chrome、chromium、edge、firefox、safari五种见 browsers.py 的浏览器映射逻辑坑 3Chrome 与 Edge 需要指定 channel在 Playwright 中Chrome 和 Edge 属于系统浏览器必须通过 channel 参数指定否则会被当作普通 Chromium 处理。这一点在 browsers.py 中已自动处理但如果你手动改过源码千万别删除channel相关代码。坑 4headless 模式无头浏览器被 TikTok 拦截现象上传页面打不开或一直停留在登录页解决先用有头模式调试。CLI 加--attach参数或 Python 中设置headlessFalse能看到浏览器窗口时排查问题更方便。确认稳定后再切回 headless 批量跑坑 5自动上传被限制频控项目作者明确提示这个工具不是刷量神器连续大量上传会导致上传失败通常等待数小时即可恢复。建议把它当作定时发布器使用而不是刷视频工具。五、登录认证配置获取 Cookie 是成功的关键tiktok-uploader 不保存你的账号密码而是靠Cookie 认证其中最重要的字段是sessionid。获取方式有三种方式一推荐浏览器扩展导出安装 Get cookies.txt 类扩展在 TikTok 页面点击导出保存为cookies.txt文件NetScape 格式。方式二浏览器控制台导出在 TikTok 页面按 F12 打开开发者工具在 Console 粘贴一段导出脚本点击弹出的Download cookies.txt按钮即可。方式三直接传 sessionid如果嫌麻烦只要拿到sessionid一个 Cookie 就能认证配合 CLI 的-s参数使用。⚠️重要提示TikTok 的sessionid是 HttpOnly 的JS 脚本可能拿不到。如果导出后提示缺少sessionid需要到 DevTools 的 Application → Cookies 里手动复制并补进cookies.txt。认证解析逻辑见 auth.py 的get_cookies方法。六、开始你的第一次自动上传命令行方式最简单tiktok-uploader -v video.mp4 -d 我的第一个自动上传视频 #fyp -c cookies.txt-v视频文件路径-d视频描述支持 #话题-cCookie 文件路径Python 方式更灵活参考官方示例 basic_upload.pyfrom tiktok_uploader.upload import TikTokUploader uploader TikTokUploader(cookiescookies.txt) uploader.upload_video(video.mp4, description我的第一个自动上传视频 #fyp)七、进阶玩法批量上传与定时发布上手之后你还可以解锁这些实用功能批量上传一次性提交多个视频参考 multiple_videos_at_once.py定时发布设置 UTC 时间自动发布需提前 20 分钟以上且不超过 10 天隐私设置支持everyone公开、friends好友可见、only_you私密参考 private_upload.py自定义封面支持 png、jpg、jpeg 格式封面图代理配置支持带账号密码的代理适合多账号场景视频格式方面项目支持 mp4、mov、avi、webm、mkv 等常见格式完整的类型列表定义在 config.toml 中。八、常见问题速查表问题快速解决方案找不到浏览器可执行文件重新执行playwright install登录页反复跳转检查 cookies.txt 是否包含有效的 sessionid上传后提示失败检查视频格式是否为支持的 10 种格式之一上传过多被限制停止操作等待数小时后再试描述中的话题没生效确认话题后面跟了空格如#fyp结语到这里你已经完成了 tiktok-uploader 安装、Playwright 浏览器配置和 Cookie 认证的全流程。记住三个核心要点装完库必须跑playwright install、默认用 Chrome 最稳、先有头调试再无头批量。照着本教程操作你就能把重复的 TikTok 发布工作完全自动化把时间留给内容创作本身。【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考