.env.example

# sage数据根目录目录
SAGE_ROOT=./data
SAGE_ENV=development
SAGE_WEB_BASE_PATH=/sage

SAGE_TRACE_WEB_URL=http://127.0.0.1:30051/jaeger/
# 观测jaeger 地址
SAGE_TRACE_JAEGER_URL=http://sage-jaeger:4317
SAGE_TRACE_JAEGER_UI_URL=http://sage-jaeger:16686/jaeger
SAGE_TRACE_JAEGER_PUBLIC_URL=http://127.0.0.1:30051/jaeger
SAGE_TRACE_JAEGER_BASE_PATH=/api/observability/jaeger
# sage API 地址
SAGE_API_BASE_URL=http://127.0.0.1:30050

# 沙箱配置
# 可选: local | passthrough | remote
SAGE_SANDBOX_MODE=local
# 额外挂载路径，逗号分隔，格式: /host/path:/sandbox/path
SAGE_SANDBOX_MOUNT_PATHS=
SAGE_LOCAL_CPU_TIME_LIMIT=300
SAGE_LOCAL_MEMORY_LIMIT_MB=4096
# Linux 容器 / Docker 部署推荐 subprocess；宿主机 Linux 可改为 bwrap
SAGE_LOCAL_LINUX_ISOLATION=subprocess
# 可选: subprocess | seatbelt
SAGE_LOCAL_MACOS_ISOLATION=seatbelt
# 远程沙箱提供者，可选: opensandbox | kubernetes | firecracker
SAGE_REMOTE_PROVIDER=opensandbox
OPENSANDBOX_URL=
OPENSANDBOX_API_KEY=
OPENSANDBOX_IMAGE=opensandbox/code-interpreter:v1.0.2
OPENSANDBOX_TIMEOUT=1800
SAGE_OPENSANDBOX_APPEND_MAX_BYTES=262144

# 认证模式
# 可选: trusted_proxy | oauth | native
# trusted_proxy: 仅保留 Sage 本地管理员账号密码登录；业务用户身份可由受信任代理透传
# oauth: Sage 自身走上游 OAuth/OIDC 登录
# native: 启用 Sage 本地用户名密码登录
SAGE_AUTH_MODE=native
# 允许来源网段/IP 通过 X-Sage-Internal-UserId 透传用户信息。
# 透传用户会默认以 user 角色写入请求上下文。
# 该配置只用于校验请求来源是否可被视为受信任身份代理，不决定登录模式。
# 使用 0.0.0.0/0 会存在安全风险，请谨慎配置。
SAGE_TRUSTED_IDENTITY_PROXY_IPS=127.0.0.1/32,10.0.0.0/8
# 可选的 bootstrap 管理员。只有两个变量都提供时才会创建。
SAGE_BOOTSTRAP_ADMIN_USERNAME=admin
SAGE_BOOTSTRAP_ADMIN_PASSWORD=sage.1234

# 认证 Providers（oauth 模式下需要配置 OIDC provider）
# 可选：使用 JSON 声明多个第三方 providers。
# 例如：
# SAGE_AUTH_PROVIDERS=[{"id":"corp-sso","type":"oidc","name":"企业 SSO","client_id":"xxx","client_secret":"xxx","discovery_url":"https://idp.example.com/.well-known/openid-configuration","button_text":"使用企业 SSO 登录","icon":"shield-check"}]
SAGE_AUTH_PROVIDERS=
# JWT / Session secrets
# 生产或 staging 环境必须显式修改下面三个值
SAGE_JWT_KEY=please_change_this_jwt_secret
SAGE_REFRESH_TOKEN_SECRET=please_change_this_refresh_secret
SAGE_SESSION_SECRET=please_change_this_session_secret
SAGE_SESSION_COOKIE_NAME=sage_session
SAGE_SESSION_COOKIE_SECURE=false
SAGE_SESSION_COOKIE_SAME_SITE=lax
# CORS 默认是公开跨域且不带浏览器凭据；需要 cookie/session 时请显式配置白名单并打开 credentials
SAGE_CORS_ALLOWED_ORIGINS=*
SAGE_CORS_ALLOW_CREDENTIALS=false
SAGE_CORS_ALLOW_METHODS=*
SAGE_CORS_ALLOW_HEADERS=*
SAGE_CORS_EXPOSE_HEADERS=
SAGE_CORS_MAX_AGE=600
# OAuth2 provider/client 配置（按需）
SAGE_OAUTH2_CLIENTS=
SAGE_OAUTH2_ISSUER=
SAGE_OAUTH2_ACCESS_TOKEN_EXPIRES_IN=3600

# 邮件验证码配置
SAGE_EML_ENDPOINT=dm.aliyuncs.com
SAGE_EML_ACCESS_KEY_ID=
SAGE_EML_ACCESS_KEY_SECRET=
SAGE_EML_SECURITY_TOKEN=
SAGE_EML_ACCOUNT_NAME=sage@mail.example.com
SAGE_EML_TEMPLATE_ID=
SAGE_EML_REGISTER_SUBJECT=Sage 安全验证，请确认您的邮箱
SAGE_EML_ADDRESS_TYPE=1
SAGE_EML_REPLY_TO_ADDRESS=false

# 默认LLM模型配置
SAGE_DEFAULT_LLM_API_KEY=
SAGE_DEFAULT_LLM_API_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/
SAGE_DEFAULT_LLM_MODEL_NAME=deepseek-v3
SAGE_DEFAULT_LLM_MAX_TOKENS=4096
SAGE_DEFAULT_LLM_TEMPERATURE=0.2
SAGE_DEFAULT_LLM_MAX_MODEL_LEN=52000
# 默认数据库配置
SAGE_DB_TYPE=mysql
SAGE_MYSQL_HOST=sage-mysql
SAGE_MYSQL_PORT=3306
SAGE_MYSQL_DATABASE=sage
SAGE_MYSQL_USER=root
SAGE_MYSQL_PASSWORD=sage.1234
# 默认Elasticsearch配置
SAGE_ELASTICSEARCH_URL=http://sage-es:9200
SAGE_ELASTICSEARCH_PORT=9200
SAGE_ELASTICSEARCH_USERNAME=elastic
SAGE_ELASTICSEARCH_PASSWORD=sage.1234
# 默认RustFS配置
SAGE_S3_ENDPOINT=sage-rustfs:9000
SAGE_S3_ACCESS_KEY=root
SAGE_S3_SECRET_KEY=sage.1234
SAGE_S3_SECURE=false
SAGE_S3_BUCKET_NAME=sage
SAGE_S3_PUBLIC_BASE_URL=http://localhost:30054/sage
# 默认Embedding模型配置
SAGE_EMBEDDING_API_KEY=
SAGE_EMBEDDING_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1/
SAGE_EMBEDDING_MODEL=text-embedding-v4
SAGE_EMBEDDING_DIMS=1024