在Heroku部署的Ghost 1.7中配置Amazon S3存储适配器遇阻

阿华AIGC实验室

2026-5-19

解决Ghost 1.7在Heroku上配置S3存储的问题

看起来你已经走完了核心流程，但大概率是在几个容易忽略的细节上踩坑了，我来帮你一步步排查：

1. 适配Ghost版本的S3适配器安装

Ghost 1.7属于较早期版本，必须匹配对应的适配器版本——一定要安装ghost-storage-adapter-s3@2.x版本，3.x及以上是给Ghost 2.0+设计的，不兼容1.x系列。

本地项目执行安装命令：

npm install ghost-storage-adapter-s3@2 --save

关键一步：给Ghost创建适配器的符号链接，不然Ghost找不到这个存储插件：
```
ln -s ../../../node_modules/ghost-storage-adapter-s3 content/adapters/storage/s3
```
别忘记把这个符号链接加入你的Git仓库！不然部署到Heroku时会丢失，适配器等于白装。

2. 修正Heroku上的配置方式

Heroku的文件系统是临时的，直接修改config.production.json很可能在dyno重启后失效，更可靠的是用以下两种方式：

方式一：用环境变量传递配置（推荐）

在Heroku控制台或CLI里设置这些环境变量，比改配置文件更持久：

GHOST_STORAGE_ADAPTER=s3
GHOST_STORAGE_ADAPTER_S3_ACCESS_KEY_ID=你的IAM AccessKey
GHOST_STORAGE_ADAPTER_S3_SECRET_ACCESS_KEY=你的IAM SecretKey
GHOST_STORAGE_ADAPTER_S3_BUCKET=你的S3桶名
GHOST_STORAGE_ADAPTER_S3_REGION=你的桶所在区域（比如us-east-1）
GHOST_STORAGE_ADAPTER_S3_ASSET_HOST=https://你的桶名.s3.amazonaws.com（可选，用于直接访问图片资源）

方式二：正确配置`config.production.json`

如果坚持用配置文件，确保格式完全正确，示例如下：

{
  "production": {
    "url": "你的Heroku域名",
    "database": { /* 你的数据库配置 */ },
    "storage": {
      "active": "s3",
      "s3": {
        "accessKeyId": "YOUR_ACCESS_KEY",
        "secretAccessKey": "YOUR_SECRET_KEY",
        "bucket": "YOUR_BUCKET_NAME",
        "region": "YOUR_REGION",
        "assetHost": "https://YOUR_BUCKET_NAME.s3.amazonaws.com"
      }
    },
    /* 其他原有配置项 */
  }
}

修改后把这个文件加入Git仓库，再部署到Heroku。

3. 检查S3桶与IAM的权限细节

虽然你给了IAM用户AmazonS3FullAccess，但还是要确认这些点：

配置里的桶名完全匹配（S3桶名大小写敏感！别写错）
IAM密钥没有输入错误（复制时别带空格或多余字符）

桶的CORS配置是否允许访问？如果上传后图片无法显示，可能需要配置CORS规则，示例：

<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
    <AllowedOrigin>*</AllowedOrigin> <!-- 也可以指定你的Heroku域名更安全 -->
    <AllowedMethod>GET</AllowedMethod>
    <AllowedMethod>POST</AllowedMethod>
    <AllowedMethod>PUT</AllowedMethod>
    <AllowedHeader>*</AllowedHeader>
</CORSRule>
</CORSConfiguration>