在 Ghost 中，"Options" 通常指的是 博客的全局设置，这些设置控制了博客的外观、行为、功能以及 SEO（搜索引擎优化）等各个方面，它们存储在 Ghost 数据库的 settings 表中，是博客配置的核心。
你可以通过 Ghost 后台的管理界面（Settings > General）来修改大部分选项，但了解这些参数的结构和作用对于开发者、高级用户和自动化部署（例如使用 CLI 或 API）都至关重要。
如何查看和管理 Options
通过 Ghost 后台界面 (最常用)
- 登录你的 Ghost 后台。
- 在左侧菜单中,点击 Settings。
- 选择 General 标签页。
- 你可以看到并修改所有核心的博客设置,如标题、描述、语言、时区等。
通过 Ghost Admin API (程序化操作)
如果你需要自动化地获取或设置这些参数,可以使用 Ghost Admin API。
获取所有 Options:
# 你需要替换 YOUR_API_URL 和 YOUR_ADMIN_API_KEY
curl -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
"https://YOUR-ghost-URL.com/ghost/api/v3/admin/settings/?source=html"
响应示例:
{
"settings": [
{
"key": "title",
"value": "我的 Ghost 博客",
"type": "string"
},
{
"key": "description",
"value": "这里是博客的描述，用于 SEO 和社交媒体分享。",
"type": "string"
},
{
"key": "lang",
"value": "zh",
"type": "string"
},
// ... 其他所有设置
]
}
更新单个 Option:
使用 PATCH 方法，并指定要更新的 key 和 value。
curl -X PATCH \
-H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"settings": [{"key": "title", "value": "我的新博客标题"}]}' \
"https://YOUR-ghost-URL.com/ghost/api/v3/admin/settings/"
核心 Options 参数分类详解
以下是 Ghost Options 中最重要的一些参数，并按功能进行了分类。
A. 基础信息
| 参数 | 类型 | 描述 | 示例值 | | :--- | :--- | :--- | :--- || string | 博客的标题。 | "我的 Ghost 博客" | | description | string | 博客的简短描述，用于 SEO 的 meta 描述和社交媒体分享摘要。 | "分享技术与生活的个人博客" | | logo | image | 博客的标志图片。 | "https://example.com/logo.png" | | icon | image | 网站图标，通常用于浏览器标签页。 | "https://example.com/icon.png" | | cover_image | image | 博客的封面图，用于首页和文章页的头部。 | "https://example.com/cover.jpg" | | lang | string | 博客的主要语言，遵循 ISO 639-1 标准。 | "zh" (中文), "en" (英文), "ja" (日文) | | timezone | string | 博客使用的时区。 | "Asia/Shanghai" | | facebook | string | 你的 Facebook 个人资料或主页 URL。 | "https://facebook.com/yourprofile" | | twitter | string | 你的 Twitter 用户名。 | "your_twitter_handle" | | instagram | string | 你的 Instagram 用户名。 | "your_instagram_handle" |
B. 导航与菜单
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| navigation | json | 定义网站导航栏的链接，这是一个 JSON 数组，包含标签和 URL。 | [{"label": "首页", "url": "/"}, {"label": "关于我", "url": "/about/"}] |
C. 内容与文章
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| posts_per_page | number | 每个列表页面（如首页、标签页）显示的文章数量。 | 10 |
| codeinjection_head / codeinjection_foot | string | 允许你直接在网站 HTML 的 <head> 或 <body> 底部插入自定义代码，常用于添加第三方脚本（如 Google Analytics, 聊天插件）、自定义字体或 CSS。 |
<script src="..."></script> |
| amp | boolean | 是否启用 AMP (Accelerated Mobile Pages)，启用后，Ghost 会为每篇文章生成 AMP 版本。 | true / false |
D. SEO 与元数据
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| meta_title | string | SEO 使用的自定义页面标题模板，可以使用 {{title}} 和 @site 变量。 |
{{title}} - @site |
| meta_description | string | SEO 使用的自定义页面描述模板。 | {{description}} |
| og_image | image | Open Graph 协议使用的默认分享图片，如果文章没有设置特色图片，则使用此图。 | "https://example.com/default-og-image.jpg" |
E. 会员与订阅
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| members_signup_access | string | 控制新用户注册的方式，可选值：public (公开), invite (仅限邀请), none (禁用)。 |
public |
| members_signup_confirmation | boolean | 是否需要用户通过邮件确认注册。 | true / false |
| portal_title | string | 会员中心的标题。 | "会员中心" |
| portal_button_text | string | 会员中心登录/注册按钮的文本。 | "登录 / 注册" |
F. 主题与外观
| 参数 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| theme | string | 当前激活的主题名称。 | "casper" (默认主题), "edition" |
| active_nav_items | json | 当前主题中启用的导航项目，具体内容取决于主题的设计。 | {"primary": [...], "secondary": [...]} |
特殊 Options：theme
theme 这个 option 非常特殊，它本身是一个字符串，表示当前激活的主题名称，但与主题相关的其他大量配置，通常存储在主题自身的 theme.json 文件中，并通过 Ghost 的 Options 系统来管理。
当你通过后台更换主题或调整主题设置时,Ghost 会读取新主题的 theme.json，并将其中的配置项动态地添加到博客的全局 settings 中，这些配置项通常以主题的名称作为前缀，
casper_navigation: 控制默认主题 "Casper" 的导航设置。edition_card_style: 控制主题 "Edition" 的卡片样式。
这意味着,Options 的列表是动态的，并且依赖于你当前安装的主题。
实际应用场景
-
博客迁移与克隆:
- 当你想要将一个 Ghost 博客完整地复制到另一个新实例时，除了数据库和文件，你还需要导出和导入所有 Options，这能确保新博客的标题、SEO 设置、社交媒体链接等与原博客完全一致。
- 你可以通过 Admin API 批量获取所有设置，然后在新的实例上批量设置它们。
-
CI/CD 自动化部署:
在使用 GitHub Actions 或 Jenkins 等工具自动化部署博客时，可以在部署脚本的最后一步，通过 Admin API 调用，将博客的标题、描述等设置为来自环境变量或配置文件的值，这对于管理多个环境（如开发、测试、生产）非常有用。
-
高级定制与集成:
- 当你需要将 Ghost 与其他系统深度集成时，一个企业 CMS 系统需要动态地更新其关联的 Ghost 博客的联系方式和地址，就可以通过调用 Admin API 来修改
options，而无需登录 Ghost 后台。
- 当你需要将 Ghost 与其他系统深度集成时，一个企业 CMS 系统需要动态地更新其关联的 Ghost 博客的联系方式和地址，就可以通过调用 Admin API 来修改
Ghost 的 "Options" 参数是其配置系统的基石，它以键值对的形式存储了博客的几乎所有核心设置，虽然大部分设置都可以通过直观的后台界面完成，但对于开发者、运维人员和寻求自动化的用户来说，理解其 API 结构和参数意义是实现高级操作的关键，它不仅仅是“选项”，更是定义你 Ghost 博客身份和行为的核心数据。
