如何在Railway.app上连接Strapi项目与PostgreSQL数据库

一、Railway 部署的 Strapi 连接同平台 PostgreSQL #

• 关联服务环境变量
  1. 打开 Railway 控制台，进入你的 Strapi 服务页面
  2. 切换到「Variables」标签，点击「Import from Service」，选择已创建的 PostgreSQL 服务，自动导入 PGHOST、PGDATABASE、PGUSER、PGPASSWORD、PGPORT 等变量
• 配置 Strapi 数据库连接文件
  修改项目根目录下的 config/database.js，使用环境变量读取数据库信息：

  module.exports = ({ env }) => ({
    connection: {
      client: 'postgres',
      connection: {
        host: env('PGHOST'),
        port: env.int('PGPORT'),
        database: env('PGDATABASE'),
        user: env('PGUSER'),
        password: env('PGPASSWORD'),
        ssl: env.bool('PGSSL', true), // Railway PostgreSQL 强制要求 SSL
      },
    },
  });
  

• 提交代码到 GitHub，Railway 会自动重新部署，完成后即可建立连接

二、本地 Strapi 连接 Railway 上的 PostgreSQL #

• 开启 PostgreSQL 公网访问权限
  1. 进入 Railway 的 PostgreSQL 服务页面，切换到「Settings」标签
  2. 找到「Public Network Access」选项，设置为「Enabled」并保存
• 同步环境变量到本地
  1. 在 PostgreSQL 服务的「Variables」标签，复制所有 PG 相关变量
  2. 粘贴到本地 Strapi 项目的 .env 文件中，额外添加 PGSSL=true
• 配置本地数据库连接文件
  确保本地 config/database.js 代码与上述生产环境配置一致（读取环境变量）
• 测试连接
  运行 npm run develop 启动本地 Strapi，若无连接报错则配置成功

内容的提问来源于stack exchange，提问作者Dariusz Legizynski