mirror of
https://github.com/fawney19/Aether.git
synced 2026-09-02 01:10:23 +08:00
83 lines
3.4 KiB
Plaintext
83 lines
3.4 KiB
Plaintext
# ==================== 必须配置（启动前） ====================
|
||
# 以下配置项必须在项目启动前设置
|
||
|
||
# 应用端口（默认 8084）
|
||
APP_PORT=8084
|
||
|
||
# Docker Compose 镜像（默认正式版 latest；提前测试可改 rc/beta；也可固定具体版本）
|
||
# 示例:
|
||
# APP_IMAGE=ghcr.io/fawney19/aether:latest
|
||
# APP_IMAGE=ghcr.io/fawney19/aether:rc
|
||
# APP_IMAGE=ghcr.io/fawney19/aether:beta
|
||
# APP_IMAGE=ghcr.io/fawney19/aether:0.7.0-rc.1
|
||
|
||
# API Key 前缀（默认 sk）
|
||
API_KEY_PREFIX=sk
|
||
|
||
# Rust 日志过滤（默认 aether_gateway=info）
|
||
# 示例: aether_gateway=debug,sqlx=warn
|
||
RUST_LOG=aether_gateway=info
|
||
|
||
# CORS 配置（跨域带 Cookie 时不要写 *，必须显式列出前端源）
|
||
# 示例: http://localhost:5173,https://app.example.com
|
||
# CORS_ORIGINS=http://localhost:5173
|
||
# CORS_ALLOW_CREDENTIALS=true
|
||
# 如果前后端跨站并依赖登录刷新 Cookie，还要配合：
|
||
# AUTH_REFRESH_COOKIE_SAMESITE=None
|
||
# AUTH_REFRESH_COOKIE_SECURE=true
|
||
|
||
# 数据库配置
|
||
DB_HOST=localhost
|
||
DB_PORT=5432
|
||
DB_USER=postgres
|
||
DB_NAME=aether
|
||
DB_PASSWORD=aether
|
||
|
||
# Redis 配置
|
||
REDIS_HOST=localhost
|
||
REDIS_PORT=6379
|
||
REDIS_PASSWORD=aether
|
||
|
||
# JWT密钥（使用 ./generate_keys.sh 生成）
|
||
# 用于用户登录 token 签名，更换后所有用户需重新登录
|
||
JWT_SECRET_KEY=change-this-to-a-secure-random-string
|
||
|
||
# 独立加密密钥（用于加密 Provider API Key 等敏感数据）
|
||
# 注意：更换此密钥后需要在管理面板重新配置所有 Provider API Key
|
||
ENCRYPTION_KEY=change-this-to-another-secure-random-string
|
||
|
||
# 启动自举管理员（仅在当前库里还没有活动管理员时生效）
|
||
# 手动部署时取消注释并设置；install.sh 首次生成配置时会提示输入。
|
||
ADMIN_EMAIL=admin@example.com
|
||
ADMIN_USERNAME=admin123456
|
||
# ADMIN_PASSWORD=
|
||
|
||
# ==================== 可选配置（有默认值） ====================
|
||
|
||
# docker compose 下 app 启动前自动执行 pending migration/backfill（默认 true）
|
||
# AETHER_GATEWAY_AUTO_PREPARE_DATABASE=true
|
||
|
||
# PostgreSQL 连接池配置（默认适合单实例/小型部署；高并发可按需调大）
|
||
# 推荐计算方式（单实例）：
|
||
# MAX = CPU 核数 × 10（AI 网关偏 IO 等待，可激进些；纯 OLTP 用 × 4）
|
||
# MIN = MAX × 0.2（保留常驻连接应对突发流量，避免冷启动握手开销）
|
||
# 多实例部署时请按 实例数 × MAX 控制总和，PG 端 max_connections 至少为该总和 + 20 余量
|
||
# AETHER_GATEWAY_DATA_POSTGRES_MIN_CONNECTIONS=4
|
||
# AETHER_GATEWAY_DATA_POSTGRES_MAX_CONNECTIONS=20
|
||
# AETHER_GATEWAY_DATA_POSTGRES_STATEMENT_CACHE_CAPACITY=100
|
||
# AETHER_GATEWAY_DATA_POSTGRES_ACQUIRE_TIMEOUT_MS=3000
|
||
|
||
# PostgreSQL 性能调优（默认值适合 2核4GB 机器，按实际配置覆盖）
|
||
# 参考：shared_buffers ≈ 可用内存 25%，effective_cache_size ≈ 可用内存 50-75%
|
||
# work_mem 是每个连接每个排序操作的内存，不要设太大（并发数 × work_mem 是实际占用）
|
||
# | 系统内存 | shared_buffers | effective_cache_size | work_mem |
|
||
# | 2GB | 256MB | 768MB | 4MB |
|
||
# | 4GB | 1GB | 3GB | 16MB |
|
||
# | 8GB | 2GB | 6GB | 16MB |
|
||
# | 16GB | 4GB | 12GB | 32MB |
|
||
# | 32GB+ | 8GB | 24GB | 32MB |
|
||
# POSTGRES_SHARED_BUFFERS=1GB
|
||
# POSTGRES_EFFECTIVE_CACHE_SIZE=3GB
|
||
# POSTGRES_WORK_MEM=16MB
|
||
# POSTGRES_MAINTENANCE_WORK_MEM=256MB
|