config: add basic and server configuration guide.

This commit is contained in:
Nick Peng
2023-03-15 23:13:44 +08:00
parent 6e6c6af0c9
commit b388ca1504
5 changed files with 116 additions and 11 deletions

View File

@@ -0,0 +1,28 @@
---
hide:
- toc
---
# 基础配置
smartdns配置选项功能比较丰富但作为最基本的DNS服务只需要配置服务端口号和上游服务器即可其他参数默认情况下对于家庭本地网络已经是最佳配置。
## 配置样例
在smartdns.conf配置文件中包含配置如下即可提供服务并对DNS查询加速
```shell
# 监听53端口
bind [::]:53
# 配置上游服务器
server 8.8.8.8
server 114.114.114.114
server 202.96.128.166:53
server-tls 1.1.1.1
```
选项中:
* bind表示开启服务端并监听对应的端口`:53`表示绑定IPV4的53端口`[::]:53`表示绑定IPV6的53端口后者在大部分系统中同时也绑定了IPV4端口。
* server表示上游服务器IP地址端口可以省略。如需要安全访问上游可以使用server-tls, server-https。也可以使用URI方式如server tls://1.1.1.1:853
* server不指定的情况下将会自动读取`/etc/resolv.conf`文件中的系统DNS地址。

View File

@@ -3,7 +3,7 @@ hide:
- toc
---
# 名单分流请求
# 名单分流请求
## 分流流程

View File

@@ -0,0 +1,75 @@
---
hide:
- toc
---
# 服务端配置
smartdns目前提供了UDP, TCP, DOT三种服务端模式。
## UDP服务端
1. 通过`bind`参数配置,配置例子如下:
```shell
bind 0.0.0.0:53@eth0
bind [::]:53@eth0
bind :53@eth0
```
选项中:
* @eth0表示仅在对应的网口上提供服务。
* [::]:53 表示监听IPV6和IPV4地址。
* :53表示监听IPV4地址
## TCP服务端
1. 通过`bind-tcp`参数配置,配置例子如下:
```shell
bind-tcp 0.0.0.0:53@eth0
bind-tcp [::]:53@eth0
bind-tcp :53@eth0
```
1. 可选参数tcp-idle-time控制TCP空闲断链时间
```shell
tcp-idle-time 120
```
## DOT服务端
1. 通过`bind-tcp`参数配置,配置例子如下:
```shell
bind-tcp 0.0.0.0:53@eth0
bind-tcp [::]:53@eth0
bind-tcp :53@eth0
```
1. 设置证书和密钥文件
```shell
bind-cert-file smartdns-cert.pem
bind-cert-key-file smartdns-key.pem
bind-cert-key-pass pass
```
选项中:
* bind-cert-file: 表示证书文件路径。
* bind-cert-key-file表示证书密钥文件路径。
* bind-cert-key-pass 表示证书密钥文件密码,可选。
注意:
上述三个参数如果不指定的情况下smartdns将会自动在/etc/smartdns目录自动生成自签名证书`smartdns-cert.pem`和`smartdns-key.pem` key文件CN为smartdns。
1. 可选参数tcp-idle-time控制TCP空闲断链时间
```shell
tcp-idle-time 120
```