Postiz 怎么安装：Docker Compose 与云端部署步骤对照

拾光·开源拾遗内容创作者 2026-11-04 238 阅读

Postiz 是一款用于安排、自动化和分析社交媒体内容的开源平台，可通过云端使用，也可用 Docker Compose 部署到自己的服务器。当前官方文档结构已变化（2026-11-04 实测）：Quickstart 现在是“从注册到排程”的上手指南，Cloud 与 Self-Hosting 是并列的两个章节；云端不是注册即可白嫖——它是订阅制（四档月费），新组织通常可得一次 7 天试用。因此现在适合先把安装方式选对，再连接账号和发布平台。

先选安装方式：云端还是 Docker

Postiz 的核心功能是管理社交媒体账号、创建内容并安排发布时间。选择安装方式时，主要考虑是否需要自己的服务器、是否熟悉 Docker，以及是否必须让数据运行在自己的基础设施上。

对比项	Cloud 云端版	Docker Compose 自托管版
适合用户	想先试用、不想配置服务器的人	需要自己维护服务器和数据环境的人
准备成本	注册后需选档订阅（或用一次性的 7 天试用，需绑卡验证）	安装 Docker Compose、下载仓库并启动容器
本地访问地址	登录平台后使用	`http://localhost:4007`
安装控制权	由平台托管	自己控制运行环境和配置
适合场景	测试功能、尽快发出第一条内容	长期部署、纳入自己的运维体系

这是按官方两种部署入口做的适用性对照，不是官方给出的优劣排名。只想确认 Postiz 是否适合自己时，优先选 Cloud；确定要长期自托管，或者需要在本地验证配置时，再选 Docker Compose。

云端怎么走完（按当前官方 Cloud 文档，2026-11-04 实测）：

到 Cloud 注册入口注册组织；
选档订阅——官方 Cloud Plans 页四档（月付/年付）：

档位月付年付连接渠道数团队成员

Standard $29 $278 5 否

Team $39 $374 10 是

Pro $49 $470 30 是

Ultimate $99 $950 100 是

发帖限额两处官方口径不一致，并列如实：Cloud Plans 页（docs.postiz.com/cloud/plans）写 “Posts per month: Unlimited”（每个付费档都写不限）；仓库对比表却写 “Posts per month: Limited by plan tier”（按档位限额）。以结算页当期显示为准，不要按任何一处单方面下结论。AI 图/视频积分按档递增、随订阅周年日重置（失败的生成不扣积分）——这条两处一致。出处：Plans 页与 Trial 页（docs.postiz.com/cloud/plans、/cloud/trial，2026-11-04 实测）。
试用规则先看清楚：新组织通常给 7 天试用、所选档位全功能、每组织仅一次；开始试用要绑支付方式做小额预授权（立即释放、不会实际扣款，失败则换卡）；试用期部分 AI 视频生成器不可用；
订阅后进入后台按当前 Quickstart 主线走：连接渠道（Channels）→ 创建内容（Posts）→ 排程（Scheduling/Calendar）——当前文档的上手流程就是这条排程主线，不再只是“装完就发”。

档位	月付	年付	连接渠道数	团队成员
Standard	$29	$278	5	否
Team	$39	$374	10	是
Pro	$49	$470	30	是
Ultimate	$99	$950	100	是

官方入口如下：

项目仓库：https://github.com/gitroomhq/postiz-app
Cloud 注册：https://platform.postiz.com
产品主页：https://postiz.com
Quick Start Guide：https://docs.postiz.com/quickstart

Docker Compose 安装：按这 3 步启动

Docker Compose 是用一份 Compose 配置同时启动多个容器的部署方式。Postiz 的自托管路径会启动应用及其依赖服务。

1. 准备 Docker Compose 和项目目录

先安装 Docker 与 Docker Compose，然后打开终端。执行下面这组官方命令：

git clone https://github.com/gitroomhq/postiz-app.git
cd postiz-app

命令完成后，终端应进入 postiz-app 目录。可以用以下命令确认当前目录：

pwd

输出路径应指向以 postiz-app 结尾的目录。若 git 不可用，先安装 Git；若 docker 不可用，先安装 Docker Desktop，或在 Linux 服务器上安装 Docker Engine 与 Compose 插件。不同系统安装 Docker 的官方步骤应按各自发行版处理，不要把另一套系统的命令直接混用。

2. 启动全部服务

在 postiz-app 目录执行官方给出的启动命令：

docker compose up -d

-d 表示让容器在后台运行。首次启动需要下载镜像并初始化依赖，终端可能暂时没有完整界面。不要在启动尚未结束时反复重复执行；需要判断状态时，可查看 Docker Compose 服务状态。

如果容器无法正常启动，优先检查当前目录是否包含仓库里的 docker-compose.yaml，再检查 Docker 服务是否正在运行。不要只执行 docker compose up 后就关闭终端；首次调试时可去掉 -d，让日志持续显示在当前窗口中。

3. 打开本地后台

浏览器访问：

http://localhost:4007

成功标志不是终端打印一行提示，而是页面能够打开 Postiz 界面。先用状态检查命令核对容器（官方安装流程的标准动作）：

docker compose ps

看到 Postiz 主服务与 PostgreSQL、Redis 等依赖都是 Up 状态，再排查网络；如果有容器反复 Restarting 或直接 Exited，用 docker compose logs <服务名> 看最后几十行。如果浏览器显示无法连接，优先确认 docker compose up -d 是否已经完成，以及依赖服务是否都处于运行状态。

