diff --git a/docs/config/transports/finalmask.md b/docs/config/transports/finalmask.md
index b9b05022..0ebec4c1 100644
--- a/docs/config/transports/finalmask.md
+++ b/docs/config/transports/finalmask.md
@@ -341,6 +341,29 @@ Salamander 混淆。（来自 Hysteria2）
 
 `ips`: ips
 
+### realm
+
+自建 https://github.com/apernet/hysteria-realm-server
+
+```json
+{
+  "url": "realm://public@xxx/your-realm-name",
+  "stunServers": [
+    "stun.nextcloud.com:3478",
+    "global.stun.twilio.com:3478"
+  ],
+  "tlsConfig": {} // optional
+}
+```
+
+`url`: realm[+http]://token@host[:port]/id
+
+`stunServers`: 多个 ipv4/ipv6 用于进行 NAT 端口预测
+
+`tlsConfig`: 同 tlsSettings
+
+连接不通需要 debug 级别日志，可能的影响因素有 stun提供商 realm提供商 punch包影响了quic握手（极小概率）
+
 ## quicParams
 
 ```json
diff --git a/docs/en/config/transports/finalmask.md b/docs/en/config/transports/finalmask.md
index 1d8e9927..8b8f6921 100644
--- a/docs/en/config/transports/finalmask.md
+++ b/docs/en/config/transports/finalmask.md
@@ -341,6 +341,29 @@ At least one of `domains` and `resolvers` must be set.
 
 `ips`: ips
 
+### realm
+
+Self-built https://github.com/apernet/hysteria-realm-server
+
+```json
+{
+  "url": "realm://public@xxx/your-realm-name",
+  "stunServers": [
+    "stun.nextcloud.com:3478",
+    "global.stun.twilio.com:3478"
+  ],
+  "tlsConfig": {} // optional
+}
+```
+
+`url`: realm[+http]://token@host[:port]/id
+
+`stunServers`: Multiple IPv4/IPv6 addresses are used for NAT port prediction
+
+`tlsConfig`: Same as tlsSettings
+
+Connection failures require debug-level logging. Possible contributing factors include the STUN provider, the Realm provider, and punch packets affecting the QUIC handshake (extremely low probability)
+
 ## quicParams
 
 ```json
diff --git a/docs/ru/config/transports/finalmask.md b/docs/ru/config/transports/finalmask.md
index c00ec2a3..68b6467a 100644
--- a/docs/ru/config/transports/finalmask.md
+++ b/docs/ru/config/transports/finalmask.md
@@ -341,6 +341,29 @@ FinalMask добавляет последний слой маскировки п
 
 `ips`: ips
 
+### realm
+
+Самодельный https://github.com/apernet/hysteria-realm-server
+
+```json
+{
+  "url": "realm://public@xxx/your-realm-name",
+  "stunServers": [
+    "stun.nextcloud.com:3478",
+    "global.stun.twilio.com:3478"
+  ],
+  "tlsConfig": {} // optional
+}
+```
+
+`url`: realm[+http]://token@host[:port]/id
+
+`stunServers`: Для предсказания портов NAT используется несколько адресов IPv4/IPv6
+
+`tlsConfig`: То же, что tlsSettings
+
+Для регистрации сбоев соединения требуется уровень отладки. К возможным факторам, способствующим возникновению проблем, относятся поставщик STUN, поставщик Realm и пакеты данных, влияющие на рукопожатие QUIC (вероятность крайне низка)
+
 ## quicParams
 
 ```json