bitnamicharts/ghost

Bitnami Ghost 镜像文档

镜像概述和主要用途

Ghost 是一个开源发布平台，专为创建博客、杂志和新闻网站设计。它包含带预览功能的 Markdown 编辑器、主题系统和内置 SEO 工具，简化内容编辑流程。Bitnami 提供的该镜像经过优化，包含初始化脚本、安全配置和持久化支持，可快速部署在容器环境中。

Ghost 官方网站

商标声明：本软件由 Bitnami 打包，相关商标归各自公司所有，使用不代表任何关联或背书。

核心功能和特性

• 内容编辑：内置 Markdown 编辑器，支持实时预览
• 主题系统：可自定义主题，支持响应式设计
• SEO 优化：自动生成元数据、站点地图和结构化数据
• 用户管理：多用户支持与角色权限控制
• 内容发布：草稿管理、定时发布和版本历史
• Bitnami 增强：
  • 简化的初始化流程
  • 持久化存储配置
  • 安全的环境变量管理
  • 外部数据库集成支持
  • 容器健康检查与自动恢复

使用场景和适用范围

• 个人博客：快速搭建个人写作平台
• 专业媒体：创建在线杂志、新闻网站或专栏
• 企业内容：内部知识库、产品文档或营销内容门户
• 开发测试：在本地或 CI/CD 环境中快速部署 Ghost 实例
• 教学演示：作为内容管理系统教学案例

安装和使用方法

前提条件

• Docker 1.19+ 或 Docker Compose 2.0+
• 至少 512MB 可用内存
• 持久化存储需求（可选，用于数据持久化）

Docker 快速启动

基本部署（使用内置 SQLite，仅适用于开发）

console
docker run -d \
  --name ghost \
  -p 80:8080 \
  -e GHOST_USERNAME=admin \
  -e GHOST_PASSWORD=StrongPassword123! \
  -e GHOST_EMAIL=admin@example.com \
  -e GHOST_BLOG_TITLE="My Tech Blog" \
  -v ghost_data:/bitnami/ghost \
  bitnami/ghost:latest

生产环境部署（Docker Compose + MySQL）

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  ghost:
    image: bitnami/ghost:latest
    ports:
      - "80:8080"
      - "443:8443"  # 若启用 HTTPS
    environment:
      # Ghost 核心配置
      - GHOST_USERNAME=admin
      - GHOST_PASSWORD=StrongPassword123!
      - GHOST_EMAIL=admin@example.com
      - GHOST_BLOG_TITLE="Production Blog"
      - GHOST_HOST=blog.example.com
      - GHOST_ENABLE_HTTPS=true
      
      # 数据库配置（使用外部 MySQL）
      - DATABASE_HOST=mysql
      - DATABASE_PORT=3306
      - DATABASE_USER=ghostuser
      - DATABASE_PASSWORD=ghostdbpass
      - DATABASE_NAME=ghostdb
      
      # SMTP 配置（用于邮件通知）
      - SMTP_HOST=smtp.example.com
      - SMTP_PORT=587
      - SMTP_USER=smtpuser@example.com
      - SMTP_PASSWORD=smtppass
      - SMTP_PROTOCOL=tls
    volumes:
      - ghost_data:/bitnami/ghost
      - ghost_apache:/bitnami/apache
      - ./certificates:/bitnami/ghost/certificates  # 挂载 TLS 证书
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: bitnami/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
      - MYSQL_DATABASE=ghostdb
      - MYSQL_USER=ghostuser
      - MYSQL_PASSWORD=ghostdbpass
    volumes:
      - mysql_data:/var/lib/mysql
    restart: unless-stopped

volumes:
  ghost_data:
  ghost_apache:
  mysql_data:

启动服务：

console
docker-compose up -d

访问 http://localhost 或配置的 GHOST_HOST 即可使用，管理后台位于 /ghost 路径（如 http://localhost/ghost）。

配置参数说明

核心配置参数

数据库配置

SMTP 配置（邮件发送）

存储配置

高级配置

持久化配置

Ghost 容器使用以下路径存储持久化数据：

本地目录挂载（Docker）

