Back to Details

sales-ghost

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Ghost Platform Help

Ghost平台帮助指南

Step 1 — Gather context

步骤1 — 收集上下文信息

If 
references/learnings.md
exists, read it first for accumulated platform knowledge.
  1. What do you need help with?
    • A) Newsletter setup — Mailgun config, sending, delivery issues
    • B) Membership & subscriptions — Stripe integration, tiers, paid content gating
    • C) Content publishing — editor, scheduling, email-only posts, cards
    • D) Theme customization — Handlebars templates, custom settings, marketplace themes
    • E) Migration — from Substack, WordPress, Medium, Mailchimp, or other platforms
    • F) API integration — Content API, Admin API, webhooks, custom integrations
    • G) Analytics — newsletter open/click rates, member growth, engagement
    • H) Self-hosting — installation, updates, configuration, performance
    • I) Ghost(Pro) — plan selection, billing, limits, custom SSL
    • J) Something else
  2. How are you running Ghost?
    • A) Ghost(Pro) managed hosting
    • B) Self-hosted (Docker, DigitalOcean, AWS, etc.)
    • C) Third-party managed host (MagicPages, Pikapods, etc.)
    • D) Haven't set up yet — planning
  3. What's your goal? (describe your specific question or issue)
If the user's request already provides most of this context, skip directly to the relevant step.
如果存在
references/learnings.md
文件，请先阅读以获取已积累的平台相关知识。
  1. 你需要哪方面的帮助？
    • A) 新闻通讯设置 — Mailgun配置、发送、投递问题
    • B) 会员与订阅 — Stripe集成、等级划分、付费内容权限管控
    • C) 内容发布 — 编辑器、排期、仅邮件发布的文章、卡片组件
    • D) 主题定制 — Handlebars模板、自定义设置、市场主题
    • E) 迁移 — 从Substack、WordPress、Medium、Mailchimp或其他平台迁移
    • F) API集成 — Content API、Admin API、Webhooks、自定义集成
    • G) 数据分析 — 新闻通讯打开/点击率、会员增长、用户参与度
    • H) 自托管 — 安装、更新、配置、性能优化
    • I) Ghost(Pro) — 方案选择、账单、限制条件、自定义SSL
    • J) 其他问题
  2. 你当前的Ghost运行方式是？
    • A) Ghost(Pro)托管服务
    • B) 自托管（Docker、DigitalOcean、AWS等）
    • C) 第三方托管服务商（MagicPages、Pikapods等）
    • D) 尚未搭建 — 处于规划阶段
  3. 你的目标是什么？（描述你的具体问题或需求）
如果用户的请求已提供大部分上述上下文信息，请直接跳至对应步骤。

Step 2 — Route or answer directly

步骤2 — 路由或直接解答

