向Elastic提交IP地址文档报错，需修正IPv6映射地址格式

问题原因 #

Elasticsearch的ip_range字段不允许对IPv6-mapped IPv4地址（如::ffff:1.0.1.19）使用CIDR表示法，因为前缀长度可能被解析为IPv4或IPv6的前缀，存在歧义。

可行解决方案 #

方案1：使用纯IPv4格式（推荐） #

你的示例地址本质是IPv4地址1.0.1.19的IPv6映射形式，直接用IPv4的范围表示即可，Elasticsearch完全支持：

• 单地址（起始/结束IP相同）：

  "ipv6-range": "1.0.1.19/32"
  

• 或者用数组形式明确范围：

  "ipv6-range": ["1.0.1.19", "1.0.1.19"]
  

方案2：用IPv6范围数组替代CIDR #

如果必须保留IPv6格式，不要用CIDR，直接指定起始和结束的完整IPv6地址：

"ipv6-range": ["::ffff:1.0.1.19", "::ffff:1.0.1.19"]

方案3：转换为纯IPv6十六进制格式 #

将IPv6-mapped地址转换为无映射的纯IPv6十六进制字符串，再使用/128前缀：
你的十进制值281470698520851对应的纯IPv6字符串为0000:0000:0000:0000:ffff:0100:0113，可以写成：

"ipv6-range": "0000:0000:0000:0000:ffff:0100:0113/128"

这种写法不如前两种直观，仅在必须使用纯IPv6格式时考虑。

PowerShell转换辅助脚本 #

从十进制值提取IPv4地址 #

$decimalIP = 281470698520851
# 移除IPv6映射前缀的数值（0xffff00000000）
$ipv4Decimal = $decimalIP - 0xffff00000000
# 转换为IPv4字符串
$ipv4Bytes = [BitConverter]::GetBytes([UInt32]$ipv4Decimal)
[Array]::Reverse($ipv4Bytes)
$ipv4Address = [System.Net.IPAddress]::new($ipv4Bytes).ToString()
# 输出结果：1.0.1.19

转换为纯IPv6十六进制字符串 #

$decimalIP = 281470698520851
$bigInt = [System.Numerics.BigInteger]$decimalIP
# 转换为16字节的IPv6字节数组（小端转大端）
$ipv6Bytes = $bigInt.ToByteArray()
$ipv6Bytes = $ipv6Bytes + [byte[]]::CreateInstance([byte], 16 - $ipv6Bytes.Length)
[Array]::Reverse($ipv6Bytes)
# 生成纯十六进制IPv6字符串
$ipv6Groups = for ($i=0; $i -lt 16; $i+=2) {
    [Convert]::ToString(([UInt16]($ipv6Bytes[$i] -shl 8 -bor $ipv6Bytes[$i+1])), 16).PadLeft(4, '0')
}
$ipv6FullString = [string]::Join(':', $ipv6Groups)
# 输出结果：0000:0000:0000:0000:ffff:0100:0113

内容的提问来源于stack exchange，提问作者Naveen Kumar