social-auto-upload 实战教程：一条视频如何一键发布到 6 个平台

social-auto-upload 实战教程：一条视频如何一键发布到 6 个平台

【免费下载链接】social-auto-upload自动化上传视频到社交媒体：抖音、小红书、视频号、tiktok、youtube、bilibili项目地址: https://gitcode.com/GitHub_Trending/so/social-auto-upload

晚上十一点，你终于把视频剪完了。接下来是熟悉的流程：打开抖音传一次，切到 B 站再传一次，小红书得重新配九张图，快手、视频号、TikTok 挨个登录、填标题、等上传。全套忙完，一个小时没了，而且明天还要再来一遍。这种高频又无聊的重复劳动，正是 social-auto-upload 想帮你省掉的——它是一款开源工具，通过浏览器自动化，把视频和图文一键发布到抖音、B 站、小红书、快手、视频号、TikTok 六大平台。

这篇教程会带你从零跑通全流程：先看懂它是怎么"替你把鼠标点了"的，再一步步完成安装、配置、登录，发出第一条视频，最后聊聊多账号、定时发布和工作流接入。全程不用写代码，跟着命令敲就行。

一张表看懂它能做什么

可以看到，视频是六个平台全覆盖；图文目前支持抖音、小红书、快手，B 站、视频号、TikTok 走的是纯视频路线。其中前四个平台还支持命令行一键操作，方便接脚本和定时任务。

上面这张动图是 TikTok 上传流程的真实演示：标题、封面、观看权限、是否排期，脚本都能自动帮你填好，你只需要看着它跑完。

先弄清楚原理：浏览器自动化是怎么回事

social-auto-upload 的核心思路很简单：用 patchright 驱动一个真实的浏览器内核，模拟真人去操作网页——定位元素、输入文字、点击按钮、等待页面跳转。它不是"抓数据"，而是完整地替你完成一次用户操作。

三个关键机制值得提前知道：

• 登录一次，长期复用。第一次登录时，脚本会把 Cookie 存到本地，之后直接带着身份信息打开网页，不用反复扫码。
• 无头模式。在配置里打开后，浏览器会在后台静默运行，很适合挂在服务器上跑。
• 出错可重试。固定的流程脚本比"临场发挥"稳定得多，失败还能自动重来。

有人会问：为什么不直接让 AI 现场看着网页操作？答案是成本。每次让 AI 重新理解页面结构、截图判断、临场决策，既慢又不可控；而这种高频、重复的上传动作，写成固定脚本一次搞定，又快又稳。这正是这个项目存在的意义：把确定的工作交给确定的代码。

分步实战：从安装到发出第一条视频

整个上手过程大概十五分钟，一步一步来。

第一步：克隆项目，创建 Python 虚拟环境

先把项目拉下来，然后新建一个干净的 Python 环境，避免污染系统环境：

git clone https://gitcode.com/GitHub_Trending/so/social-auto-upload cd social-auto-upload uv venv source .venv/bin/activate

Windows 用户把最后一行换成.venv\Scripts\activate。这里用的uv是新一代 Python 包管理工具，比 pip 快不少；如果机器上还没装，先装一下 uv。

第二步：安装依赖

uv pip install -e .

这一步会把项目装成可用的命令行工具，装完后系统里就多了一个sau命令，后面所有操作都靠它。

第三步：安装浏览器驱动

项目靠浏览器自动化干活，需要下载配套的浏览器内核：

PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright" patchright install chromium

这里直接用了国内镜像，下载速度会快很多。如果你本身就在海外网络环境，去掉前面的镜像变量直接执行也可以。

第四步：准备配置文件

cp conf.example.py conf.py

打开conf.py简单看一眼，里面主要是浏览器路径、调试模式、无头模式开关（比如LOCAL_CHROME_HEADLESS）这些基础项。默认配置一般就能直接跑，先不用大改。

第五步：登录你的第一个账号

sau douyin login --account my_account

命令会弹出一个浏览器窗口，你扫码或输入账号完成登录。成功后身份信息会保存下来，下次上传不用再登录。B 站是类似的：

sau bilibili login --account bili_user

这里有个小提示：如果终端里的二维码显示不全，直接打开当前目录下的qrcode.png扫码就行，效果一样。

