configuration-guide

# Render 配置指南 Render 部署的通用配置模式、最佳实践及故障排除。 ## 环境变量 ### 必需与可选变量 **务必在 render.yaml 中声明所有环境变量**，即使这些值稍后由用户提供。 **分为三类：** 1. **配置值** (硬编码): yaml envVars: - key: NODE_ENV value: production - key: LOG_LEVEL value: info - key: API_URL value: https://api.example.com 2. **密钥** (由用户提供): yaml envVars: - key: JWT_SECRET sync: false - key: STRIPE_SECRET_KEY sync: false - key: API_KEY sync: false 3. **自动生成** (由 Render 提供): yaml envVars: - key: SESSION_SECRET generateValue: true - key: ENCRYPTION_KEY generateValue: true ### 数据库连接模式 **PostgreSQL:** yaml envVars: - key: DATABASE_URL fromDatabase: name: postgres property: connectionString **Redis:** yaml envVars: - key: REDIS_URL fromDatabase: name: redis property: connectionString **多数据库:** yaml envVars: - key: PRIMARY_DB_URL fromDatabase: name: postgres-primary property: connectionString - key: ANALYTICS_DB_URL fromDatabase: name: postgres-analytics property: connectionString - key: CACHE_URL fromDatabase: name: redis property: connectionString ### 跨服务引用 引用账户中的其他服务： yaml services: - type: web name: frontend runtime: node envVars: - key: API_URL fromService: name: backend-api type: web property: host # 或 hostport, port - type: web name: backend-api runtime: node **可用属性：** - `host`: 服务主机名 - `port`: 服务端口 - `hostport`: 组合的 `host:port` ### 环境变量组 在服务间共享通用配置： yaml envVarGroups: - name: common-config envVars: - key: NODE_ENV value: production - key: LOG_LEVEL value: info - key: TZ value: UTC services: - type: web name: web-app runtime: node envVars: - fromGroup: common-config - key: PORT value: 10000 - type: worker name: worker runtime: node envVars: - fromGroup: common-config --- ## 端口绑定 ### 端口绑定要求 **关键：