render-env-vars

Render 上的环境变量

在检查或更改环境变量、密钥、密钥文件或环境组之前，请阅读 references/environment-variables.md，了解当前文档、事实来源、安全要求和变更工作流程。

Blueprint 接线示例和特定语言的应用说明位于 references/ 下。

何时使用此技能

当用户想要执行以下操作时，请使用此技能：

• 添加、更改或移除环境变量或密钥
• 了解 Dashboard、Blueprint 与 API/MCP 流程之间的区别
• 使用环境组共享配置
• 在 Blueprint 中配置 fromDatabase、fromService、fromGroup、sync: false 或 generateValue
• 排查缺失变量、密钥文件、优先级或平台注入的名称

如需完整的 Blueprint 编写流程，请搭配使用 render-blueprints。首次部署请使用 render-deploy。如需了解 Web 服务行为和端口，请使用 render-web-services。

Blueprint 接线（摘要）

阅读 references/environment-variables.md 后，请根据具体任务使用 references/wiring-reference.md 中的 fromDatabase、fromService 和 fromGroup 示例。完整的 Blueprint 工作流程请参阅 render-blueprints。

平台注入的变量

请使用通过 references/environment-variables.md 获取的当前默认变量参考，而不要依赖固定目录。特定语言的应用说明仍请参阅 references/platform-variables.md。

运行时专属默认值

除非使用静态站点或自定义 Docker 入口点，否则 HTTP 服务始终应绑定到 0.0.0.0 和 PORT（或该技术栈文档中指定的端口环境变量）。

• 排查端口绑定失败时，首先确认服务使用的是原生运行时还是 Docker，并检查实际启动命令；两者适用的默认值不同。
• 对于 Web 服务，PORT 默认为 10000。启动命令中应优先读取 $PORT，不要硬编码该数字，也不要仅为匹配任意硬编码端口而设置 PORT。
• 原生 Python 服务目前会收到默认绑定到 0.0.0.0:10000 的 GUNICORN_CMD_ARGS。自定义 Gunicorn 启动命令应绑定到 0.0.0.0:$PORT，以确保进程与 Render 的健康检查使用同一端口。

常见问题

部分较旧和较新的服务，其 WEB_CONCURRENCY 默认值有所不同。排查工作进程数量时，请比较服务创建日期并检查显式覆盖项，然后通过 references/environment-variables.md 和 references/platform-variables.md 确认当前行为。

参考资料

• references/environment-variables.md — 当前配置文档、密钥处理、环境组、平台变量及变更安全要求
• references/wiring-reference.md — Blueprint 跨资源接线示例和工作区边缘情况
• references/platform-variables.md — 并发、原生运行时与 Docker 行为，以及应用解析说明

相关技能

• render-blueprints — 完整的 Blueprint 编写、验证和多服务布局
• render-deploy — 首次部署、仓库要求、MCP 与 YAML
• render-web-services — 与环境变量驱动的服务相关的端口、健康检查和扩缩容行为

当前文档检索

每当此技能指示你查阅 Render 的当前文档时：

1. 使用可用的 URL 获取工具或 HTTP 客户端（例如 curl）直接获取链接的 Markdown 文档。不要用网页搜索摘要代替文档。
2. 确认获取成功且返回的是预期文档，然后阅读其内容。仅保存文件或输出其路径并不足够。
3. 如果请求失败，或你的工具无法读取 Markdown 响应，则打开并阅读链接的 HTML 版本。
4. 如果两个版本都无法获取，请说明当前参考资料不可用，并遵循技能中针对该主题的备用方案。仅将随附指南用于稳定的限制条件，不要猜测可能变动的平台详情。

如果任务需要多个参考资料，请对每份资料都执行此流程，并区分已验证的文档与仍不可用的文档。