If the request maps to a strategy skill, route with the exact command:
Problem domainRoute to
Email marketing strategy (sequences, segmentation, automation)"This is an email marketing question — run: 
/sales-email-marketing {user's question}
"
Newsletter monetization (paid tiers, finding sponsors)"This is a monetization question — run: 
/sales-newsletter {user's question}
"
Growing subscriber/member list"This is a growth question — run: 
/sales-audience-growth {user's question}
"
Membership site structure, course content, retention"This is a membership question — run: 
/sales-membership {user's question}
"
Email deliverability (SPF, DKIM, DMARC beyond Mailgun)"This is a deliverability question — run: 
/sales-deliverability {user's question}
"
Connecting Ghost to CRM or other tools via Zapier/API"This is an integration question — run: 
/sales-integration {user's question}
"
If the question is Ghost-specific, continue to Step 3.
如果请求属于策略类问题，请使用以下精确命令进行路由：
问题领域路由至
电子邮件营销策略（序列、细分、自动化）"这是电子邮件营销相关问题 — 执行：
/sales-email-marketing {用户问题}
"
新闻通讯变现（付费等级、寻找赞助商）"这是变现相关问题 — 执行：
/sales-newsletter {用户问题}
"
订阅者/会员列表增长"这是用户增长相关问题 — 执行：
/sales-audience-growth {用户问题}
"
会员网站结构、课程内容、用户留存"这是会员体系相关问题 — 执行：
/sales-membership {用户问题}
"
邮件投递能力（SPF、DKIM、DMARC，超出Mailgun范围的配置）"这是邮件投递能力相关问题 — 执行：
/sales-deliverability {用户问题}
"
通过Zapier/API将Ghost与CRM或其他工具连接"这是集成相关问题 — 执行：
/sales-integration {用户问题}
"
如果问题是Ghost平台专属问题，请继续执行步骤3。

Step 3 — Ghost platform reference

步骤3 — Ghost平台参考文档

Read 
references/platform-guide.md
 for the full platform reference — modules, pricing, integrations, data model, Mailgun setup, Stripe configuration, theme development, migration guides.
Answer the user's question using only the relevant section. Don't dump the full reference.
**阅读
references/platform-guide.md
**获取完整的平台参考内容 — 模块介绍、定价、集成方案、数据模型、Mailgun配置、Stripe设置、主题开发、迁移指南。
仅使用相关章节内容解答用户问题，请勿直接粘贴完整参考文档。

Step 4 — Actionable guidance

步骤4 — 可落地的指导方案

You no longer need the platform guide — focus on the user's specific situation.
For implementation questions, give step-by-step instructions tailored to their hosting type (Ghost(Pro) vs self-hosted). Reference the API docs in 
references/ghost-api-reference.md
when they need programmatic access.
If you discover a gotcha, workaround, or tip not covered in 
references/learnings.md
, append it there.
此时无需依赖平台指南 — 聚焦用户的具体场景。
对于实施类问题，根据用户的托管类型（Ghost(Pro)或自托管）提供分步指导。当用户需要程序化访问时，请参考
references/ghost-api-reference.md
中的API文档。
如果发现
references/learnings.md
中未涵盖的注意事项、替代方案或技巧，请将其添加至该文档中。

Gotchas

注意事项

Best-effort from research — review these, especially items about plan-gated features and integration gotchas that may be outdated.
  1. Starter plan has no paid subscriptions — you need Publisher ($29/mo) or higher to accept payments from members. Starter only supports free newsletters.
  2. Mailgun is the only bulk email provider — Ghost does not support SES, SendGrid, or other providers for newsletter sends. Self-hosters on small lists hit the Mailgun free tier limit (100 emails/day). Budget $15-35/mo for Mailgun on top of hosting.
  3. Stripe subscription sync can lag — members who pay in Stripe may show as "free" in Ghost temporarily. Check the webhook connection in Ghost Admin → Integrations → Stripe if member statuses aren't updating.
  4. No digest/weekly newsletter — Ghost sends one email per published post. There's no built-in way to batch multiple posts into a weekly digest. Workaround: manually create a weekly roundup post.
  5. Newsletter analytics are approximate — open tracking relies on pixel loading (blocked by many email clients). Click tracking is more reliable. Don't make decisions based solely on open rates.
  6. Migration breaks embedded content — Twitter/X embeds, custom HTML blocks, and some media may not render correctly in email after migrating from Substack or WordPress. Test email sends before going live.
  7. Theme changes require Handlebars knowledge — Ghost uses Handlebars templating, not a visual drag-and-drop builder. Custom themes need HTML/CSS/Handlebars skills. Use marketplace themes if you don't code.
  8. Self-hosted requires CLI updates — Ghost doesn't auto-update. Run 
    ghost update
    via the Ghost CLI regularly. Skipping major versions can make upgrades painful.
基于研究的最佳实践建议 — 请特别关注与方案受限功能和集成陷阱相关的内容，这些信息可能会随版本更新而过时。
  1. Starter方案不支持付费订阅 — 你需要升级到Publisher方案（每月29美元）或更高版本才能接受会员付款。Starter方案仅支持免费新闻通讯。
  2. 仅支持Mailgun作为批量邮件服务商 — Ghost不支持使用SES、SendGrid或其他服务商发送新闻通讯。自托管用户如果邮件列表较小，可能会触发Mailgun免费版的限制（每日100封邮件）。除托管费用外，每月需为Mailgun预算15-35美元。
  3. Stripe订阅同步可能存在延迟 — 在Stripe完成付款的会员，可能会暂时在Ghost中显示为“免费”状态。如果会员状态未更新，请检查Ghost后台 → 集成 → Stripe中的Webhook连接。
  4. 无摘要/每周新闻通讯功能 — Ghost会为每篇发布的文章单独发送一封邮件。没有内置功能将多篇文章批量整合为每周摘要。替代方案：手动创建每周汇总文章。
  5. 新闻通讯分析数据为近似值 — 打开率追踪依赖于像素加载（会被许多邮件客户端拦截）。点击率追踪相对更可靠。请勿仅基于打开率做出决策。
  6. 迁移可能导致嵌入内容失效 — 从Substack或WordPress迁移后，Twitter/X嵌入内容、自定义HTML块以及部分媒体可能无法在邮件中正确显示。正式上线前请测试邮件发送。
  7. 主题修改需要Handlebars知识 — Ghost使用Handlebars模板引擎，而非可视化拖拽构建器。自定义主题需要HTML/CSS/Handlebars技能。如果不具备编码能力，请使用市场中的主题。
  8. 自托管需要通过CLI进行更新 — Ghost不会自动更新。请定期通过Ghost CLI执行
    ghost update
    命令。跳过重大版本可能会导致升级过程困难。

Related skills

相关技能

  • /sales-newsletter
    — Newsletter monetization (paid subscriptions, sponsorships, premium tiers, pricing strategy)
  • /sales-email-marketing
    — Email marketing strategy (campaigns, automation, segmentation across platforms)
  • /sales-audience-growth
    — Growing your subscriber/member list (lead magnets, cross-promotion, referrals)
  • /sales-membership
    — Membership site strategy (course structure, retention, pricing models)
  • /sales-deliverability
    — Email deliverability (SPF, DKIM, DMARC, domain warmup, inbox placement)
  • /sales-integration
    — Connecting Ghost to CRM and other tools via Zapier, Make, or API
  • /sales-kit
    — Kit platform help (alternative newsletter platform)
  • /sales-mailerlite
    — MailerLite platform help (alternative newsletter/email platform)
  • /sales-do
    — Not sure which skill to use? The router matches any sales objective to the right skill. Install: 
    npx skills add sales-skills/sales --skill sales-do
  • /sales-newsletter
    — 新闻通讯变现（付费订阅、赞助、高级会员等级、定价策略）
  • /sales-email-marketing
    — 电子邮件营销策略（跨平台的营销活动、自动化、用户细分）
  • /sales-audience-growth
    — 订阅者/会员列表增长（引流工具、交叉推广、推荐机制）
  • /sales-membership
    — 会员网站策略（课程结构、用户留存、定价模型）
  • /sales-deliverability
    — 邮件投递能力（SPF、DKIM、DMARC、域名预热、收件箱投递率）
  • /sales-integration
    — 通过Zapier、Make或API将Ghost与CRM及其他工具连接
  • /sales-kit
    — Kit平台帮助指南（替代新闻通讯平台）
  • /sales-mailerlite
    — MailerLite平台帮助指南（替代新闻通讯/邮件平台）
  • /sales-do
    — 不确定使用哪个技能？该路由工具可将任何销售目标匹配至合适的技能。安装方式：
    npx skills add sales-skills/sales --skill sales-do

Examples

示例

Example 1: Mailgun delivery issues

示例1：Mailgun投递问题

User says: "My Ghost newsletter emails aren't being delivered to subscribers" Skill does: Checks Mailgun configuration in Ghost Admin, verifies domain DNS records (SPF, DKIM, CNAME), checks Mailgun dashboard for bounces/complaints, reviews Ghost(Pro) vs self-hosted differences, troubleshoots common Mailgun free tier limits Result: User identifies the delivery bottleneck and fixes their Mailgun configuration
用户提问："我的Ghost新闻通讯无法发送给订阅者" 技能执行流程：检查Ghost后台中的Mailgun配置、验证域名DNS记录（SPF、DKIM、CNAME）、查看Mailgun控制台中的退信/投诉记录、对比Ghost(Pro)与自托管的差异、排查Mailgun免费版常见限制问题 结果：用户定位到投递瓶颈并修复了Mailgun配置

Example 2: Setting up paid memberships

示例2：设置付费会员体系

User says: "I want to charge $10/month for premium content on my Ghost blog" Skill does: Confirms plan supports paid subscriptions (Publisher+), walks through Stripe Connect setup, configures membership tiers (free + paid), sets up content gating with the public preview card, creates an offer for founding members Result: User has a working paid membership with Stripe billing and gated content
用户提问："我想在我的Ghost博客上设置每月10美元的付费内容" 技能执行流程：确认方案支持付费订阅（Publisher及以上）、引导完成Stripe Connect配置、设置会员等级（免费+付费）、使用公开预览卡片配置内容权限管控、为创始会员创建优惠活动 结果：用户拥有一个可正常运行的付费会员体系，包含Stripe计费和内容权限管控

Example 3: Migrating from Substack

示例3：从Substack迁移

User says: "I'm moving my newsletter from Substack to Ghost — how do I keep my subscribers?" Skill does: Walks through Substack export, Ghost import process, Stripe subscription migration (if paid), DNS/domain transfer, URL redirect setup (Substack /p/ → Ghost slug), email template testing Result: User migrates content, subscribers, and paid members with minimal disruption
用户提问："我想把我的新闻通讯从Substack迁移到Ghost — 如何保留我的订阅者？" 技能执行流程：引导完成Substack导出、Ghost导入流程、Stripe订阅迁移（如有付费会员）、DNS/域名转移、URL重定向设置（Substack /p/ → Ghost slug）、邮件模板测试 结果：用户在最小中断的情况下完成了内容、订阅者和付费会员的迁移

Troubleshooting

故障排查

Stripe payments not reflecting in Ghost

Stripe付款未同步至Ghost

Symptom: Member pays in Stripe but Ghost shows them as "free" Cause: Stripe webhook not connected or webhook events failing Solution: Go to Ghost Admin → Settings → Membership → Stripe. Disconnect and reconnect Stripe. Check Stripe Dashboard → Developers → Webhooks for failed events. Ensure the webhook URL matches your Ghost domain.
症状：会员已在Stripe完成付款，但Ghost中显示为“免费”状态 原因：Stripe Webhook未连接或Webhook事件执行失败 解决方案：进入Ghost后台 → 设置 → 会员 → Stripe。断开并重新连接Stripe。查看Stripe控制台 → 开发者 → Webhooks中的失败事件。确保Webhook URL与你的Ghost域名匹配。

Newsletter shows 0% open rate

新闻通讯打开率显示为0%

Symptom: Newsletter sent successfully but analytics show zero opens Cause: Email clients blocking tracking pixels (Apple Mail Privacy Protection, Gmail proxy) Solution: Open rates are increasingly unreliable. Focus on click rates instead. Check Mailgun dashboard for actual delivery stats. If Mailgun shows delivered but Ghost shows 0%, the tracking pixel may be stripped.
症状：新闻通讯发送成功，但分析数据显示打开率为0% 原因：邮件客户端拦截了追踪像素（如Apple Mail隐私保护、Gmail代理） 解决方案：打开率的可靠性越来越低。请重点关注点击率。查看Mailgun控制台中的实际投递统计数据。如果Mailgun显示已投递但Ghost显示打开率为0%，则追踪像素可能被移除。

Ghost(Pro) plan limits hit unexpectedly

意外触发Ghost(Pro)方案限制

Symptom: Can't add more members, newsletters, or staff users Cause: Plan limits enforced — Starter: 1 staff/1 newsletter/1K members, Publisher: 3 staff/3 newsletters Solution: Upgrade plan in Ghost Admin → Settings → Pro. If approaching member limits, clean up inactive free members or upgrade to Business tier.
症状：无法添加更多会员、新闻通讯或员工用户 原因：方案限制生效 — Starter方案：1名员工/1个新闻通讯/1000名会员；Publisher方案：3名员工/3个新闻通讯 解决方案：在Ghost后台 → 设置 → Pro中升级方案。如果即将达到会员限制，请清理不活跃的免费会员或升级到Business方案。