From 73092accac80cd69bfbf7e9957b9bc8f190c1773 Mon Sep 17 00:00:00 2001
From: Meow <197331664+Meo597@users.noreply.github.com>
Date: Fri, 12 Dec 2025 19:58:01 +0800
Subject: [PATCH] Explaining the impact of domainStrategy on happyEyeballs
 (#778)

---
 docs/config/transport.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/docs/config/transport.md b/docs/config/transport.md
index 59974381..307e5c5e 100644
--- a/docs/config/transport.md
+++ b/docs/config/transport.md
@@ -870,14 +870,18 @@ PS: 如果有正常上网的域名流量被 AsIs 的 freedom 出站送过来，
 
 当 type 指定为 int 时需要使用十进制数字。
 
-> `happyEyeballs`: map
+> `happyEyeballs`: [HappyEyeballsObject](#happyeyeballsobject)
 
-RFC-8305 实现的 happyEyeballs 仅适用于 TCP, 当目标为域名时对它们竞速并选择第一个成功的返回，当 `domainStrategy` 被设置为 `UseIP`/`ForceIP` (包括它们的v4/v6/v4v6版本，但这会使可用的IP列表被缩减到仅剩v4或v6，不推荐这么用)
+RFC-8305 实现的 happyEyeballs，仅适用于 TCP。当目标为域名时对它们竞速并选择第一个成功的返回，仅当 `Sockopt.domainStrategy` 被设置为非 `AsIs` 时生效。
+
+注意：`UseIPv4v6` / `ForceIPv4v6` 会使可用的 IP 列表被缩减到仅剩 IPv4，仅查询失败时才会回退查询 IPv6。不推荐这么用。建议使用 UseIP / ForceIP 配合 `HappyEyeballs.interleave`。
 
 ::: warning
 使用这个功能时不要使用 `Freedom` 出站的 `domainStrategy`, 这会导致 `Sockopt` 只能看到被替换完毕的 IP.
 :::
 
+#### HappyEyeballsObject
+
 ```json
 "happyEyeballs": {
     "tryDelayMs": 250,