render-networking

Render 私有网络

Render 的私有网络让服务可以在不将流量暴露到公共互联网的情况下相互通信。当用户需要内部连接、跨扩容实例的服务发现，或需要为 Blueprint 和 Dashboard 正确处理 URL／端口时，请使用此技能。

何时使用此技能

• 设计或调试 Render 上的服务间流量
• 关于 Dashboard 中的内部主机名、内部 URL 或 Connect > Internal 的问题
• 跨多个实例进行服务发现（自定义负载均衡、网格式设置）
• 端口限制、保留端口或多端口 Web 服务（公共与私有）
• 免费套餐 Web 服务，以及谁可以发送或接收私有流量
• 环境隔离（需要 Pro 工作区或更高版本）或用于私有出站／入站模式的 AWS PrivateLink

在设计、配置或排查私有连接问题之前，请阅读 references/private-networking.md。架构示例和 Blueprint 模式请参阅 references/communication-patterns.md。

私有连接要点

• 如果服务类型或流量方向不明确，请先确认哪个服务发起连接、哪个服务接收连接，再提供地址。
• 私有网络中的对等服务必须位于同一工作区和区域。请使用 Dashboard 中 Connect > Internal 提供的目标地址。
• 当客户端需要完整 URL 时，请构造完整 URL，例如 http://[internal-hostname]:[port]/path；单独的主机名不包含协议。
• Web 服务和私有服务可以接收私有流量。后台 Worker、cron 作业和工作流运行可以发起私有出站连接，但没有内部主机名，也不能接收此类连接。
• 在网关模式中，公共 Web 服务通过私有网络调用私有服务；私有服务无需公共端点。

服务发现

普通的服务间流量使用服务的常规内部主机名。当应用确实需要获取每个活跃实例的信息（用于自定义负载均衡、按实例采集指标或类似逻辑）时，请使用服务发现主机名，通常为 [internal-hostname]-discovery，它会解析为所有活跃实例的 IP 地址。每个 Web 服务或私有服务都会在 RENDER_DISCOVERY_SERVICE 中获得自己的服务发现主机名。不要持久保存解析出的 IP 地址，因为它们可能会在部署之间发生变化。

常见模式

以下为简要概述；完整图示和 Blueprint 说明见 references/communication-patterns.md。

1. Web 网关 + 私有后端 — 公共 Web Service 负责处理 HTTP；内部调用通过私有主机名和端口，连接私有服务或内部 URL。
2. Worker 连接数据库 — 后台 Worker（没有内部主机名）通过 内部 URL 向 Postgres 或 Key Value 发起连接。
3. 微服务 — 私有服务（以及符合条件的 Web 服务）通过私有网络上的内部主机名:端口相互调用。

参考资料

文档	用途
references/private-networking.md	当前私有网络功能、地址、服务发现、端口、隔离和故障排查
references/communication-patterns.md	网关、Worker→DB、网格、URL 构造和 Blueprint fromService 模式

相关技能

• render-web-services — 公共 Web 服务、PORT 和 HTTP 行为
• render-private-services — 私有 Service 专属设置和扩缩容
• render-blueprints — render.yaml、fromService 和多服务连接

当前文档检索

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

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

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