From 331edbacff9860c1cf282f8cd39b33a47524b8f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E4=B8=96=E7=95=8C?= <i@sekai.icu>
Date: Mon, 24 Feb 2025 18:17:11 +0800
Subject: [PATCH] documentation: Fix missing hosts DNS server

---
 dns/transport/hosts/hosts.go           |  4 +-
 docs/configuration/dns/server/hosts.md | 70 ++++++++++++++++++++++++++
 mkdocs.yml                             |  1 +
 3 files changed, 74 insertions(+), 1 deletion(-)
 create mode 100644 docs/configuration/dns/server/hosts.md

diff --git a/dns/transport/hosts/hosts.go b/dns/transport/hosts/hosts.go
index 29f6778a..773a1d2a 100644
--- a/dns/transport/hosts/hosts.go
+++ b/dns/transport/hosts/hosts.go
@@ -2,12 +2,14 @@ package hosts
 
 import (
 	"context"
+	"os"
 
 	"github.com/sagernet/sing-box/adapter"
 	C "github.com/sagernet/sing-box/constant"
 	"github.com/sagernet/sing-box/dns"
 	"github.com/sagernet/sing-box/log"
 	"github.com/sagernet/sing-box/option"
+	"github.com/sagernet/sing/service/filemanager"
 
 	mDNS "github.com/miekg/dns"
 )
@@ -29,7 +31,7 @@ func NewTransport(ctx context.Context, logger log.ContextLogger, tag string, opt
 		files = append(files, NewFile(DefaultPath))
 	} else {
 		for _, path := range options.Path {
-			files = append(files, NewFile(path))
+			files = append(files, NewFile(filemanager.BasePath(ctx, os.ExpandEnv(path))))
 		}
 	}
 	return &Transport{
diff --git a/docs/configuration/dns/server/hosts.md b/docs/configuration/dns/server/hosts.md
new file mode 100644
index 00000000..25c490ed
--- /dev/null
+++ b/docs/configuration/dns/server/hosts.md
@@ -0,0 +1,70 @@
+---
+icon: material/new-box
+---
+
+!!! question "Since sing-box 1.12.0"
+
+# Hosts
+
+### Structure
+
+```json
+{
+  "dns": {
+    "servers": [
+      {
+        "type": "hosts",
+        "tag": "",
+
+        "path": [],
+        "predefined": {}
+      }
+    ]
+  }
+}
+```
+
+!!! note ""
+
+    You can ignore the JSON Array [] tag when the content is only one item
+
+### Fields
+
+#### path
+
+List of paths to hosts files.
+
+`/etc/hosts` is used by default.
+
+`C:\Windows\System32\Drivers\etc\hosts` is used by default on Windows.
+
+Example:
+
+```json
+{
+  // "path": "/etc/hosts"
+  
+  "path": [
+    "/etc/hosts",
+    "$HOME/.hosts"
+  ]
+}
+```
+
+#### predefined
+
+Predefined hosts.
+
+Example:
+
+```json
+{
+  "predefined": {
+    "www.google.com": "127.0.0.1",
+    "localhost": [
+      "127.0.0.1",
+      "::1"
+    ]
+  }
+}
+```
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index f786ac84..1aaee8b1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -84,6 +84,7 @@ nav:
               - configuration/dns/server/index.md
               - Legacy: configuration/dns/server/legacy.md
               - Local: configuration/dns/server/local.md
+              - Hosts: configuration/dns/server/hosts.md
               - TCP: configuration/dns/server/tcp.md
               - UDP: configuration/dns/server/udp.md
               - TLS: configuration/dns/server/tls.md