mirror of
https://github.com/SagerNet/sing-box.git
synced 2025-04-04 04:17:36 +03:00
96 lines
No EOL
1.1 KiB
Markdown
96 lines
No EOL
1.1 KiB
Markdown
---
|
|
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"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
### Examples
|
|
|
|
=== "Use hosts if available"
|
|
|
|
```json
|
|
{
|
|
"dns": {
|
|
"servers": [
|
|
{
|
|
...
|
|
},
|
|
{
|
|
"type": "hosts",
|
|
"tag": "hosts"
|
|
}
|
|
],
|
|
"rules": [
|
|
{
|
|
"ip_accept_any": true,
|
|
"server": "hosts"
|
|
}
|
|
]
|
|
}
|
|
}
|
|
``` |