第六步：发布第一条视频

登录完成后，上传就只剩一条命令了。以抖音为例：

sau douyin upload-video --account my_account --file videos/demo.mp4 --title "我的第一条自动化视频" --desc "这是用 social-auto-upload 自动发布的"

项目目录里正好有videos/demo.mp4可以拿来试手。小红书发图文是这个姿势：

sau xiaohongshu upload-note --account xhs_account --images photos/1.png photos/2.png --title "图文标题" --note "正文内容"

B 站上传时记得带上分区 ID：

sau bilibili upload-video --account bili_user --file videos/tutorial.mp4 --title "教程视频" --desc "详细说明" --tid 249

上面这张动图就是抖音发布的过程：作品描述、话题、封面设置，脚本都替你完成了。你会发现，从这一刻起，"发视频"这件事真的变成了敲一条命令。

进阶玩法：多账号、定时发布一起上

跑通单个账号只是开始，这个项目真正的价值在组合使用：

• 多账号并行。每个--account对应一套独立配置，你可以给不同平台、不同用途分别建账号。开了无头模式后，多个任务可以同时挂机跑，实现真正的批量分发。
• 定时发布。不想半夜爬起来发文？平台支持排期的，脚本可以直接设置发布时间；不支持排期的，可以配合系统定时任务到点再触发上传。
• 同视频多标题。一条素材，在抖音用热点标题，在 B 站用技术向标题，在快手动感一点，脚本允许你给每个平台单独指定文案。

踩坑手册：高频问题速查

把常见问题整理成了问答，遇到直接对号入座：

问：B 站登录时终端二维码显示不全怎么办？答：二维码其实已经生成好了，打开当前目录下的qrcode.png用手机扫即可，不用管终端显示。

问：浏览器驱动下载特别慢，或者直接失败？答：八成是网络问题。用PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"这个镜像再装一次，多试几次一般就成功了。

问：用了一段时间突然提示 Cookie 失效，上传失败？答：平台的 Cookie 有有效期，属于正常现象。重新执行一次对应的login命令刷新即可，建议养成"每周刷新一次登录"的习惯。

问：想换一台服务器继续用？答：账号数据存在本地的 cookies 目录，把它一起备份迁移过去就行。

把发布接进你的工作流

命令行工具最大的好处就是可以被调度。比如在 Linux 服务器上用 cron 实现每天定时分发：

0 9 * * * cd /path/to/social-auto-upload && sau douyin upload-video --account my_account --file /data/new.mp4 --title "$(date +%F) 日更"

思路是一样的：上传变成了一条可编程的命令，剩下的交给调度器。团队场景下，也可以把发布步骤写进 CI 流水线，内容构建完成后自动触发分发，全程无人值守。

什么人适合用它

• 自媒体矩阵运营者：一个人管四五个平台，最怕的就是重复劳动。用上它之后，复制粘贴填表单的时间全省下来了，精力可以留给选题和剪辑。
• 企业或团队：需要多平台同步更新、统一发布口径的，可以用它规范流程，发布记录也更可控。
• 个人创作者：不想在半夜守着零点发文的人，配合定时发布，完全可以做到"白天剪视频，凌晨自动发"。

发布只是第一步，分发之后的数据（播放、完播、搜索量）都留在各平台自己的后台里，工具负责把内容送过去，分析还是看官方数据最准。

下一步：先跑通一个平台

别贪多，先从一个平台开始：装好环境 → 登录账号 → 上传一条测试视频，确认整条链路通了，再复制到其他平台。推荐顺序是抖音 → B 站 → 小红书，前两个最简单，小红书可以顺便体验图文能力。

过程中想了解更多细节，项目自带的 docs/install.md（安装）和 docs/CLI.md（命令大全）是很好的参考，skills/目录里还有各平台的分工说明，examples/里则是现成的示例脚本。

今晚就试试？把第一条命令敲下去，你的多平台一键发布，就从明天开始了。

【免费下载链接】social-auto-upload自动化上传视频到社交媒体：抖音、小红书、视频号、tiktok、youtube、bilibili项目地址: https://gitcode.com/GitHub_Trending/so/social-auto-upload