Ghost Docker 镜像文档

1. 镜像概述和主要用途

Ghost 是一个独立的在线发布平台，支持通过网页和电子邮件通讯进行内容发布。它内置了用户注册、访问权限控制和订阅支付功能（通过 Stripe 集成），让你能够与受众建立直接联系。Ghost 运行速度快、用户友好，基于 Node.js 和 MySQL8 构建。

!logo

2. 核心功能和特性

多渠道发布：支持网页和电子邮件通讯内容发布
用户管理：内置用户注册和身份验证系统
访问控制：支持内容访问权限管理（ gated access ）
订阅支付：通过 Stripe 集成实现订阅支付功能
技术栈：基于 Node.js 和 MySQL8 构建，性能高效
用户友好：直观的管理界面，易于使用
可扩展性：支持通过环境变量进行灵活配置

3. 使用场景和适用范围

个人博客和内容创作平台
电子邮件新闻通讯发布系统
需要会员订阅功能的独立网站
创作者与受众建立直接联系的内容平台
中小型媒体或自媒体的内容发布解决方案

4. 支持的标签及对应 Dockerfile 链接

6.3.1, 6.3, 6, latest Dockerfile
6.3.1-alpine, 6.3-alpine, 6-alpine, alpine Dockerfile
5.130.5, 5.130, 5 Dockerfile
5.130.5-alpine, 5.130-alpine, 5-alpine Dockerfile

5. 详细使用方法和配置说明

5.1 基础使用（开发模式）

以下命令将启动一个 Ghost 开发实例，默认监听 2368 端口（Ghost 标准端口）：

console
$ docker run -d --name some-ghost -e NODE_ENV=development ghost

5.2 自定义端口

如需从主机直接访问实例（无需通过容器 IP），可使用端口映射：

console
$ docker run -d \
  --name some-ghost \
  -e NODE_ENV=development \
  -e url=http://localhost:3001 \  # 设置访问 URL
  -p 3001:2368 \                 # 主机端口:容器端口
  ghost

成功启动后，可通过 http://localhost:3001 访问网站，通过 http://localhost:3001/ghost 访问管理后台（若使用远程服务器，将 localhost 替换为服务器 IP）。

5.3 持久化存储

Ghost 的内容数据（如文章、图片等）需持久化存储以避免容器重启后丢失。可通过绑定主机目录或 Docker 卷实现。

5.3.1 绑定主机目录

以下示例使用 Alpine 版本镜像，并将主机目录挂载到容器内的内容目录：

console
$ docker run -d \
  --name some-ghost \
  -e NODE_ENV=development \
  -e database__connection__filename='/var/lib/ghost/content/data/ghost.db' \  # SQLite 数据库路径（仅开发模式）
  -p 3001:2368 \
  -v /path/to/ghost/blog:/var/lib/ghost/content \  # 主机目录:容器内容目录
  ghost:alpine

注意：database__connection__filename 仅在开发模式下有效，用于指定 SQLite 数据库文件路径，必须设置为持久化目录内的可写路径。生产模式下不支持 SQLite，需使用外部 MySQL 服务器（见 5.7 节）。

5.3.2 使用 Docker 卷

推荐使用 Docker 命名卷而非直接绑定主机路径，更便于管理：

console
$ docker run -d \
  --name some-ghost \
  -e NODE_ENV=development \
  -e database__connection__filename='/var/lib/ghost/content/data/ghost.db' \
  -p 3001:2368 \
  -v some-ghost-data:/var/lib/ghost/content \  # Docker 卷:容器内容目录
  ghost

5.4 配置参数

所有 Ghost 配置参数（如 url）均可通过环境变量指定。配置键与环境变量的转换规则为：嵌套键使用双下划线（__）连接（例如 database.connection.host 对应 database__connection__host）。详细配置说明见 Ghost ***文档。

示例：设置网站 URL 和数据库连接参数

console
$ docker run -d \
  --name some-ghost \
  -e NODE_ENV=development \
  -e url=[***] \
  -e database__connection__host=db \
  -e database__connection__user=root \
  ghost

5.5 查看 Node.js 版本

提交 Ghost 相关 issue 时可能需要提供 Node.js 版本，可通过以下命令获取：

console
$ docker exec <container-id> node --version
vX.Y.Z  # Node.js 版本输出

5.6 Ghost-CLI 注意事项

尽管镜像中包含 Ghost-CLI，但许多 CLI 命令在 Docker 环境中无法正常工作，也非设计用于此场景。详细说明见 docker-library/ghost#156。

5.7 生产模式部署（使用 MySQL）

生产环境下，Ghost 要求使用外部 MySQL 数据库（不支持 SQLite），并需配置 HTTPS 和反向代理（需设置 X-Forwarded-For、X-Forwarded-Host、X-Forwarded-Proto 头）。

5.7.1 Docker Compose 示例

以下 compose.yaml 配置启动 Ghost 生产实例和 MySQL 数据库：

yaml
services:
  ghost:
    image: ghost:5-alpine  # 使用 Alpine 版本
    restart: always
    ports:
      - 8080:2368  # 可根据需求修改主机端口
    environment:
      # 数据库配置（需与 MySQL 服务参数对应）
      database__client: mysql
      database__connection__host: db
      database__connection__user: root
      database__connection__password: example  # MySQL 密码
      database__connection__database: ghost    # 数据库名称
      url: http://localhost:8080  # 生产环境需替换为实际域名（如 [***]
      # NODE_ENV: development  # 如需开发模式，取消注释此行（默认生产模式）
    volumes:
      - ghost:/var/lib/ghost/content  # 持久化 Ghost 内容

  db:
    image: mysql:8.0  # Ghost 要求 MySQL 8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example  # 与 Ghost 的 database__connection__password 一致
    volumes:
      - db:/var/lib/mysql  # 持久化 MySQL 数据

volumes:
  ghost:  # Ghost 内容卷
  db:     # MySQL 数据卷

启动服务：