环境配置

配置 CINE-OS 环境变量

环境配置

CINE-OS 使用环境变量进行配置。在项目根目录创建 .env.local 文件。

最小配置

只需数据库即可运行:

DATABASE_URL=file:./local.db
NEXT_PUBLIC_APP_URL=http://localhost:3000

完整配置

变量用途默认值
DATABASE_URLSQLite/libsql 连接串file:./local.db
NEXT_PUBLIC_APP_URL前端基址http://localhost:3000

认证(可选)

变量用途
GOOGLE_CLIENT_IDGoogle OAuth 客户端 ID
GOOGLE_CLIENT_SECRETGoogle OAuth 密钥
GITHUB_CLIENT_IDGitHub OAuth 客户端 ID
GITHUB_CLIENT_SECRETGitHub OAuth 密钥

AI 服务(可选)

变量用途默认值
GEMINI_API_KEYGemini API 密钥-
GEMINI_MODELGemini 模型名称gemini-2.5-flash
GEMINI_BASE_URL自定义网关 URL-

媒资存储(可选)

变量用途
R2_ACCOUNT_IDCloudflare 账户 ID
R2_ACCESS_KEY_IDR2 访问密钥
R2_SECRET_ACCESS_KEYR2 密钥
R2_BUCKET_NAMER2 存储桶名称
R2_PUBLIC_URL公网访问 URL 前缀

Sentry(可选)

变量用途
SENTRY_DSN服务端/Edge 侧 DSN
NEXT_PUBLIC_SENTRY_DSN浏览器侧 DSN(必须是 NEXT_PUBLIC_ 前缀)
SENTRY_AUTH_TOKEN构建期上传 sourcemaps 的 token(建议仅在 CI/Vercel 构建环境设置)

示例:完整配置

# 数据库
DATABASE_URL=file:./local.db
NEXT_PUBLIC_APP_URL=http://localhost:3000

# AI 服务
GEMINI_API_KEY=sk-xxx
GRSAI_API_KEY=grsai-xxx

# 媒资存储
R2_ACCOUNT_ID=xxx
R2_ACCESS_KEY_ID=xxx
R2_SECRET_ACCESS_KEY=xxx
R2_BUCKET_NAME=cine-os
R2_PUBLIC_URL=https://pub.example.com

# Sentry (optional)
SENTRY_DSN=https://examplePublicKey@o0.ingest.sentry.io/0
NEXT_PUBLIC_SENTRY_DSN=https://examplePublicKey@o0.ingest.sentry.io/0
SENTRY_AUTH_TOKEN=sntrys_xxx

切勿将 .env.local 提交到版本控制。该文件已在 .gitignore 中。

功能可用性

功能所需变量
基础应用DATABASE_URL
AI 描述生成GEMINI_API_KEY
图像生成GRSAI_API_KEY
图像存储R2_* 系列变量
社交登录OAuth 凭证