跳到主要内容

环境变量

部署目录下的 .env 由 soln install 从 .env.example 复制生成，权限 0600。请保持 0600，不要提交到版本库。

部署身份​

变量含义
SOLN_DEPLOYMENT_TARGETlocal 表示本机部署，server 表示服务器部署
SOLN_DEPLOYMENT_MODEsingleMachine 或 externalServices
CP_URL用于注册、发布和令牌的控制面地址
CONTROL_PLANE_ISSUER控制面令牌的签发方
TENANT_ID、RUNTIME_ID、AGENT_IDRuntime 注册身份
RUNTIME_ORIGINRuntime 的精确 HTTPS Origin
AGENT_SECRETRuntime 注册凭据，控制面只显示一次
AGENT_CONFIG_PATHAgent 配置文件路径

产品帮助​

变量含义
HELP_CENTER_BASE_URLSoln 帮助中心站点的 Origin。帮助中心部署在其它域名时配置，回答会引用绝对链接；留空则引用站点相对路由。

本地存储​

变量含义
SOLN_DATA_AT_REST_ENCRYPTED开启存储加密后必须为 true
SOLN_DATA_ROOT租户数据的绝对、非根、受保护目录
RUNTIME_BIND_ADDRESS本机部署为 127.0.0.1
RUNTIME_BIND_PORT安装器选择的回环端口；本机优先 8443，服务器优先 8080。本机端口必须与 RUNTIME_ORIGIN 一致。

数据服务​

变量含义
DATABASE_URLPostgreSQL 连接串；外部数据库必须带 sslmode=verify-full
TEMPORAL_ADDRESSWorkflow Worker 使用的 Temporal endpoint
FILES_STORAGE_BACKEND内置或外部 S3 兼容存储使用 minio
FILES_MINIO_ENDPOINT、FILES_MINIO_BROWSER_ENDPOINT服务端与浏览器端 endpoint
FILES_MINIO_BUCKET、FILES_MINIO_ACCESS_KEY、FILES_MINIO_SECRET_KEYBucket 与凭据
FILES_MINIO_SERVER_SIDE_ENCRYPTION外部存储必须为 AES256；租户 MinIO KES 后端配置 Google Cloud KMS

安装时自动生成的密钥​

缺失或仍是占位符的值会在安装时自动生成：

  • RUNTIME_SESSION_ENCRYPTION_KEY
  • SOLN_BACKUP_ENCRYPTION_KEY
  • TENANT_RUNTIME_INTERNAL_SECRET
  • LUNA_TOOL_APPROVAL_SECRET
  • 单机模式下内置 PostgreSQL 与 MinIO 的密码

soln doctor 会校验加密密钥的长度与互不相同、内部密钥长度、环境文件权限，以及是否仍有占位符残留。

隧道​

变量含义
TUNNEL_CONNECTORnone 或 cloudflare
CLOUDFLARE_TUNNEL_IDNamed Tunnel 的 UUID
CLOUDFLARE_METRICS_BIND_ADDRESS、CLOUDFLARE_METRICS_PORT回环 metrics 端点

SOLN_DOCKER_IMAGE_STORE_PATH：Docker 使用 containerd 镜像存储时填写实际宿主机存储目录，供升级容量检查使用。它不会修改 Docker 配置。见存储与容量管理。