Node.js 18 HTTP客户端优先IPv4，如何改为优先使用IPv6？

数据老陈

2026-7-14

解决Node.js 18 HTTP客户端优先使用IPv4而非IPv6的问题

以下是几个可行的解决方案，按推荐优先级排序：

1. 用Node.js内置参数强制IPv6优先

直接通过NODE_OPTIONS环境变量设置DNS解析结果顺序为IPv6优先，这比verbatim更针对性：

启动Docker容器时添加环境变量：

docker run -e NODE_OPTIONS="--dns-result-order=ipv6first" [你的容器参数]

如果是通过Dockerfile启动Node-RED，可以在启动命令前注入环境变量：
```
ENV NODE_OPTIONS="--dns-result-order=ipv6first"
CMD ["node-red"]
```

2. 调整容器的地址选择策略

修改容器内的/etc/gai.conf文件，调低IPv4映射地址的优先级，让纯IPv6地址被优先选择：

在Dockerfile中添加配置步骤：
```
RUN echo "precedence ::ffff:0:0/96  10" >> /etc/gai.conf
```
这条配置会把IPv4映射的IPv6地址（DNS64生成的A记录对应地址）优先级调低，确保原生AAAA记录地址优先被选用。

或者启动容器时挂载自定义的gai.conf文件：

docker run -v ./custom-gai.conf:/etc/gai.conf [你的容器参数]

3. 代码层面手动指定IPv6解析

如果仅针对特定域名有问题，可以在Node-RED的代码中手动解析AAAA记录再发起请求：

const dns = require('dns').promises;
const axios = require('axios'); // 内置http模块同理

async function fetchWithIPv6(url) {
  const urlObj = new URL(url);
  const ipv6Addresses = await dns.resolve6(urlObj.hostname);
  // 替换为第一个IPv6地址，同时保留原域名的Host头
  urlObj.hostname = ipv6Addresses[0];
  return axios.get(urlObj.toString(), {
    headers: { 'Host': urlObj.hostname }
  });
}

// 使用示例
fetchWithIPv6('http://example.com')
  .then(res => console.log(res.data))
  .catch(err => console.error(err));