admin/aiapply

Fork 0

Files

renjianbo 1efcef6e10 second commit

2025-09-06 08:28:47 +08:00

4.4 KiB

Raw Blame History

PromptForge 环境变量配置指南

本指南将帮助您正确配置 PromptForge 的环境变量。

📋 配置步骤

1. 创建环境变量文件

在项目根目录创建 .env.local 文件：

# Windows
copy .env.example .env.local

# macOS/Linux
cp .env.example .env.local

2. 配置环境变量

编辑 .env.local 文件，填入以下配置：

# ==================== 数据库配置 ====================
# 本地 MySQL 数据库连接字符串
DATABASE_URL=mysql://root:your_password@localhost:3306/promptforge

# 腾讯云数据库连接字符串（可选）
TENCENT_DATABASE_URL=mysql://root:!Rjb12191@gz-cynosdbmysql-grp-d26pzce5.sql.tencentcdb.com:24936/pronode_db?charset=utf8mb4

# ==================== API 密钥配置 ====================
# OpenAI API 密钥
OPENAI_API_KEY=your_openai_api_key_here

# Anthropic API 密钥
ANTHROPIC_API_KEY=your_anthropic_api_key_here

# DeepSeek API 密钥
DEEPSEEK_API_KEY=sk-fdf7cc1c73504e628ec0119b7e11b8cc

# ==================== NextAuth 认证配置 ====================
# NextAuth 密钥（用于加密会话）
NEXTAUTH_SECRET=your_secret_key_here_make_it_long_and_random

# NextAuth URL
NEXTAUTH_URL=http://localhost:3000

# ==================== 应用配置 ====================
# 应用端口
PORT=3000

# 环境模式
NODE_ENV=development

🔑 API 密钥获取指南

OpenAI API 密钥

访问 OpenAI Platform
注册账户并登录
进入 API Keys 页面
点击 "Create new secret key"
复制生成的密钥
将密钥添加到 .env.local 文件

Anthropic API 密钥

访问 Anthropic Console
注册账户并登录
进入 API Keys 页面
点击 "Create Key"
复制生成的密钥
将密钥添加到 .env.local 文件

DeepSeek API 密钥

访问 DeepSeek Platform
注册账户并登录
进入 API Keys 页面
创建新的 API 密钥
复制密钥到 .env.local 文件

🔐 安全配置

生成安全的密钥

# 生成 NextAuth 密钥
openssl rand -base64 32

# 或使用 Node.js
node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"

数据库密码设置

-- 在 MySQL 中设置强密码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_strong_password_here';
FLUSH PRIVILEGES;

✅ 配置验证

1. 验证环境变量

# 检查环境变量是否正确加载
node -e "
console.log('DATABASE_URL:', process.env.DATABASE_URL ? '已设置' : '未设置');
console.log('NEXTAUTH_SECRET:', process.env.NEXTAUTH_SECRET ? '已设置' : '未设置');
console.log('OPENAI_API_KEY:', process.env.OPENAI_API_KEY ? '已设置' : '未设置');
"

2. 测试数据库连接

node test-db-connection.js

3. 测试 API 连接

node test-deepseek-api.js

🚨 安全注意事项

1. 文件安全

确保 .env.local 文件不会被提交到版本控制系统
在生产环境中使用环境变量而不是文件
定期备份重要的配置信息

2. 密钥管理

使用强密码和随机生成的密钥
定期更新 API 密钥
不要在代码中硬编码密钥
限制 API 密钥的权限范围

3. 数据库安全

使用强密码
限制数据库访问权限
定期备份数据库
启用 SSL 连接（生产环境）

🔧 常见配置问题

1. 环境变量未生效

问题: 修改 .env.local 后应用没有读取到新配置

解决方案:

# 重启开发服务器
npm run dev

# 或清除缓存
rm -rf .next
npm run dev

2. 数据库连接失败

问题: 无法连接到数据库

检查项目:

数据库服务是否启动
连接字符串是否正确
用户名密码是否正确
数据库是否存在

3. API 调用失败

问题: AI 模型 API 调用失败