Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jjeffcaii/zerodns
A DNS server in Rust.
https://github.com/jjeffcaii/zerodns
chinadns chinadns-ng dns dns-server dnsmasq rust rust-lang
Last synced: about 14 hours ago
JSON representation
A DNS server in Rust.
- Host: GitHub
- URL: https://github.com/jjeffcaii/zerodns
- Owner: jjeffcaii
- License: mit
- Created: 2024-02-07T03:02:06.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-03-03T08:34:35.000Z (8 months ago)
- Last Synced: 2024-08-10T06:59:20.360Z (3 months ago)
- Topics: chinadns, chinadns-ng, dns, dns-server, dnsmasq, rust, rust-lang
- Language: Rust
- Homepage:
- Size: 178 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ZeroDNS
[](https://app.codecov.io/gh/jjeffcaii/zerodns)
[](https://crates.io/crates/zerodns)
[](https://crates.io/crates/zerodns)
a DNS server in Rust, which is inspired from chinadns/dnsmasq.
> :construction_worker: WARNING: still in an active development!!!
## Goals
- multiple protocols: UDP/TCP/DoT/DoT/DNSCrypt
- user-defined filters, includes lua or native rust codes
## Quick Start
> Notice: ensure you have [just](https://github.com/casey/just) installed on your machine!
run an example:
```shell
$ just r
$ dig @127.0.0.1 -p5454 www.youtube.com
```
## Configuration
Here's an example configuration file:
```toml
# The settings of server
[server]
# will listen on tcp+udp
listen = "0.0.0.0:5454"
# use LRU cache with 1000 capacity
cache_size = 1000
##### FILTERS BEGIN #####
# alidns over udp
[filters.alidns]
kind = "proxyby"
props = { servers = ["223.5.5.5", "223.6.6.6"] }
# opendns over tcp
[filters.opendns]
kind = "proxyby"
props = { servers = ["tcp://208.67.222.222:443", "tcp://208.67.220.220:443"] }
# a chinadns filter:
# - use trusted dns servers for oversea domain
# - use mistrusted dns servers for Chinese domain
# NOTICE: require 'geoip_database', you can download from https://git.io/GeoLite2-Country.mmdb
[filters.chinadns]
kind = "chinadns"
props = { trusted = ["tcp://208.67.222.222:443", "tcp://208.67.220.220:443"], mistrusted = ["223.5.5.5", "223.6.6.6"], geoip_database = "GeoLite2-Country.mmdb" }
# a lua filter example which show how to resolve addr by lua, see src/filter/lua.rs for more infomation.
[filters.lua]
kind = "lua"
props.script = """
-- The filter entrance:
function handle(ctx)
-- log something...
for i,v in ipairs(ctx.request:questions()) do
logger:info('---- question#'..i..': '..v.name)
end
-- resolve addr from 223.5.5.5
local resp = resolve(ctx.request,'223.5.5.5')
-- log something...
for i,v in ipairs(resp:answers()) do
logger:info('---- answers#'..i..': name='..v.name..', rdata='..v.rdata)
end
-- answer it!
ctx:answer(resp)
end
"""
##### FILTERS END #####
##### RULES BEGIN #####
# NOTICE:
# - will check rules below one by one
# - the 'domain' field follows the glob syntax
# RULE-1: for those domains of '*.cn', use lua filter
[[rules]]
domain = "*.cn"
filters = ["lua"]
# RULE-2: for those domains of '*apple.com', use alidns filter
[[rules]]
domain = "*.apple.com"
filters = ["alidns"]
# RULE-3: for those domains of '*google*', use opendns filter
[[rules]]
domain = "*google*"
filters = ["opendns"]
# RULE-FINAL: use chinadns for others
[[rules]]
domain = "*"
filters = ["chinadns"]
##### RULES END #####
```