## 网络地址
注意:v2 API差异:现有`.proto`地址结构。
- [Pipe](#pipe)
- [SocketAddress](#socketaddress)
- [SocketAddress.Protocol (Enum)](#socketaddressprotocol-enum)
- [BindConfig](#bindconfig)
- [Address](#address)
- [CidrRange](#cidrrange)
### Pipe
[Pipe proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L11)
```
{
"path": "..."
}
```
- **path**<br />
([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) Unix域套接字路径。
### SocketAddress
[SocketAddress proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L16)
```
{
"protocol": "...",
"address": "...",
"port_value": "...",
"named_port": "...",
"resolver_name": "..."
}
```
- **protocol**<br />
([SocketAddress.Protocol](#socketaddressprotocol))
- **address**<br />
([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 套接字的地址。[监听器](../Configurationreference/Listeners.md)将绑定到该地址或出站连接地址。若配置为一个空的地址,意味着将绑定到0.0.0.0或::。在连接之后,仍然可以通过`FilterChainMatch`中的匹配前缀/后缀来区分地址。对于[群集](../v1APIreference/Clustermanager/Cluster.md),可以是通过DNS解析的IP或主机名。如果是主机名,除非需要默认(即DNS)解析,否则应该设置[resolver_name](../v2APIreference/Networkaddresses.md)。
- **port_value**<br />
([uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar))
- **named_port**<br />
([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 这只有在下面指定了`resolver_name`并且指定的解析器能够进行命名的端口解析时才有效。
注意:`port_value`、`named_port`必须选其中一个设置。
- **resolver_name**<br />
([string](https://developers.google.com/protocol-buffers/docs/proto#scalar)) 解析器的名称。这一定是在Envoy注册的。如果这是空的,则应用依赖于上下文的默认值。如果地址是主机名,则应该设置DNS以外的解决方案。如果地址是一个具体的IP地址,则不会发生解析。
### SocketAddress.Protocol (Enum)
[SocketAddress.Protocol proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L17)
- **TCP**<br />
(DEFAULT)
### BindConfig
[BindConfig proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L47)
```
{
"source_address": "{...}"
}
```
- **source_address**<br />
([SocketAddress](#socketaddress), REQUIRED) 创建套接字时绑定的地址。
### Address
[Address proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L55)
指定逻辑或物理地址和端口,这些地址和端口用于告诉Envoy绑定/监听的地址,连接到上游并查找相应的管理服务器。
```
{
"socket_address": "{...}",
"pipe": "{...}"
}
```
- **socket_address**<br />
([SocketAddress](#socketaddress))
- **pipe**<br />
([Pipe](#pipe))
注意:必须设置一个正确的socket_address或者Pipe。
### CidrRange
[CidrRange proto](https://github.com/envoyproxy/data-plane-api/blob/master/api/address.proto#L65)
CidrRange指定一个IP地址和前缀长度来构造一个CIDR范围的子网掩码。
```
{
"address_prefix": "...",
"prefix_len": "{...}"
}
```
- **address_prefix**<br />
([string](https://developers.google.com/protocol-buffers/docs/proto#scalar), REQUIRED) IPv4或IPv6地址,例如 192.0.0.0或2001:db8::。
- **prefix_len**<br />
([UInt32Value](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#uint32value)) 前缀的长度,例如:0或者32。
## 返回
- [上一级](../v2APIreference.md)
- [首页目录](../README.md)
- 首页
- 简介
- Envoy是什么
- 架构介绍
- 术语
- 线程模型
- 监听器
- L3/L4网络过滤器
- HTTP连接管理
- HTTP过滤器
- HTTP路由
- gRPC
- WebSocket支持
- 集群管理
- 服务发现
- 健康检查
- 连接池
- 负载均衡
- 异常检测
- 熔断
- 全局限速
- TLS
- 统计
- 运行时配置
- 跟踪
- TCP代理
- 访问日志
- MongoDB
- DynamoDB
- Redis
- 热重启
- 动态配置
- 初始化
- 逐出
- 脚本
- 部署
- 业界对比
- 获得帮助
- 历史版本
- 编译安装
- 编译
- 参考配置
- 演示沙箱
- 前端代理
- Zipkin跟踪
- Jaeger跟踪
- gRPC桥接
- 构建Envoy Docker镜像
- 工具
- 配置参考
- V1 API 概述
- V2 API 概述
- 监听器
- 网络过滤器
- TLS客户端身份认证
- Echo
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP连接管理器
- 路由匹配
- 流量转移/分流
- HTTP头部操作
- HTTP头部清理
- 统计
- 运行时设置
- 路由发现服务
- HTTP过滤器
- 缓存
- CORS过滤器
- 故障注入
- DynamoDB
- gRPC HTTP/1.1 桥接
- gRPC-JSON 转码过滤器
- gRPC-Web 过滤器
- 健康检查
- 速率限制
- 路由
- Lua
- 集群管理
- 统计
- 运行时设置
- 集群发现服务
- 健康检查
- 熔断
- 访问日志
- 限速服务
- 运行时配置
- 路由表检查工具
- 运维管理
- 命令行选项
- 热重启
- 管理接口
- 统计概述
- 运行时配置
- 文件系统
- 自定义扩展示例
- V1 API参考
- 监听器
- 网络过滤器
- TLS客户端身份认证
- Echo
- HTTP连接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP路由配置
- 虚拟主机
- 路由
- 虚拟集群
- 速率限制配置
- 路由发现服务
- HTTP过滤器
- 缓存
- CORS过滤器
- DynamoDB
- 故障注入
- gRPC HTTP/1.1 桥接
- gRPC-JSON 转码过滤器
- gRPC-Web 过滤器
- 健康检查
- Lua
- 速率限制
- 路由
- 集群管理
- 集群
- 健康检查
- 熔断
- TLS上下文
- 异常值检测
- HASH环负载均衡配置
- 异常检测
- 集群发现服务
- 服务发现服务
- 访问日志
- 管理接口
- 限速服务
- 运行时配置
- 跟踪
- V2 API参考
- 启动引导
- 监听&监听发现
- 集群&集群发现
- 服务发现
- 健康检查
- HTTP路由管理&发现
- TLS配置
- 通用的类型
- 网络地址
- 协议选项
- 发现API
- 限速组件
- 过滤器
- 网络过滤器
- TLS客户端身份认证
- HTTP连接管理
- Mongo代理
- 速率限制
- Redis代理
- TCP代理
- HTTP过滤器
- 缓存
- 故障注入
- 健康检查
- Lua
- 速率限制
- 路由
- gRPC-JSON转码器
- 常见访问日志类型
- 常见故障注入类型
- FAQ
- Envoy有多快?
- 我在哪里获得二进制文件?
- 我如何设置SNI?
- 如何设置区域感知路由?
- 我如何设置Zipkin跟踪?