Webman-Dns/readme.md

109 lines
2.5 KiB
Markdown
Raw Normal View History

2022-12-18 16:22:56 +05:30
# Webman DNS
Webman的DNS服务器插件可以实现Webman启动时运行一个DNS服务器
请不要用于生产环境。
2022-12-18 16:22:56 +05:30
> 注意默认为udp53端口需要ROOT权限
2022-12-18 16:25:06 +05:30
[Github](https://github.com/ywnsya/webman-dns)
[LaysenseRepo](https://git.laysense.com/enoch/Webman-Dns)
2022-12-18 16:22:56 +05:30
---
## 支持的DNS类型
* A
* AAAA
* CNAME
* SOA
* PTR
* MX
* TXT
最新版本已经增加了CNAME+A和CNAME+AAAA方式
2024-01-31 12:17:58 +05:30
0.1.0版本之后版本号跟随WorkermanDNS,同时支持Flag类型
2022-12-18 16:22:56 +05:30
---
## 安装
在确保已经安装webman后执行
2022-12-18 16:22:56 +05:30
```shell
composer require laysense/dns
```
## 配置
> 配置文件位于 /config/plugin/laysense/dns/process.php
```php
<?php
return [
'Dns' => [
'handler' => process\DnsProcess::class,
'listen' => 'Dns://0.0.0.0:53', #使用的端口,53端口需要root权限
'transport' => 'udp',
'count' => cpu_count() * 4 #线程数量
],
];
```
## 使用
> 为了方便您的使用,本插件(不要脸地)导入了一个Controller
>
> 位于 /app/controller/DnsController.php
>
> 【如果这影响到了您的项目和您的开发习惯,请修改/process/DnsProcess.php 文件】
>
> 安装前请先保障文件不冲突
> 本DNS插件只提供了一个DNS请求和响应的接口其余的数据库、DNS查询、多级缓存、递归等需要您自行实现
该Controller名存实亡其实就是一个class
```php
<?php
namespace app\controller;
include_once base_path().'/vendor/laysense/dns/src/resource/ipv6.php';
use dnstools\ipv6; #用于IPv6相关
/**
* $ipv6=new IPv6;
* $ipv6->ip2bin($ip);
*/
class DnsController
{
public function DNS($type,$name,$rip,$id,$query)
{
#输出信息
#echo "\n Type:$type \n Domain: $name\n Client IP: $rip \n";
#此处请根据业务需要,通过判断$name和$rip返回正确的数据
#详情请参见 https://github.com/ywnsya/workerman-dns 尤其是 https://github.com/ywnsya/Workerman-DNS/blob/master/start.php 中的用法
2022-12-18 16:25:06 +05:30
2022-12-18 16:22:56 +05:30
$send['detail']='dns.laysense.com';
$send['ttl']=30;
$send['type']='PTR';
#此处无需修改
$send['id']=$id;
$send['query']=$query;
$return=json_encode($send);
return $return;
}
}
```
2024-02-06 16:34:45 +05:30
具体的使用方式请参照 [Workerman-DNS](https://git.laysense.com/Laysense/Workerman-DNS/src/branch/master/readme.md) ([Github](https://github.com/ywnsya/workerman-dns)) 下的start.php与readme.md
2022-12-18 16:22:56 +05:30
## 赞助(我不要脸)
![1671360565549](image/readme/1671360565549.png)