Endpoint 是什么
Endpoint 是云服务暴露给调用方的访问域名，通常由「服务名 + 地域」组成，例如对象存储杭州公网地址 oss-cn-hangzhou.aliyuncs.com。SDK、CLI、Terraform 都靠它把请求打到正确的服务与地域。同一个服务在不同网络位置有三套地址：公网、经典内网、VPC 私网。选错 Endpoint 一般不会报错，只是更慢、更贵，或直接返回 403。
基本信息
| 定义 | 服务访问域名，一般含服务名与地域 |
|---|---|
| 常见形态 | 公网 Endpoint、经典内网 Endpoint、VPC 私网 Endpoint |
| 命名规律 | 公网如 oss-cn-hangzhou.aliyuncs.com，内网加 -internal 后缀 |
| 三厂示例 | COS 广州 cos.ap-guangzhou.myqcloud.com；OBS 北京四 obs.cn-north-4.myhuaweicloud.com |
| VPC 私网 | 通过私网连接或终端节点映射为 VPC 内域名，不经公网 |
典型使用场景
- 云主机内访问对象存储：配置内网 Endpoint，走内网流量、不产生公网流量费
- SDK 初始化：按 region 与网络环境选 endpoint，写入配置文件而非硬编码
- 混合云打通：用 VPC 终端节点让无公网出口的内网服务也能调用云 API
- 跨地域同步：源与目标各自指定本地域 Endpoint，避免请求绕行
- 排查 403 与超时：先确认请求实际打到了哪个 Endpoint
验证连通性
验证连通性
curl -I https://oss-cn-hangzhou.aliyuncs.com # 公网 Endpoint 是否可达
curl -I http://oss-cn-hangzhou-internal.aliyuncs.com # 内网 Endpoint 仅在同地域 VPC 内可解析
ping oss-cn-hangzhou.aliyuncs.com # 看解析出的 IP 是否落在预期网段
dig oss-cn-hangzhou.aliyuncs.com +short # 绕开本地缓存查真实解析结果三类 Endpoint 对比
| 类型 | 能否公网访问 | 流量计费 | 适用位置 |
|---|---|---|---|
| 公网 Endpoint | 可以 | 按公网流量计费 | 本地开发、跨地域调用 |
| 经典内网 Endpoint | 不可以 | 通常免流量费 | 同地域经典网络或已打通的 VPC |
| VPC 私网 Endpoint | 不可以 | 通常免流量费 | 同地域 VPC 内，优先选择 |
在云主机里用公网 Endpoint 访问对象存储，等于把内网数据绕一圈公网：既产生公网流量费用，又增加延迟与暴露面。上线前务必把 Endpoint 换成内网或 VPC 版本。
Region 与 Endpoint 必须匹配。用杭州的 Endpoint 访问北京地域的存储桶，通常直接返回 403 AccessDenied 或 404，而不是路由报错，排查时先对齐这两项。
选型自查清单
- SDK 配置里的 endpoint 是否与 region 一致
- 云主机内是否已经换成内网或 VPC Endpoint
- 终端节点与路由表是否已打通、DNS 能否解析
- 代码与镜像里有没有写死公网域名