I2P（Invisible Internet Project）是一套建立在公网之上的匿名覆盖网络，用户访问其中的隐藏站点（eepsite）时，使用的是以.i2p结尾的特有域名，而不是普通的互联网域名。这就带来一个常见困惑：I2P里的DNS到底是怎么工作的？要不要像普通网络那样设置DNS服务器？本文将从原理到实操，完整讲解I2P网络的DNS设置方法。
一、I2P网络中DNS的工作原理
首先要明确一个关键概念：I2P网络内部并不使用传统意义上的DNS服务器来解析.i2p域名。传统DNS采用分层递归查询机制，由根服务器、顶级域名服务器和权威服务器逐级完成解析。而I2P的域名解析走的是完全不同的路线——基于地址簿（Address Book）机制。
每个.i2p域名本质上对应一个Base64编码的目标地址（Destination），这是一个长度约516字符的字符串，包含了该站点的公钥、证书和加密信息。地址簿的作用就是把人类易读的域名（如forum.i2p）与这个超长的Destination建立映射关系。当你在浏览器中输入一个.i2p地址时，请求会被发送到I2P路由的HTTP代理端口（默认通常是4444），由路由程序在本地地址簿中查找对应的Destination，找不到时再向订阅的地址簿服务发起查询。
而传统DNS在I2P中只在一种场景下被使用：当你通过outproxy（出站代理）访问普通互联网网站时，由outproxy服务器端的DNS负责解析。也就是说，I2P客户端本身几乎不需要配置传统DNS，重点是配置好地址簿和代理。
二、Java版I2P的DNS与地址簿配置
Java版I2P是最经典的实现，安装完成后会同时在127.0.0.1上开启HTTP代理（默认4444端口）和SOCKS代理（默认4445端口）。地址簿相关配置集中在路由控制台的“地址簿”页面中。
打开浏览器访问 http://127.0.0.1:7657，进入路由控制台后依次查看“Addressbook”菜单。这里可以看到多个地址簿子库：private、local、router和published。private存放你手动添加且不希望公开的地址，local存放本地自建站点的地址，router存放从订阅源自动拉取的地址。点击“Subscriptions”（订阅）可以管理地址簿订阅源，默认已内置几个公共订阅地址，建议保持启用，这样常见的.i2p站点可以被自动解析。
如果需要手动添加某个.i2p站点，可以在地址簿页面点击“Add”填入域名和Base64地址，也可以直接在hosts.txt文件中编辑。文件路径通常位于I2P安装目录下的 addressbook 目录内。其格式与系统hosts文件类似：
# 格式：Base64目标地址 域名 # 手动添加示例 xxxxx~yyyyy~zzzzzBase64DestinationHereAAAA= forum.i2p xxxxx~yyyyy~zzzzzBase64DestinationHereBBBB= tracker.i2p
关于outproxy的设置，进入“Hidden Services Manager”或“i2ptunnel”管理页面，找到“HTTP client”隧道（即I2P Proxy），在其配置中有一个“Outproxies”字段，默认通常已经填入了公共出站代理的.i2p地址。当你访问普通http网站时，流量会经由此代理出去，由它代替你完成传统DNS解析和访问。如果留空，则I2P代理只能访问.i2p站点，无法访问明网。
三、I2PD轻量实现的DNS相关配置
I2PD是C++实现的轻量版I2P路由，配置方式以文本文件为主，主配置文件通常位于 /etc/i2pd/i2p.conf 或程序目录下的 i2pd.conf。它对DNS的处理同样基于地址簿，但配置粒度更细。
I2PD的HTTP代理和SOCKS代理配置示例如下：
[httpproxy] ## HTTP代理监听地址与端口 address = 127.0.0.1 port = 4444 ## 出站代理，留空则只能访问.i2p站点 outproxy = xxxx.i2p ## 是否允许通过地址簿解析 addresshelper = true [socksproxy] address = 127.0.0.1 port = 4455 outproxy.enabled = true outproxy = xxxx.i2p
其中addresshelper选项值得注意。开启后，当本地地址簿找不到某个.i2p域名时，浏览器会通过跳转到地址助手服务（address helper）来获取目标地址，这是I2P网络中的一种“按需解析”机制，相当于一次临时DNS查询。出于隐私考虑，也可以关闭该功能，只依赖本地地址簿。
地址簿订阅在I2PD中通过subscriptions.txt文件配置，每行填写一个订阅源URL，I2PD会定期拉取并合并到本地地址库。需要注意的是，订阅源本身泄露了你的访问偏好给订阅服务器，建议只使用信誉较好的公共订阅。
四、浏览器端设置与常见问题排查
客户端这边，只需将浏览器的代理指向I2P的HTTP代理即可。以127.0.0.1:4444为例，在浏览器代理设置中填入HTTP代理地址127.0.0.1、端口4444。不要在系统层面设置DNS服务器为任何.i2p相关的地址，因为.i2p解析发生在I2P代理内部，系统DNS不参与这一过程。
常见的“Website not found in addressbook”错误，本质是本地地址簿中没有该域名的映射，且地址助手查询失败。解决办法是：确认订阅源正常工作、等待地址簿自动更新，或手动从可信渠道获取该站点的Base64地址后添加到地址簿。
如果访问.i2p站点一直超时，可以从以下几点排查：一是路由状态，检查控制台中“Shared Clients”隧道是否处于READY状态，隧道未建立时任何解析和访问都不会成功；二是Java堆内存不足导致路由不稳定，可在配置中调大内存；三是浏览器同时开启了其他VPN或代理与I2P冲突。此外，若只想让特定应用走I2P，可以单独配置该应用的SOCKS5代理指向127.0.0.1:4445，避免全局代理带来的干扰。
最后提醒一点：不要尝试把系统DNS改成所谓的“I2P DNS服务器”。I2P没有公共DNS服务器这个概念，任何声称提供此类服务的地址都可能存在中间人风险。正确做法始终是：代理指向I2P路由，解析交给地址簿，明网访问交给outproxy。