Nginx源码级教程：ngx_inet_ntop与ngx_sock_ntop的地址转换-Nginx-PHP中文网

ngx_inet_ntop 和 ngx_sock_ntop 是 nginx 中用于网络地址格式化的关键函数：前者将二进制地址结构直译为字符串，支持 ipv4/ipv6 自动压缩；后者在此基础上封装 socket 地址与端口，自动加方括号、转换字节序并拼接端口。

nginx源码级教程：ngx_inet_ntop与ngx_sock_ntop的地址转换

在 Nginx 源码中，ngx_inet_ntop 和 ngx_sock_ntop 是两个关键的地址格式化函数，负责将二进制网络地址（如 struct in_addr、struct in6_addr 或 struct sockaddr）转换为人类可读的点分十进制或 IPv6 字符串形式。它们不是简单封装 inet_ntop()，而是深度适配 Nginx 的内存管理、错误处理与跨平台需求。

ngx_inet_ntop：底层地址结构到字符串的直译器

ngx_inet_ntop 是最基础的地址转字符串函数，定义在 src/core/ngx_inet.c 中。它不关心 socket 上下文，只接收地址结构体指针（sa_family + 地址数据）、长度及目标缓冲区，返回写入的字节数。

支持 AF_INET（IPv4）和 AF_INET6（IPv6），自动识别并调用对应逻辑
对 IPv4 使用紧凑格式（如 192.168.1.1），不补零；对 IPv6 自动压缩连续零段（如 ::1 或 2001:db8::1）
要求调用方保证目标缓冲区足够大：NGX_INET_ADDRSTRLEN（IPv4 最大 16 字节）或 NGX_INET6_ADDRSTRLEN（IPv6 最大 46 字节）
返回 NULL 表示失败（例如 family 不支持、地址非法、缓冲区太小），否则返回指向结束符 '\0' 的指针

ngx_sock_ntop：面向 socket 的“即插即用”地址格式化

ngx_sock_ntop 是更高一层的封装，用于从 struct sockaddr*（可能含 port）直接生成完整地址字符串（如 "192.168.1.1:8080" 或 "[::1]:8080"）。它内部会先调用 ngx_inet_ntop 转地址，再手动拼接端口。

自动判断 sockaddr 类型（sockaddr_in / sockaddr_in6 / sockaddr_un），跳过不支持的类型（如返回 NULL）
IPv6 地址外强制加方括号（[...]），避免端口解析歧义（如 [::1]:80）
支持可选的 port 参数：若为非零，拼接 :port；若为 0，则只输出地址（常用于 listen 配置日志）
缓冲区大小建议用 NGX_SOCKADDR_STRLEN（定义为 512，兼顾 UNIX 域套接字路径长度）

实际使用中的典型场景与注意事项

这两个函数广泛出现在日志记录、错误提示、配置解析与调试输出中。比如 ngx_log_error 打印客户端地址、ngx_conf_set_listen 解析 listen 指令、或 ngx_event_accept 接收新连接后记录 peer 地址。

不要直接传栈上小数组给 ngx_sock_ntop——Nginx 日志等模块常用 ngx_str_t 配合 ngx_pnalloc 在内存池中分配缓冲区
注意 ngx_sock_ntop 对 sockaddr 的 sin_port/sin6_port 是网络字节序，函数内部会自动 ntohs 转换
调试时可用 ngx_log_debug + ngx_sock_ntop 快速打印任意 struct sockaddr_storage，比手写 inet_ntop 更安全可靠
自定义模块中若需复用逻辑，优先调 ngx_sock_ntop；仅当已有纯地址结构（无 port）且确定类型时，才用 ngx_inet_ntop

源码定位与调试建议

核心实现在 src/core/ngx_inet.c，函数签名清晰：

ngx_uint_t ngx_inet_ntop(int family, void *addr, u_char *text, size_t len);
u_char *ngx_sock_ntop(struct sockaddr *sa, socklen_t socklen, u_char *text, size_t len, ngx_uint_t port);