SuperAPI AI 工具集

app-platform-networking

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:为 DigitalOcean App Platform 配置网络相关能力,包括自定义域名、路由、CORS、VPC、静态 IP 和服务间通信。

主要能力:自定义域名与通配符、基于路径的路由(如 /api 与 /)、基于子域名的路由(如 api.example.com)、跨域 CORS 配置、VPC 与可信来源、专用出站 IP(DEDICATED_IP)。

使用方式:通过 App Spec 字段配置,例如 domains[].domain、domains[].wildcard、ingress.rules[].match.path.prefix、ingress.rules[].match.authority.exact、ingress.rules[].cors、vpc.id、egress.type。路径路由规则顺序重要,具体规则需放在前面。CORS 中 allow_credentials 为 true 时只能使用精确来源,不能用正则。VPC 场景建议用 VPC CIDR 白名单,命令示例:doctl vpcs get $VPC_ID --format IPRange 与 doctl databases firewalls append $CLUSTER_ID --rule ip_addr:10.126.0.0/20。注意即使启用 VPC,可绑定变量仍返回公网主机名,需用私有 URL:doctl databases connection --private <cluster-id> --format URI。

适用场景:仅使用默认域名时不需要;需要自定义域名、多服务不同路径或子域名、跨子域名 API 调用、通过 VPC 安全访问数据库、防火墙白名单出站 IP 时适用。

限制与常见问题:域名解析需检查 DNS 记录并等待最长 72 小时传播;SSL 证书错误需为 letsencrypt.org 与 pki.goog 添加 CAA 记录;CORS 预检失败需在 allow_methods 中加入 OPTIONS;VPC 连接被拒应使用 VPC CIDR 白名单而非基于应用的规则;组件服务错误需调整规则顺序。更多细节见 domains-dns.md、ingress-routing.md、cors-configuration.md、vpc-trusted-sources.md、static-ips-egress.md、complete-patterns.md。