render-web-services

Render Web 服务

本技能介绍 Render 上 Web 服务 的行为：流量如何到达进程、部署如何上线，以及可选功能（域名、磁盘、自动部署）如何相互影响。配置 render.yaml 或 Dashboard 设置时，可结合 Blueprint 和网络技能使用。

适用场景

• 配置或调试 端口绑定、PORT 或 多端口 Web 服务
• 了解边缘与容器内部对 TLS/HTTPS 的要求
• 排查阻止部署或导致部署回滚的 健康检查
• 配置 自定义域名、DNS 和证书签发
• 配置 自动部署、CI 门控部署 和 PR 预览生成
• 了解 持久磁盘 及其对扩缩容和零停机的影响
• 了解 部署生命周期：构建、预部署、切换、排空、回滚、关闭延迟

更深入的模式请参阅 references/（健康检查、域名、部署阶段）。

配置或排查部署和健康检查之前，请阅读 references/deployments.md。 挂载或更改持久磁盘之前，请阅读 references/persistent-disks.md。 配置或排查私有连接或附加端口之前，请阅读 references/private-networking.md。

端口绑定

• 监听 0.0.0.0（所有接口）。仅绑定到 localhost 或 127.0.0.1 会阻止 Render 的代理访问你的应用。
• HTTP 监听端口使用 PORT 环境变量。Render 会为你设置该变量；默认值通常为 10000，你可以在 Dashboard 中服务的 Settings 里更改配置值。
• 保留端口（正常流量请勿将应用绑定到这些端口）：18012、18013、19099。

多端口 Web 服务

• 只有 一个 端口会接收 公共 HTTP 流量：与 PORT 对应的端口。
• 其他开放端口只能通过 Render 的 私有网络访问（无法通过同一公共 URL 模式从公共互联网访问）。

TLS 和 HTTPS

• TLS 在 Render 边缘终止。 边缘通过 HTTPS 与客户端通信；你的进程通常会在 PORT 上接收 纯 HTTP。
• HTTPS 重定向由平台处理；通过 HTTP 访问的用户会在边缘被适当地重定向。
• 除非确有特殊且明确的需求，否则不要在应用内部为主要公共监听器终止 TLS——标准 Web 服务默认代理后端使用 HTTP。

健康检查

请参阅 references/deployments.md 了解平台当前行为。关于端点实现和常见故障模式，请参阅 references/health-check-patterns.md。

自定义域名

• 将 DNS 通过 CNAME 指向 [service-name].onrender.com（使用 Dashboard 中服务的主机名）。
• 对于已验证的域名，Render 会自动签发并续期 TLS 证书。
• Apex（根）域名需要使用特定于服务商的 类 CNAME 或扁平化记录，因为不支持在 @ 上使用普通 CNAME。
• 配置并验证后支持 通配符域名（例如 *.example.com）。
• 每个服务支持多个自定义域名；Blueprint 可在 domains 字段中列出这些域名。

Dashboard 操作步骤、验证和故障排查请参阅 references/custom-domains.md。

自动部署和 PR 预览

• 自动部署行为和手动触发方式请参阅 references/deployments.md。
• PR 预览在 Blueprint 的 previews.generation（以及相关预览设置）中配置；生成行为取决于仓库集成和套餐。

持久磁盘

• 基于磁盘的 Web 服务保持单实例，无法水平扩展。
• 挂载磁盘会禁用零停机部署。
• 磁盘仅供正在运行的服务使用，构建期间或预部署命令运行期间不可用。
• 如果工作负载需要水平扩展或不间断部署，请使用共享外部存储，而不是挂载到服务的磁盘。
• 有关当前支持情况、配置、挂载路径、运行时访问、容量和快照行为，请参阅 references/persistent-disks.md。

部署生命周期

对于付费 Web 服务，请使用 preDeployCommand 执行数据库迁移和其他必须在新版本接收流量前成功完成的发布任务。该命令会在构建后于独立计算资源上运行；如果失败，部署会取消，之前的在线版本会继续提供服务。有关完整的构建、就绪状态、流量切换、连接排空、回滚、重启和部署钩子行为，请参阅 references/deployments.md。

免费套餐说明

免费 Web 服务有单独的限制：服务会在闲置一段时间后休眠（下一个请求到来时冷启动），且不支持扩展到单个实例以上，也不支持持久磁盘。在提供正常运行时间和扩展建议时，应将免费套餐的行为与付费 Web 服务的默认设置区别对待。

参考资料

主题	文件
健康检查设计、超时、注意事项	references/health-check-patterns.md
域名、DNS、TLS 验证	references/custom-domains.md
部署生命周期、健康检查、回滚、触发器	references/deployments.md
持久磁盘的限制和配置	references/persistent-disks.md
私有网络寻址、端口、服务发现和故障排查	references/private-networking.md

相关技能

• render-deploy — Blueprints、首次部署、render.yaml 结构
• render-docker — 基于 Docker 的 Web 服务以及映像/运行时详情
• render-networking — 私有网络、内部 URL、多端口私有监听器
• render-scaling — 实例数量、套餐和扩展限制（包括磁盘交互）

获取当前文档

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

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

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