企业官网建设流程全解析

告别反复扫码：social-auto-upload 的 Cookie 持久化机制新手指南

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

每次用 social-auto-upload 往抖音、小红书、视频号、B站、TikTok 上发视频前，都要重新扫一遍码，是不是特别磨人？这款能一键把视频自动分发到各大社交平台的开源工具，靠的正是Cookie 持久化机制：你第一次登录时，平台发给浏览器的"通行证"会被完整存成一份本地 JSON 文件，之后每次上传都悄悄"刷一下通行证"就能进去，免重复登录就是这么实现的。这篇指南用大白话把"存了什么、存在哪、怎么验、失效了怎么办"一次讲清楚。

Cookie 持久化机制速览：存了什么、存在哪、怎么验

先别急着看细节，我们用一张表把整套机制"拍扁"：

这里有个小类比帮助理解：Cookie 就像平台发给你的"门禁卡"，登录成功的那一刻，门禁卡已经办好了；而 social-auto-upload 做的事情，是把这张卡复印一份存进档案柜，下次进门直接刷卡，不用再跑去前台办手续。

验证的具体逻辑在 myUtils/auth.py 里，它对抖音、小红书、视频号、快手等平台分别写了"试卡"方法——核心思路都一样：打开对应创作者后台，盯着登录入口看几秒，出现了登录框就是卡废了，没出现就是卡还灵。

首次登录全流程：从扫码到通行证自动存档

实际用起来你会发现，整个"办卡 + 存档"过程你只需要做两件事，剩下的都是工具自动完成。以抖音为例：

第 1 步：装好工具。把仓库克隆到本地，按 docs/install.md 装依赖，再用uv pip install -e .安装出统一的sau命令。

第 2 步：执行登录命令。在终端里输入下面这条命令（账号名随你起，后面会反复用到）：

sau douyin login --account myaccount1 sau douyin check --account myaccount1

第 3 步：扫码。工具会弹出浏览器（或在终端里画出二维码），你用抖音 App 扫一下就行。这一步你只需要等页面自动跳进创作者后台，别急着关窗口。

第 4 步：状态自动落盘。页面一跳进后台，工具就会立刻把当前浏览器的登录状态写入cookies/douyin_myaccount1.json这类文件。这一步由 myUtils/login.py 中的登录流程驱动，底层调的是 Playwright 的storage_state方法——你可以把它理解成"把浏览器此刻的记忆整个打包存档"。

第 5 步：先验再入库。存完文件不会直接收工，工具会马上拿这份新状态跑一遍第 2 步提到的验证。验过了，才会把"账号 → 文件"的对应关系记进本地数据库（db/database.db）；验不过，就会丢弃文件并提示你重新扫。

第 6 步：从此免登录。后面上传视频、发图文，直接指定同一个--account就行，工具会自己找到对应的 JSON 文件、先验卡、再干活。

顺带一提：命令行版本按平台_账号名.json的规则命名文件；而仓库里的 Web 后端（sau_backend.py 那套）则把文件存在cookiesFile/目录下、用 UUID 命名，并在数据库里记录归属。入口不同，思路一致，都是"一账号一文件"。

常见问题答疑：过期、多账号、安全一次说清

Q：Cookie 过期了怎么办？怎么知道它过没过期？

A：不用肉眼猜，工具自带体检命令，比如sau douyin check --account myaccount1，跑完会直接告诉你好还是坏。如果上传时被动发现过期，命令会明确提示"cookie is missing or expired"并让你先跑登录命令——遇到这种情况别慌，照着提示重新登录一次，新的 JSON 文件会原地覆盖旧的，其他东西都不受影响。

Q：我有好几个账号，怎么设置才不乱？

A：靠--account参数区分就行：myaccount1、myaccount2各对应一个独立的 JSON 文件，登录态、发布记录互不串号。想给哪个账号发内容，命令里带哪个名字即可，这是 social-auto-upload 支持多账号隔离的基本玩法。

Q：通行证存在磁盘上，安全吗？

A：要认清一个事实：这份 JSON 文件等于你的账号钥匙，拿到它的人可以以你的身份操作。所以三条底线——别把它拷给别人、别上传到公共网盘或代码仓库、定期用 check 命令确认状态，过期就重新登录让旧文件失效。

Q：为什么有时候登录时工具会重新弹一个浏览器让我扫？

A：这通常是旧 Cookie 已过期、或者首次使用还没有存档，工具在主动帮你"补办门禁卡"。按提示扫完码、等它提示成功就好，之后这个平台就安静了。

上手前记得这 5 件事

1. 账号名一旦选定就别乱改，命令里写错名字等于指向一份不存在的文件，工具只会提醒你重新登录。
2. 重要账号定期备份对应 JSON 文件到私人位置，万一误删还得重新扫码。
3. 别把 Cookie 文件分享出去，也不要把cookies/目录提交进任何代码仓库。
4. 过期不丢人，平台都会给 Cookie 设有效期，按提示重新登录就是标准动作。
5. 想看机制细节就去这三个文件：验证逻辑在 myUtils/auth.py，登录与状态保存流程在 myUtils/login.py，命令行入口和账号文件路径规则在 sau_cli.py，配合 docs/CLI.md 阅读体验最佳。

搞懂这套"办卡—存档—刷卡—补办"的循环，你就已经掌握了 social-auto-upload 免重复登录的全部核心，剩下就是把视频丢给它的份内事了。🍪

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