跳转到内容

环境变量配置

为使 StudioCMS 正常运行,必须正确配置相关环境变量。这些变量对于建立与 Astro DB 的安全连接以及 StudioCMS API 的认证至关重要。若未正确配置这些环境变量,应用程序将无法正常运行。

您可以在项目根目录下创建 .env 文件并添加所需的环境变量。.env 文件是一个包含键值对的环境变量文本文件,应用程序在运行时将读取这些变量。

有关在 Astro 中使用环境变量的更多信息,请参考 Astro 文档中的环境变量指南^

  • ASTRO_DB_REMOTE_URL - libSQL 服务器的连接 URL
  • ASTRO_DB_APP_TOKEN - libSQL 服务器的应用令牌
.env
ASTRO_DB_REMOTE_URL=libsql://your.server.io
ASTRO_DB_APP_TOKEN=eyJh...RUCg
有关 @astrojs/db 的详细信息,请参阅 Astro DB 文档^

CMS_ENCRYPTION_KEY - 用于加密敏感数据的安全密钥

.env
CMS_ENCRYPTION_KEY="wqR+w...sRcg=="

有关 oAuth 认证的详细配置指南,请参阅配置 oAuth 认证文档。

如需启用 GitHub 认证,请在 .env 文件中添加:

.env
# GitHub OAuth 凭据
CMS_GITHUB_CLIENT_ID=
CMS_GITHUB_CLIENT_SECRET=
CMS_GITHUB_REDIRECT_URI=
.env
# Discord OAuth 凭据
CMS_DISCORD_CLIENT_ID=
CMS_DISCORD_CLIENT_SECRET=
CMS_DISCORD_REDIRECT_URI=
.env
# Google OAuth 凭据
CMS_GOOGLE_CLIENT_ID=
CMS_GOOGLE_CLIENT_SECRET=
CMS_GOOGLE_REDIRECT_URI=
.env
# Auth0 OAuth 凭据
CMS_AUTH0_CLIENT_ID=
CMS_AUTH0_CLIENT_SECRET=
CMS_AUTH0_DOMAIN=
CMS_AUTH0_REDIRECT_URI=

如需使用内置的 Cloudinary 插件,需配置以下变量:

.env
## Cloudinary JavaScript SDK
CMS_CLOUDINARY_CLOUDNAME="demo"