Linux系统中通过修改/etc/gai.conf文件，设置precedence ::ffff:0:0/96 100可使双栈环境下getaddrinfo()优先返回IPv4-mapped IPv6地址，从而实现IPv4连接优先，且不禁止IPv6使用。
Linux 系统中修改 `/etc/gai.conf` 是调整 `getaddrinfo()` 解析域名时 IPv6 与 IPv4 的优先顺序的关键方式。默认情况下，glibc 会优先返回 IPv6 地址（如果可用），这可能导致某些仅支持 IPv4 的服务连接缓慢或失败。通过编辑该文件，你可以控制地址族的排序逻辑。
理解 gai.conf 的作用机制
`/etc/gai.conf` 是 glibc 提供的配置文件，用于定制 `getaddrinfo()` 返回地址列表的排序规则。它不控制是否启用 IPv6，而是影响已有地址的呈现顺序。系统按文件中从上到下的规则逐条匹配，第一条匹配成功的规则决定该地址的“precedence 值”，数值越大越优先；相同 precedence 时再比 label 值（用于源地址选择）。
文件自带大量注释示例，但默认几乎全被注释掉，因此实际生效的只有少数几行（如 `precedence ::1/128 50`）。
常用修改：强制 IPv4 优先
若你希望大多数场景下优先使用 IPv4（比如内网环境无 IPv6、或遇到双栈超时问题），可添加以下规则：
- 在文件末尾添加一行：precedence ::ffff:0:0/96 100 —— 给所有 IPv4-mapped IPv6 地址（即
::ffff:a.b.c.d形式）最高优先级 - 或更直接地，提高原生 IPv4 的 precedence：precedence 0.0.0.0/0 100（注意：此写法在较新 glibc 中可能不被识别，推荐用前者）
- 同时建议补上：label ::1/128 1 和 label 0.0.0.0/0 1，保持 label 一致，避免源地址选择异常
验证修改是否生效
改完保存后无需重启服务，`getaddrinfo()` 调用会自动读取新配置。快速验证方法：
- 运行 getent ahosts google.com（注意是
ahosts，非hosts），观察输出中 IPv4 地址是否排在 IPv6 前面 - 用 curl -v http://google.com 并观察 CONNECT 行——若显示
Connecting to google.com [142.250.x.x] port 80即为 IPv4 成功优先 - 也可写个简短 C 程序调用
getaddrinfo()打印结果，确认排序
注意事项与常见误区
该配置只影响调用 `getaddrinfo()` 的程序（绝大多数现代网络工具都用它），不影响直接调用 `gethostbyname()` 的老程序（已废弃）；也不影响内核路由或 sysctl 设置。
- 不要删除或禁用 IPv6 协议栈来“解决”优先问题——这会破坏兼容性且非必要
- 修改后若无效，请检查文件权限（应为
644，root 可写）、有无语法错误（空格/缩进不敏感，但关键字拼错会静默忽略） - 容器环境（如 Docker）中，宿主机的 `/etc/gai.conf` 不会自动挂载进容器，需显式绑定或在镜像中配置
