https://github.com/savelevmatthew/cachingdns
Simple local DNS cache server written in Python
https://github.com/savelevmatthew/cachingdns
cache dns-server pet-project university-project
Last synced: about 1 year ago
JSON representation
Simple local DNS cache server written in Python
- Host: GitHub
- URL: https://github.com/savelevmatthew/cachingdns
- Owner: SavelevMatthew
- Created: 2020-05-28T09:24:22.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-15T09:45:15.000Z (over 5 years ago)
- Last Synced: 2025-02-14T10:44:14.659Z (over 1 year ago)
- Topics: cache, dns-server, pet-project, university-project
- Language: Python
- Homepage:
- Size: 43 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
> This utility realise Redirecting DNS Server with Cache function, so when DNS request incomes, it will look for answers in cache first and then if nothing was found will ask for help parent DNS server
## Table of Contents
[Installation](#installation)\
[Configuration](#configuration)\
[Launching](#launching)\
[Usage Examples](#usage-examples)\
[Current State](#current-status)\
[Author](#author)
## Installation
Download project to your machine.
Then use the package manager [pip](https://pip.pypa.io/en/stable/) to install the following packages.
```bash
pip install -r requirements.txt
```
## Configuration
Open **config.ini** file to set up, then change following setting if you want:
**ip** - IP of your server, leave it 127.0.0.1 if you want to use localhost
**port** - don't recommend to change it, since DNS requests are usually use 53th port to communicate
**max_packet_size** - maximal size of a packet, which can be received (RFC says max is 512 bytes, so we dont recommend setting up less amount)
**parent_dns** - IP of parent DNS (8.8.8.8 by default, which is Google Developer's DNS)
**cache_filename** - Name of the file, where all cache information will be stored
## Launching
#### Mac OS / Linux
```bash
sudo python main.py
```
Make sure you run it in sudo, since running server on a port, which are less than 80, requires your permissions
#### Windows
**Run cmd as ADMINISTRATOR**
```bash
python main.py
```
## Usage Examples
Use whatever utility you want to send DNS requests...Here is few "in-box" examples
#### Mac OS / Linux
```bash
dig example.com @127.0.0.1
```
#### Windows
```bash
nslookup example.com 127.0.0.1
```
## Current Status
Project development is finished. It works stable ang great ;)
## Author
### Savelev Matvey
> #### Github: [@SavelevMatthew](https://github.com/SavelevMatthew)
> ##### Email: savelevmatthew@gmail.com