---
url: /configuration/dns/fakeip.md
description: FakeIP 地址池、反查映射和持久化边界
---

# FakeIP

FakeIP 用池内假地址回答域名，并把地址映射回名字；连接仍按真实名字路由。

```yaml check
dns:
  servers:
    real:
      type: udp
      address: 127.0.0.1:53
    fake:
      type: fakeip
      inet4_range: 198.18.0.0/15
      inet6_range: "fc00::/18"
      check_aaaa: real
  rules:
    - {domain_suffix: [lan], server: fake}
  final: real
```

## 字段

### inet4_range

* 类型：IPv4 CIDR。
* 必填：与 `inet6_range` 至少有一个。

### inet6_range

* 类型：IPv6 CIDR。
* 必填：与 `inet4_range` 至少有一个。

### check_aaaa

* 类型：DNS 服务器名。
* 必填：可选。
* 限制：必须指向会真实询问上游的服务器。
* 行为：分配假 IPv6 地址前先确认名字确实有 AAAA，避免只有 A 的名字拿到不可达的假 IPv6。

## 说明

一个运行只能定义一个 fakeip 服务器。需要真实地址的拨号和 `resolve` 动作会跳过 fake-IP 规则，避免把假地址拿去拨号。反向映射让域名规则和嗅探能把仅含地址的连接对应回名字。

启用 `cache_file.store_fakeip` 后，映射跨重载和重启保留；修改地址段后，段内映射继续使用，段外映射删除。假地址只存在缓存数据库，没有独立文件。清空接口和 API 行为见 [cache_file](/configuration/cache-file)。

## 相关

* [fakeip 服务器](/configuration/dns/server/fakeip)
* [cache_file](/configuration/cache-file)
* [DNS 总览](/configuration/dns/)