heimdall-api/env.example at main · TriTechAI/heimdall-api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
# Heimdall API Environment Configuration Template
# 复制此文件为 .env 并根据实际环境修改配置值

# =============================================================================
# 服务配置 (Service Configuration)
# =============================================================================

# Admin API 服务配置
ADMIN_API_HOST=localhost
ADMIN_API_PORT=8080
ADMIN_API_MODE=dev  # dev, test, prod

# Public API 服务配置
PUBLIC_API_HOST=localhost
PUBLIC_API_PORT=8081
PUBLIC_API_MODE=dev  # dev, test, prod

# =============================================================================
# 数据库配置 (Database Configuration)
# =============================================================================

# MongoDB 配置
MONGODB_HOST=localhost
MONGODB_PORT=27017
MONGODB_DATABASE=heimdall_dev
MONGODB_USERNAME=
MONGODB_PASSWORD=
MONGODB_AUTH_SOURCE=admin
MONGODB_MAX_POOL_SIZE=10
MONGODB_MIN_POOL_SIZE=0

# Redis 配置
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DATABASE=0
REDIS_MAX_RETRIES=3
REDIS_POOL_SIZE=10

# =============================================================================
# JWT 配置 (JWT Configuration)
# =============================================================================

# JWT 密钥 (生产环境请使用强密钥)
JWT_SECRET=your-super-secret-jwt-key-please-change-in-production
JWT_ACCESS_EXPIRE=7200    # Access Token 过期时间(秒) - 2小时
JWT_REFRESH_EXPIRE=604800 # Refresh Token 过期时间(秒) - 7天

# =============================================================================
# 安全配置 (Security Configuration)
# =============================================================================

# 密码加密
BCRYPT_COST=12  # bcrypt 成本因子

# 登录安全
MAX_LOGIN_ATTEMPTS=5      # 最大登录失败次数
LOGIN_LOCKOUT_DURATION=1800  # 账户锁定时间(秒) - 30分钟

# API 限流
RATE_LIMIT_REQUESTS=100   # 每分钟请求数限制
RATE_LIMIT_BURST=10       # 突发请求数

# =============================================================================
# 日志配置 (Logging Configuration)
# =============================================================================

# 日志级别: debug, info, warn, error
LOG_LEVEL=info
LOG_FORMAT=json  # json, text
LOG_OUTPUT=stdout  # stdout, file

# 文件日志配置 (当 LOG_OUTPUT=file 时)
LOG_FILE_PATH=logs/app.log
LOG_MAX_SIZE=100    # 最大文件大小(MB)
LOG_MAX_BACKUPS=3   # 保留备份数
LOG_MAX_AGE=28      # 保留天数

# =============================================================================
# 文件存储配置 (File Storage Configuration)
# =============================================================================

# 存储类型: local, cos (腾讯云COS)
STORAGE_TYPE=local

# 本地存储配置
LOCAL_STORAGE_PATH=uploads
LOCAL_STORAGE_URL_PREFIX=http://localhost:8080/uploads

# 腾讯云 COS 配置 (当 STORAGE_TYPE=cos 时)
COS_SECRET_ID=
COS_SECRET_KEY=
COS_REGION=ap-beijing
COS_BUCKET=
COS_URL_PREFIX=

# =============================================================================
# 邮件配置 (Email Configuration)
# =============================================================================

# SMTP 配置
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USERNAME=
SMTP_PASSWORD=
SMTP_FROM_NAME=Heimdall Blog
SMTP_FROM_EMAIL=noreply@example.com

# =============================================================================
# 监控配置 (Monitoring Configuration)
# =============================================================================

# Prometheus 监控
ENABLE_METRICS=true
METRICS_PORT=9090

# 健康检查
HEALTH_CHECK_PATH=/health

# =============================================================================
# 开发配置 (Development Configuration)
# =============================================================================

# 是否启用调试模式
DEBUG=true

# 是否启用 API 文档
ENABLE_SWAGGER=true

# CORS 配置
CORS_ALLOW_ORIGINS=http://localhost:3000,http://localhost:8080
CORS_ALLOW_METHODS=GET,POST,PUT,DELETE,OPTIONS
CORS_ALLOW_HEADERS=Content-Type,Authorization

# =============================================================================
# 测试环境配置 (Test Environment Configuration)
# =============================================================================

# 测试数据库 (仅测试环境)
TEST_MONGODB_DATABASE=heimdall_test
TEST_REDIS_DATABASE=1

# 测试配置
TEST_JWT_SECRET=test-jwt-secret
TEST_BCRYPT_COST=4  # 测试时使用较低成本以提高速度