postiz-app
gitroomhq/postiz-app加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
做内容运营的人大概都熟悉这种节奏:周一写好公众号和 X 的长文,周二剪一版短视频,周三想做一张配图,周四发现小红书和 LinkedIn 的调性完全不同要重写一遍。到周五,还要把这一周的发布情况导出成表格给老板看。
Postiz 想解决的正是这条流水线上的重复劳动。它是一个 AGPL-3.0 协议下的自托管社交媒体调度平台,截至 2026 年 10 月在 GitHub 上拿到约 38.8K Star、7.4K Fork,仓库创建于 2023 年 7 月,最后一次代码推送在 2026 年 10 月 24 日,当前版本 v2.25.3。它的自我定位很直接:"The ultimate agentic social media scheduling tool"——注意那个 agentic。

Postiz 的作者来自 Gitroom(一家做 Git 托管服务的公司),Postiz 最早是他们的商业 SaaS 产品,后来把完整后端开源出来。对比 README 里的两张对照表就很清楚:Postiz Cloud(托管版)和 Postiz Open-source(自托管版)功能基本一致,差别在于基础设施归谁、社交平台的应用审核由谁去跑。
这个"开源即产品"的模式带来一个实际好处:AGPL-3.0 协议没有阉割功能,没有阉割渠道数量,没有阉割每月发布量,README 里明确写着 "We do not 'gate' features or limit the license"。而作为代价,自托管用户需要自己为 Meta、YouTube、TikTok 去申请开发者应用并走审核流程——"can take weeks" 是官方自己的措辞。
传统做法像是手工排版工:每个平台一个工具,五个平台五套登录,发布一次点五次鼠标,改个时间要改五遍。而 Postiz 更像车间调度员——你把内容投进统一入口,它负责决定"什么时候、投到哪个渠道、用哪套账号凭据、失败了要不要重试"。
支撑这个车间的是一套相当扎实的工程架构:Temporal 负责工作流编排(发帖、评论、延迟发送这类任务天然需要状态机和重试语义),Redis 做缓存和限流,PostgreSQL 是主数据源,Next.js + React 做前端,NestJS 做后端,Prisma 管理数据模型,PM2 托管进程,nginx 做反向代理。

多渠道统一调度是最基础的能力。Postiz 支持 30+ 社交网络,包括 X、Instagram、YouTube、Facebook、LinkedIn、TikTok、Pinterest、Reddit、Threads、Discord、Slack、Mastodon、Bluesky、Telegram,甚至包括 Dev.to、Hashnode、Medium、Listmonk 这类博客与邮件列表渠道。
AI 能力是这轮迭代的重点。 从依赖清单能看到相当密集的 AI 栈:Vercel 的 @ai-sdk/openai、LangChain / LangGraph、Mastra(agent + memory + MCP)、@modelcontextprotocol/sdk、CopilotKit(前端嵌入式 AI 对话组件)、以及 @neynar 这类社交数据服务。功能面上对应的是 AI Copilot(文案生成与改写)、AI 图片、AI 视频、AI 视频切片(clipping),以及一个带记忆的 Smart Agent。
Agent 接入是一大亮点。 Postiz 提供 MCP Server 和 CLI,让 Claude、ChatGPT、Cursor、Codex、Claude Code、OpenClaw、Grok、Perplexity Computer、乃至 Hermes Agent 都能直接调用它——README 顶部的 agent 图标墙就是接入端清单。对 AI 工具链从业者来说,这意味着 Postiz 不再是一个"人去点"的工具,而变成了 Agent 可以直接调度的工具。
此外还有 Public API + Webhooks、n8n / Make.com / Zapier 集成、NodeJS SDK、团队协作与"帖子交易"等社区功能。

部署本身并不算难。官方 docker-compose.yaml 直接提供了 5 个服务:postiz(应用镜像 ghcr.io/gitroomhq/postiz-app:latest)、postgres:17-alpine、redis:7.2、spotlight(调试面板)和 elasticsearch:7.17.27(Temporal 依赖)。有 Dockerfile.dev(node:22.23.4-bookworm-slim 基础镜像,含 pnpm/PM2/nginx),环境变量在 .env.example 中给得相当完整,还提供了 railway.toml 和 .devcontainer 支持。
真正的门槛不在部署,而在OAuth 应用审核:每个社交平台都要自建开发者应用、自备 Client ID/Secret,Meta 系和 TikTok 的审核周期以周计。另外 v2.12 之后引入 Temporal 架构变更,官方明确提示不能直接跨版本升级到 v2.12+(社区 Issue #1169 反映需要两个 PostgreSQL 实例和额外的 OpenSearch)。因此,Postiz 属于"技术部署中等难度、业务接入高难度"的项目——Docker 起来只要十几分钟,但要让内容真正发到 X 和 TikTok,可能要等上几周。
AGPL-3.0 是双刃剑。 对自建团队没问题,但任何基于 Postiz 改造后再对外提供网络服务的场景,都必须开源自己的修改版本,商业化路径比 MIT/Apache 宽松得多。
测试覆盖近乎空白。 仓库里有 jest 配置和 test 脚本,但全树 1329 个文件里找不到实际的 *.spec.ts / *.test.ts 测试文件。对一个 791 个 TypeScript 文件、3500+ 次提交、70 位贡献者的项目来说,这意味着自动化回归保障基本依赖人工验证。
Issue 积压与架构债。 222 个 open issue 不算失控,但对于一个日更版本(v2.25.1 / v2.25.2 / v2.25.3 分别发布于 10 月 11、23、24 日)的项目,快速迭代换来的稳定性需要使用者自己承担。
第三方成本不可控。 AI 复制、切片、图片生成都走用户自己的 API Key,AI 视频和短视频功能还需要额外配置供应商;社交平台的配额和策略变化也不受项目控制。
Postiz 代表了开源 SaaS 的一种成熟形态:核心代码 AGPL 开源、托管版提供便利、开发者用 Docker 自建既省订阅费又掌握数据。它同时踩中了三条趋势线——多平台内容运营的集中化、生成式 AI 从"辅助写作"走向"端到端执行"、以及 MCP/Agent 协议让工具从"给人用"变成"给 Agent 用"。
对一个开源情报视角的观察者而言,Postiz 是评估"Agent 友好型应用"的一个标准样本:它不仅提供 API,还提供 MCP、CLI 和多种 Agent 适配层,这种设计正在成为 AI 时代开源应用的新基线。3.88 万 Star 背后的真实需求是——内容创作者不想再管发布节奏了,而 Agent 恰好能接管这件事。