console
docker run -d \
  --name ghost \
  -p 80:8080 \
  -v /path/on/host/ghost:/bitnami/ghost \
  -v /path/on/host/apache:/bitnami/apache \
  bitnami/ghost:latest

命名卷挂载（Docker Compose）

yaml
volumes:
  ghost_data:
    driver: local
  apache_data:
    driver: local

services:
  ghost:
    image: bitnami/ghost:latest
    volumes:
      - ghost_data:/bitnami/ghost
      - apache_data:/bitnami/apache

高级配置指南

外部数据库集成

禁用内置数据库，连接外部 MySQL 或 PostgreSQL：

console
docker run -d \
  --name ghost \
  -e EXTERNAL_DATABASE_ENABLED=true \
  -e DATABASE_HOST=db.example.com \
  -e DATABASE_PORT=3306 \
  -e DATABASE_USER=externaluser \
  -e DATABASE_PASSWORD=externalpass \
  -e DATABASE_NAME=ghostdb \
  bitnami/ghost:latest

HTTPS 配置

1. 准备证书：将 SSL 证书（server.crt）和私钥（server.key）保存到本地目录
2. 挂载证书：

   console
   docker run -d \
     --name ghost \
     -p 443:8443 \
     -e GHOST_ENABLE_HTTPS=true \
     -v /path/to/certificates:/bitnami/ghost/certificates \
     bitnami/ghost:latest
   

3. 自动重定向：所有 HTTP 请求将自动重定向到 HTTPS

自定义主题

1. 将主题文件放入本地目录（如 ./themes/my-theme）
2. 挂载主题目录：

   yaml
   services:
     ghost:
       image: bitnami/ghost:latest
       volumes:
         - ./themes:/bitnami/ghost/content/themes
   

3. 在 Ghost 管理后台激活主题

环境变量文件

使用 .env 文件管理配置（适用于 Docker Compose）：

env
# .env 文件
GHOST_USERNAME=admin
GHOST_PASSWORD=StrongPassword123!
GHOST_EMAIL=admin@example.com
DATABASE_HOST=mysql
DATABASE_USER=ghostuser
DATABASE_PASSWORD=ghostdbpass

在 docker-compose.yml 中引用：

yaml
services:
  ghost:
    image: bitnami/ghost:latest
    env_file: .env

重要注意事项

Bitnami 镜像计划变更通知（2025年8月28日起）

Bitnami 将升级其公共镜像目录，推出 Bitnami Secure Images 计划，主要变更包括：

• 安全镜像开放：首次向社区用户提供安全优化版容器镜像
• 非强化镜像 deprecation：
  • 免费版将逐步淘汰基于 Debian 的非强化镜像
  • 公共目录（docker.io/bitnami）仅保留最新标签（latest）的强化镜像（用于开发目的）
• 旧镜像迁移：
  • 所有现有镜像（含历史版本标签，如 2.50.0、10.6）将迁移至 docker.io/bitnamilegacy 仓库
  • 迁移后不再提供更新和安全补丁
• 生产环境建议：
  • 生产环境应使用 Bitnami Secure Images
  • 提供强化容器、更小***面、CVE 透明度（VEX/KEV）、SBOM 和企业支持

详细信息参见 https://github.com/bitnami/containers/issues/83267%E3%80%82

故障排除

常见问题

1. 数据库连接失败：

   • 检查数据库容器是否正常运行
   • 验证 DATABASE_* 环境变量配置
   • 确保数据库用户有足够权限

2. 持久化数据丢失：

   • 确认挂载路径正确（/bitnami/ghost）
   • 检查宿主机目录权限（避免 root 权限问题）

3. 主题不显示：

   • 验证主题目录结构是否正确
   • 检查文件权限（容器内用户 1001 需要读取权限）

4. 邮件发送失败：

   • 使用 SMTP_SERVICE 简化配置（如 SMTP_SERVICE=gmail）
   • 检查 SMTP 服务器端口和加密协议（通常 587/TLS 或 465/SSL）

日志查看

console
# 容器日志
docker logs ghost

# Apache 访问日志
docker exec -it ghost cat /bitnami/apache/logs/access.log

# Ghost 应用日志
docker exec -it ghost cat /bitnami/ghost/content/logs/ghost.log