企业官网建设流程全解析

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 个条件：

1. Python 3.10 或更高版本（项目在 pyproject.toml 中明确要求requires-python = ">=3.10"）
2. 一个可用的 TikTok 账号（用于导出登录 Cookie）
3. 网络能正常访问 TikTok

支持 Windows、macOS、Linux 三大系统，无需区分环境，下文命令通用。

二、最快安装方法：pip 一键安装

官方推荐使用 pip 直接安装，这是最快、最省事的 tiktok-uploader 安装方式。打开终端（Windows 用 CMD 或 PowerShell），依次执行：

pip install tiktok-uploader

安装完成后，立即执行 Playwright 浏览器安装命令，这是整个安装流程中最关键的一步：

playwright install

playwright install会下载自动化所需的浏览器内核（Chromium 等），如果跳过这一步，运行工具时一定会报错，这是新手踩坑率最高的地方。

验证安装是否成功

在终端输入：

tiktok-uploader -h

如果能看到参数帮助信息，说明 tiktok-uploader 安装成功。命令行入口定义在 cli.py 中，核心参数包括-v（视频路径）、-d（描述）、-c（Cookie 文件）等。

三、从源码安装的备选方案

如果你想修改源码来扩展功能，也可以从源码安装。需要先安装极速包管理器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 doesn't exist或找不到 Chromium
• 解决：执行playwright install，等待下载完成后再运行

坑 2：浏览器选择错误导致无法启动

tiktok-uploader 默认使用Chrome，反检测策略也针对它做了优化。如果你没有安装 Chrome，默认模式会启动失败。此时有两种选择：

• 安装 Google Chrome，然后保持默认配置
• 指定其他浏览器，工具支持chrome、chromium、edge、firefox、safari五种（见 browsers.py 的浏览器映射逻辑）

坑 3：Chrome 与 Edge 需要指定 channel

在 Playwright 中，Chrome 和 Edge 属于"系统浏览器"，必须通过 channel 参数指定，否则会被当作普通 Chromium 处理。这一点在 browsers.py 中已自动处理，但如果你手动改过源码，千万别删除channel相关代码。

坑 4：headless 模式（无头浏览器）被 TikTok 拦截

• 现象：上传页面打不开，或一直停留在登录页
• 解决：先用"有头"模式调试。CLI 加--attach参数，或 Python 中设置headless=False，能看到浏览器窗口时排查问题更方便。确认稳定后再切回 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：视频描述（支持 #话题）
• -c：Cookie 文件路径

Python 方式（更灵活）

参考官方示例 basic_upload.py：

from tiktok_uploader.upload import TikTokUploader uploader = TikTokUploader(cookies="cookies.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 中。

八、常见问题速查表

结语

到这里，你已经完成了 tiktok-uploader 安装、Playwright 浏览器配置和 Cookie 认证的全流程。记住三个核心要点：装完库必须跑playwright install、默认用 Chrome 最稳、先有头调试再无头批量。照着本教程操作，你就能把重复的 TikTok 发布工作完全自动化，把时间留给内容创作本身。🎬

【免费下载链接】tiktok-uploaderAutomatically ⬆️ upload TikTok videos项目地址: https://gitcode.com/gh_mirrors/ti/tiktok-uploader