sing-box/docs/configuration/dns/server/hosts.zh.md

icon

icon
material/new-box

!!! question "自 sing-box 1.12.0 起"

Hosts

结构

{
  "dns": {
    "servers": [
      {
        "type": "hosts",
        "tag": "",

        "path": [],
        "predefined": {}
      }
    ]
  }
}

!!! note ""

当内容只有一项时，可以忽略 JSON 数组 [] 标签

字段

path

hosts 文件路径列表。

默认使用 /etc/hosts。

在 Windows 上默认使用 C:\Windows\System32\Drivers\etc\hosts。

示例：

{
  // "path": "/etc/hosts"

  "path": [
    "/etc/hosts",
    "$HOME/.hosts"
  ]
}

predefined

预定义的 hosts。

示例：

{
  "predefined": {
    "www.google.com": "127.0.0.1",
    "localhost": [
      "127.0.0.1",
      "::1"
    ]
  }
}

示例

=== "如果可用则使用 hosts"

=== ":material-card-multiple: sing-box 1.14.0"

    ```json
    {
      "dns": {
        "servers": [
          {
            ...
          },
          {
            "type": "hosts",
            "tag": "hosts"
          }
        ],
        "rules": [
          {
            "action": "evaluate",
            "server": "hosts"
          },
          {
            "match_response": true,
            "ip_accept_any": true,
            "action": "respond"
          }
        ]
      }
    }
    ```

=== ":material-card-remove: sing-box < 1.14.0"

    ```json
    {
      "dns": {
        "servers": [
          {
            ...
          },
          {
            "type": "hosts",
            "tag": "hosts"
          }
        ],
        "rules": [
          {
            "ip_accept_any": true,
            "server": "hosts"
          }
        ]
      }
    }
    ```