远程服务器部署时，不能只依赖 localhost。需要让浏览器能够访问服务器的 4007 端口（官方 README 默认地址 http://localhost:4007）：在服务器防火墙/安全组放行 4007（Ubuntu 例：sudo ufw allow 4007/tcp 后 sudo ufw reload；云服务器还要在控制台安全组加同规则——环境配置通用做法，非 Postiz 专属命令），再通过服务器 IP 或已配置域名打开后台；公网开放前还应配置 HTTPS 和访问控制，避免管理后台直接暴露。

首次进入：创建管理员并完成验证

首次打开 http://localhost:4007 后，页面会要求创建管理员账号。需要填写姓名、邮箱地址和密码，其中密码最少 8 个字符。

这里有一个容易漏掉的分支：如果环境里配置了 RESEND_API_KEY，系统会要求验证邮箱；如果没有配置，账号会自动激活。这里的 RESEND_API_KEY 是邮件服务 Resend 的密钥，用于发送验证邮件。

因此，邮箱收不到验证邮件时，不要反复重新注册。按下面的顺序处理：

打开项目的环境变量配置，确认是否填写了 RESEND_API_KEY。
已填写时，检查该密钥是否有效，并检查邮件发送是否被服务商限制。
未填写时，可按本地测试需求移除该变量，再重新启动服务，让账号进入自动激活路径。

安装文档列出的环境变量位于仓库配置体系中。需要接入外部平台时，填写对应密钥，而不是先随意填写模板值。官方安装指南给出的配置示例包括：

X_API_KEY="your_consumer_key"
X_API_SECRET="your_consumer_secret"

LINKEDIN_CLIENT_ID="your_client_id"
LINKEDIN_CLIENT_SECRET="your_client_secret"

FACEBOOK_APP_ID="your_app_id"
FACEBOOK_APP_SECRET="your_app_secret"

YOUTUBE_CLIENT_ID="your_google_client_id"
YOUTUBE_CLIENT_SECRET="your_google_client_secret"

这些配置只对应各自平台，不能把 X、LinkedIn、Facebook 或 YouTube 的变量混填。填好后重启相关容器，再进入集成页面授权。

连接社交平台：应用装好不等于可以直接发帖

Postiz 安装完成，只能说明应用已经运行；还要连接社交平台并取得授权，才能创建和安排内容。

以 X 为例，本地安装的集成入口是：

http://localhost:4007/integrations/social/x

在页面前完成 X 应用的 Consumer Key 与 Consumer Secret 配置，再回到集成页连接账号。其他平台也有各自的集成路径和环境变量：

平台	本地集成路径	必填配置示例
X	`http://localhost:4007/integrations/social/x`	`X_API_KEY`、`X_API_SECRET`
LinkedIn	`http://localhost:4007/integrations/social/linkedin`	`LINKEDIN_CLIENT_ID`、`LINKEDIN_CLIENT_SECRET`
Facebook / Instagram	`http://localhost:4007/integrations/social/facebook`	`FACEBOOK_APP_ID`、`FACEBOOK_APP_SECRET`
YouTube	`http://localhost:4007/integrations/social/youtube`	`YOUTUBE_CLIENT_ID`、`YOUTUBE_CLIENT_SECRET`

Facebook 与 Instagram 还有一个额外边界：Instagram 发布要求账号连接到 Facebook Business Page。没有对应商务主页时，即使 Facebook 应用密钥已经填好，Instagram 路径仍然无法完成。

开发者应用凭据需要从各平台官方开发者后台取得。Postiz 安装指南列出的入口包括：

LinkedIn Developer Portal：https://www.linkedin.com/developers/
Facebook Developers：https://developers.facebook.com/
Google Cloud Console：https://console.cloud.google.com/

建议先只连接一个平台，把“应用启动、后台登录、账号授权、创建内容、安排发布”这条链路跑通，再批量接入其他账号。一次配置多个平台，出现回调地址、权限范围或密钥问题时，反而不容易判断卡在哪一层。

怎么确认安装成功

Docker 路径需要同时满足三个可观察结果：

浏览器能打开 http://localhost:4007，而不是连接失败。
首次进入时能创建管理员账号，并看到 Postiz 主界面。
打开对应平台的集成页面后，已经连接的账号显示为可用状态。

只看容器“已经启动”还不够。Postiz 是由多个服务组成的应用，数据库或邮件服务即使单独运行正常，Web 服务仍可能因为依赖或环境变量缺失而无法完成初始化。判断标准应落在浏览器页面和实际平台连接上。

第一次试发时，建议创建一条内容、设置未来几分钟的发布时间，再确认社交平台出现该内容。若发布失败，依次检查平台授权是否有效、账号是否具备发布权限、媒体格式是否符合平台限制，以及环境变量是否在容器启动前完成配置。这样能把“安装失败”“授权失败”和“内容发布失败”分开定位。

官方文档与后续入口

完整安装细节以官方 Installation Guide 为准：

https://docs.postiz.com/installation

项目代码、问题反馈和版本更新在官方仓库查看：

https://github.com/gitroomhq/postiz-app

如果后续要把 Postiz 接入自动化工作流，仓库 README 还列出了 Public API、Node.js SDK、n8n 自定义节点和 Make.com 集成入口。安装只是第一步；准备接 API 或工作流前，先完成账号授权和一条测试帖的发布，能减少接口配置与平台权限互相影响的排查难度。

参考来源

# AI # 知识

评论区

0 条评论

登录后可评论。