matrix短视频矩阵分发系统全流程上手教程一台电脑批量管理抖音快手视频号小红书【免费下载链接】matrixmatrix是抖音快手视频号小红书等短视频矩阵内容分发系统的脚本代码基于python3旨在借助playwright实现自动化发布视频到各个社交媒体平台项目地址: https://gitcode.com/gh_mirrors/matrix5/matrix如果你手上同时运营着抖音、快手、视频号、小红书好几个账号每天都要手动登录、手动传视频、手动填标题话题那么你多半会想过有没有办法把这些重复劳动交给脚本 matrix 就是为此而生的——它是一个基于 Python 和 Playwright 的短视频矩阵内容分发系统用一个登录队列加一个发布队列就能让多平台、多账号的视频自动上传跑起来。这篇教程我会带着你从零开始把环境搭好、把第一个账号登进去、再把第一个视频发出去全程走一遍你会发现它并没有想象中复杂。它到底解决了什么问题先看整体盘子。matrix 的目录结构非常直观每个平台一个独立的包matrix/ ├── douyin_uploader/ # 抖音登录、Cookie生成、视频上传 ├── tencent_uploader/ # 视频号 ├── xhs_uploader/ # 小红书 ├── ks_uploader/ # 快手 ├── xhs-api/ # 小红书 X-S 签名服务 ├── utils/ # 排期、话题解析等工具 ├── database/matrix.sql # 数据库表结构 ├── conf.py # 全局配置 ├── user_queue_login.py # 登录脚本 └── publish_video_queue.py # 发布脚本整个系统的核心思路可以概括成三条流水线登录队列mx_account_login_queue把要登录哪个平台的哪个账号当作一条条任务脚本按顺序执行账号库mx_account_info登录成功后账号 ID、昵称、头像、Cookie 文件路径都会落到这里发布队列mx_publish_task_video_queue把给哪个账号发哪条视频写成任务发布脚本按序执行。想明白这三张表后面所有操作你都能对号入座。先摸清系统里的状态机四张表之间靠status字段协作理解它你才能看懂日志输出表status 含义mx_account_login_queue0未执行、1执行中、2成功、3失败mx_publish_task_video_queue0未开始、1发布中、2成功、3失败、4未登录被跳过mx_account_info1已登录、0未登录、2已过期发布脚本每 5 秒轮询一次数据库发现有status0的任务就立刻领走执行执行完再写回状态。这种数据库当消息队列的写法让前端后台可以随时往表里塞任务脚本这边完全不用停。搭建运行环境大约十分钟在动手前先解释一下为什么需要这些东西Playwright 负责驱动 Chromium 模拟真实浏览器操作Redis 负责缓存登录二维码和登录状态MySQL 负责存账号与任务队列。三者缺一不可。git clone https://gitcode.com/gh_mirrors/matrix5/matrix cd matrix pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple playwright install chromium接着准备数据库。先用 MySQL 建一个matrix库然后导入项目自带的表结构mysql -uroot -p matrix database/matrix.sql表结构不算复杂每张表的注释都写得很清楚导入后可以直接看database/matrix.sql里的示例数据。最后修改全局配置 conf.py这是整个项目最关键的一步BASE_PATH D:\wwwroot\matrix\matrix\\ # 视频文件的绝对路径前缀Linux 请把 \ 换成 / XHS_SERVER http://127.0.0.1:5005 # 小红书签名服务地址 REDIS_CONF { host:127.0.0.1, port:6379, select_db:0, password: } MYSQL_CONF { host:localhost, port:3306, database:matrix, username:root, password:你的密码, auto_commit:True }BASE_PATH之所以要单独配置是因为发布队列里存的是相对路径比如video/1.mp4脚本拿到后会拼上这个前缀才能找到文件一定要填成绝对路径。改完配置记得确认 Redis 和 MySQL 都已启动不然脚本会在连接阶段直接报错。到这里环境就绪下一步我们跑第一次登录。跑通第一次登录以抖音为例登录采用的是队列驱动模式。首先向登录队列插入一条任务注意type字段1抖音、2视频号、3小红书、4快手uid是你们业务系统里的用户 IDINSERT INTO mx_account_login_queue (uid, type, status, created_at, updated_at) VALUES (1, 1, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());然后启动登录脚本python3 user_queue_login.py 1脚本会开启一个 Chromium 窗口自动打开抖音创作者平台并生成登录二维码。二维码的 base64 数据会写入 Redis键名类似douyin_login_ewm_{queue_id}前端可以直接读取展示给用户扫码。整个等待逻辑在 douyin_uploader/main.py 里核心就是循环检测页面 URL 是否跳转到创作者后台首页if creator.douyin.com/creator-micro/home in page.url: break扫码登录成功后脚本会把 Cookie 保存为douyin_uploader/account/{uid}_{抖音号}_account.json并把用户信息写入mx_account_info表。注意account目录如果不存在需要手动创建并保证有写入权限。如果你在 Linux 服务器上跑看到无法显示浏览器界面别慌——登录脚本默认是非 headless 模式要展示二维码Linux 需要借助虚拟屏幕来运行xvfb-run python3 user_queue_login.py 1遇到抖音要求短信验证的情况也不用紧张脚本检测到身份验证弹窗后会先在 Redis 写入douyin_login_need_auth_{queue_id}标记前端拿到标记后把用户填好的验证码写入douyin_login_authcode_{queue_id}脚本读取后自动完成验证无缝衔接。小红书特殊环节先启动 X-S 签名服务抖音、快手、视频号走的是纯 Playwright 页面操作而小红书走的是一条特殊通道它调用xhs库直接发 HTTP 请求每次请求都需要计算X-S 签名。这个签名是 JS 加密函数算出来的所以项目专门内置了一个 Flask 服务来帮忙。在登录小红书python3 user_queue_login.py 3之前必须先把这个服务拉起来python3 xhs-api/app2024.py服务默认监听0.0.0.0:5005也就是 conf.py 里XHS_SERVER指向的地址。它的工作方式很巧妙每次收到/sign请求就用无头浏览器打开小红书首页获取a1Cookie再在页面里执行加密函数取回签名encrypt_params await context_page.evaluate( ([url, data]) window._webmsxyw(url, data), [uri, data] ) result {x-s: encrypt_params[X-s], x-t: str(encrypt_params[X-t])}这段代码在 xhs-api/app2024.py 里。如果你签名经常失败可以检查一下启动这个服务后 5005 端口是否被占用以及XHS_SERVER是否配置正确——这两点是小红书环节最常见的翻车原因。发布视频把第一个视频真正发出去账号登录好后发布就变得非常无脑。先往发布队列插入一条任务我直接沿用项目自带示例数据的写法INSERT INTO mx_publish_task_video_queue (uid, type, account_info_id, title, tags, preview, path, url, location, publish_date, status, created_at) VALUES (1, 1, 2, 扑克牌上的Q代表什么, 知识科普 冷知识, image/1.png, video/1.mp4, video/1.mp4, 重庆市, 2026-08-14 20:00:00, 0, UNIX_TIMESTAMP());字段逐个说明一下type1抖音、2视频号、3小红书、4快手跟登录一致account_info_id指向mx_account_info表里对应账号记录的主键 idpath/preview视频文件和封面图的相对路径最终会拼上BASE_PATHpublish_date留空代表立即发布填了则走定时发布status0 表示让脚本来领。插入后直接跑发布脚本无需任何参数它不区分平台按任务的插入顺序逐一执行python3 publish_video_queue.py脚本每次取到任务后会先做一件很重要的事——Cookie 自检。比如抖音任务它会用storage_state加载 Cookie 打开创作者后台若 5 秒内没出现登录失效特征就判定有效否则直接删掉 Cookie 文件并把任务状态改成 4未登录发布失败提醒你重新登录。这个逻辑在 publish_video_queue.py 的douyin_cookie_auth等函数里四个平台各有对应的校验函数。校验通过后脚本自动完成选文件上传、填标题、加话题、定位、定时、点发布的全流程发布成功还会回写 Cookie 并更新任务状态为 2。你只需要盯一下终端输出就行。进阶玩法定时排期与多账号调度跑通了基础流程有几个能明显提升效率的进阶点值得你用起来定时发布publish_date按%Y-%m-%d %H:%M:%S格式填写脚本会自动帮你在发布页勾选定时发布并填入时间适合提前囤一批内容排期生成器工具函数generate_schedule_time_next_day在 utils/files_times.py 里你只需传入视频总数、每天发布数量和时间点就能批量生成未来 N 天的发布时刻表一次性导入队列实现躺平式运营话题解析tags字段用空格分隔即可如知识科普 冷知识脚本会自动转成各平台的话题格式账号隔离每个平台账号的 Cookie 独立存放互不干扰多账号轮换发视频时天然自带人设隔离。新手最容易踩的坑自检清单把这些高频问题整理成一张清单遇到麻烦逐条对照多数问题 5 分钟内能定位✅Redis/MySQL 没启动先redis-cli ping和mysql -u root -p确认连通再跑脚本✅BASE_PATH不是绝对路径脚本找不到视频文件会直接报文件不存在✅account目录缺失或没权限登录成功但 Cookie 写不进去表现为登录状态一直不更新✅小红书没启动签名服务XHS_SERVER的 5005 端口不通所有小红书操作都会失败✅Linux 下登录脚本无界面记得用xvfb-run包裹命令✅队列状态卡在发布中大概率是上次执行中断把状态手动改回 0 即可重新排队。另外提醒一句headless参数可以在各平台 上传器主程序 里改成True/False调试时开窗口看过程稳定运行后关掉节省资源。核心要点回顾matrix 用登录队列 账号库 发布队列三张表驱动全流程理解状态机就理解了整个系统环境搭建的关键是三件事导入 database/matrix.sql、改对 conf.py 的路径和连接参数、确认 Redis 与 MySQL 存活抖音登录走二维码 Redis 缓存短信验证码也已内置处理Linux 服务器记得用xvfb-run小红书是唯一走 HTTP 签名通道的平台务必先启动 xhs-api/app2024.py 签名服务发布任务支持立即发布和定时发布配合排期生成器可以提前囤好一周的内容实现自动化运营。如果你在部署中遇到其他问题仓库里附带了一个交流群二维码可以在群里和其他使用者交流经验。⚠️ 温馨提示本项目仅供个人学习与研究使用请遵守各平台的服务条款与内容规范合理控制发布频率不要用于刷量、违规营销等行为。使用前请自行评估风险因使用本工具产生的一切后果由使用者自行承担。【免费下载链接】matrixmatrix是抖音快手视频号小红书等短视频矩阵内容分发系统的脚本代码基于python3旨在借助playwright实现自动化发布视频到各个社交媒体平台项目地址: https://gitcode.com/gh_mirrors/matrix5/matrix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 matrix短视频矩阵分发系统全流程上手教程：一台电脑批量管理抖音快手视频号小红书
matrix短视频矩阵分发系统全流程上手教程一台电脑批量管理抖音快手视频号小红书【免费下载链接】matrixmatrix是抖音快手视频号小红书等短视频矩阵内容分发系统的脚本代码基于python3旨在借助playwright实现自动化发布视频到各个社交媒体平台项目地址: https://gitcode.com/gh_mirrors/matrix5/matrix如果你手上同时运营着抖音、快手、视频号、小红书好几个账号每天都要手动登录、手动传视频、手动填标题话题那么你多半会想过有没有办法把这些重复劳动交给脚本 matrix 就是为此而生的——它是一个基于 Python 和 Playwright 的短视频矩阵内容分发系统用一个登录队列加一个发布队列就能让多平台、多账号的视频自动上传跑起来。这篇教程我会带着你从零开始把环境搭好、把第一个账号登进去、再把第一个视频发出去全程走一遍你会发现它并没有想象中复杂。它到底解决了什么问题先看整体盘子。matrix 的目录结构非常直观每个平台一个独立的包matrix/ ├── douyin_uploader/ # 抖音登录、Cookie生成、视频上传 ├── tencent_uploader/ # 视频号 ├── xhs_uploader/ # 小红书 ├── ks_uploader/ # 快手 ├── xhs-api/ # 小红书 X-S 签名服务 ├── utils/ # 排期、话题解析等工具 ├── database/matrix.sql # 数据库表结构 ├── conf.py # 全局配置 ├── user_queue_login.py # 登录脚本 └── publish_video_queue.py # 发布脚本整个系统的核心思路可以概括成三条流水线登录队列mx_account_login_queue把要登录哪个平台的哪个账号当作一条条任务脚本按顺序执行账号库mx_account_info登录成功后账号 ID、昵称、头像、Cookie 文件路径都会落到这里发布队列mx_publish_task_video_queue把给哪个账号发哪条视频写成任务发布脚本按序执行。想明白这三张表后面所有操作你都能对号入座。先摸清系统里的状态机四张表之间靠status字段协作理解它你才能看懂日志输出表status 含义mx_account_login_queue0未执行、1执行中、2成功、3失败mx_publish_task_video_queue0未开始、1发布中、2成功、3失败、4未登录被跳过mx_account_info1已登录、0未登录、2已过期发布脚本每 5 秒轮询一次数据库发现有status0的任务就立刻领走执行执行完再写回状态。这种数据库当消息队列的写法让前端后台可以随时往表里塞任务脚本这边完全不用停。搭建运行环境大约十分钟在动手前先解释一下为什么需要这些东西Playwright 负责驱动 Chromium 模拟真实浏览器操作Redis 负责缓存登录二维码和登录状态MySQL 负责存账号与任务队列。三者缺一不可。git clone https://gitcode.com/gh_mirrors/matrix5/matrix cd matrix pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple playwright install chromium接着准备数据库。先用 MySQL 建一个matrix库然后导入项目自带的表结构mysql -uroot -p matrix database/matrix.sql表结构不算复杂每张表的注释都写得很清楚导入后可以直接看database/matrix.sql里的示例数据。最后修改全局配置 conf.py这是整个项目最关键的一步BASE_PATH D:\wwwroot\matrix\matrix\\ # 视频文件的绝对路径前缀Linux 请把 \ 换成 / XHS_SERVER http://127.0.0.1:5005 # 小红书签名服务地址 REDIS_CONF { host:127.0.0.1, port:6379, select_db:0, password: } MYSQL_CONF { host:localhost, port:3306, database:matrix, username:root, password:你的密码, auto_commit:True }BASE_PATH之所以要单独配置是因为发布队列里存的是相对路径比如video/1.mp4脚本拿到后会拼上这个前缀才能找到文件一定要填成绝对路径。改完配置记得确认 Redis 和 MySQL 都已启动不然脚本会在连接阶段直接报错。到这里环境就绪下一步我们跑第一次登录。跑通第一次登录以抖音为例登录采用的是队列驱动模式。首先向登录队列插入一条任务注意type字段1抖音、2视频号、3小红书、4快手uid是你们业务系统里的用户 IDINSERT INTO mx_account_login_queue (uid, type, status, created_at, updated_at) VALUES (1, 1, 0, UNIX_TIMESTAMP(), UNIX_TIMESTAMP());然后启动登录脚本python3 user_queue_login.py 1脚本会开启一个 Chromium 窗口自动打开抖音创作者平台并生成登录二维码。二维码的 base64 数据会写入 Redis键名类似douyin_login_ewm_{queue_id}前端可以直接读取展示给用户扫码。整个等待逻辑在 douyin_uploader/main.py 里核心就是循环检测页面 URL 是否跳转到创作者后台首页if creator.douyin.com/creator-micro/home in page.url: break扫码登录成功后脚本会把 Cookie 保存为douyin_uploader/account/{uid}_{抖音号}_account.json并把用户信息写入mx_account_info表。注意account目录如果不存在需要手动创建并保证有写入权限。如果你在 Linux 服务器上跑看到无法显示浏览器界面别慌——登录脚本默认是非 headless 模式要展示二维码Linux 需要借助虚拟屏幕来运行xvfb-run python3 user_queue_login.py 1遇到抖音要求短信验证的情况也不用紧张脚本检测到身份验证弹窗后会先在 Redis 写入douyin_login_need_auth_{queue_id}标记前端拿到标记后把用户填好的验证码写入douyin_login_authcode_{queue_id}脚本读取后自动完成验证无缝衔接。小红书特殊环节先启动 X-S 签名服务抖音、快手、视频号走的是纯 Playwright 页面操作而小红书走的是一条特殊通道它调用xhs库直接发 HTTP 请求每次请求都需要计算X-S 签名。这个签名是 JS 加密函数算出来的所以项目专门内置了一个 Flask 服务来帮忙。在登录小红书python3 user_queue_login.py 3之前必须先把这个服务拉起来python3 xhs-api/app2024.py服务默认监听0.0.0.0:5005也就是 conf.py 里XHS_SERVER指向的地址。它的工作方式很巧妙每次收到/sign请求就用无头浏览器打开小红书首页获取a1Cookie再在页面里执行加密函数取回签名encrypt_params await context_page.evaluate( ([url, data]) window._webmsxyw(url, data), [uri, data] ) result {x-s: encrypt_params[X-s], x-t: str(encrypt_params[X-t])}这段代码在 xhs-api/app2024.py 里。如果你签名经常失败可以检查一下启动这个服务后 5005 端口是否被占用以及XHS_SERVER是否配置正确——这两点是小红书环节最常见的翻车原因。发布视频把第一个视频真正发出去账号登录好后发布就变得非常无脑。先往发布队列插入一条任务我直接沿用项目自带示例数据的写法INSERT INTO mx_publish_task_video_queue (uid, type, account_info_id, title, tags, preview, path, url, location, publish_date, status, created_at) VALUES (1, 1, 2, 扑克牌上的Q代表什么, 知识科普 冷知识, image/1.png, video/1.mp4, video/1.mp4, 重庆市, 2026-08-14 20:00:00, 0, UNIX_TIMESTAMP());字段逐个说明一下type1抖音、2视频号、3小红书、4快手跟登录一致account_info_id指向mx_account_info表里对应账号记录的主键 idpath/preview视频文件和封面图的相对路径最终会拼上BASE_PATHpublish_date留空代表立即发布填了则走定时发布status0 表示让脚本来领。插入后直接跑发布脚本无需任何参数它不区分平台按任务的插入顺序逐一执行python3 publish_video_queue.py脚本每次取到任务后会先做一件很重要的事——Cookie 自检。比如抖音任务它会用storage_state加载 Cookie 打开创作者后台若 5 秒内没出现登录失效特征就判定有效否则直接删掉 Cookie 文件并把任务状态改成 4未登录发布失败提醒你重新登录。这个逻辑在 publish_video_queue.py 的douyin_cookie_auth等函数里四个平台各有对应的校验函数。校验通过后脚本自动完成选文件上传、填标题、加话题、定位、定时、点发布的全流程发布成功还会回写 Cookie 并更新任务状态为 2。你只需要盯一下终端输出就行。进阶玩法定时排期与多账号调度跑通了基础流程有几个能明显提升效率的进阶点值得你用起来定时发布publish_date按%Y-%m-%d %H:%M:%S格式填写脚本会自动帮你在发布页勾选定时发布并填入时间适合提前囤一批内容排期生成器工具函数generate_schedule_time_next_day在 utils/files_times.py 里你只需传入视频总数、每天发布数量和时间点就能批量生成未来 N 天的发布时刻表一次性导入队列实现躺平式运营话题解析tags字段用空格分隔即可如知识科普 冷知识脚本会自动转成各平台的话题格式账号隔离每个平台账号的 Cookie 独立存放互不干扰多账号轮换发视频时天然自带人设隔离。新手最容易踩的坑自检清单把这些高频问题整理成一张清单遇到麻烦逐条对照多数问题 5 分钟内能定位✅Redis/MySQL 没启动先redis-cli ping和mysql -u root -p确认连通再跑脚本✅BASE_PATH不是绝对路径脚本找不到视频文件会直接报文件不存在✅account目录缺失或没权限登录成功但 Cookie 写不进去表现为登录状态一直不更新✅小红书没启动签名服务XHS_SERVER的 5005 端口不通所有小红书操作都会失败✅Linux 下登录脚本无界面记得用xvfb-run包裹命令✅队列状态卡在发布中大概率是上次执行中断把状态手动改回 0 即可重新排队。另外提醒一句headless参数可以在各平台 上传器主程序 里改成True/False调试时开窗口看过程稳定运行后关掉节省资源。核心要点回顾matrix 用登录队列 账号库 发布队列三张表驱动全流程理解状态机就理解了整个系统环境搭建的关键是三件事导入 database/matrix.sql、改对 conf.py 的路径和连接参数、确认 Redis 与 MySQL 存活抖音登录走二维码 Redis 缓存短信验证码也已内置处理Linux 服务器记得用xvfb-run小红书是唯一走 HTTP 签名通道的平台务必先启动 xhs-api/app2024.py 签名服务发布任务支持立即发布和定时发布配合排期生成器可以提前囤好一周的内容实现自动化运营。如果你在部署中遇到其他问题仓库里附带了一个交流群二维码可以在群里和其他使用者交流经验。⚠️ 温馨提示本项目仅供个人学习与研究使用请遵守各平台的服务条款与内容规范合理控制发布频率不要用于刷量、违规营销等行为。使用前请自行评估风险因使用本工具产生的一切后果由使用者自行承担。【免费下载链接】matrixmatrix是抖音快手视频号小红书等短视频矩阵内容分发系统的脚本代码基于python3旨在借助playwright实现自动化发布视频到各个社交媒体平台项目地址: https://gitcode.com/gh_mirrors/matrix5/matrix创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考