Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Pseudo DNS server


moufoDNS is a tiny pseudo DNS server that can be easily configured to return only a certain IP address no matter what. This is useful for setting up a hotspot-like environment with minimal configuration and minimal software support. It can also act as a DNS proxy, by asking other DNS servers for certain requests. It is fully configurable by command line options or by a configuration file

** This is NOT an industrial-strength tool and should not be used as such ***


To set up your hotspot-like environment you need 3 things:

  1. A web server running on an IP address, hosting the hotstpot web page. For our example this web server will be on
  2. moufodns running on a pc, configured to return by default the IP address of the web server. That is The moufodns and web server could also be on the same pc, but in our example moufodns runs on
  3. Your Access Point's dhcp server must be configured so that the DNS server it distributes is the moufodns pc's IP. In our example it is

Here is how it works: So when a wireless client asks the AP dhcp server for a DNS server, the AP returns which is the IP of the moufo-dns server. From that point on, the client is on the pseudo-hotspot. If the client tries to open any website on its browser, the DNS request will go through moufodns. Lets say client asks for http://www.alpha.beta. Moufodns will return and therefore the browser will open the Hotspot web page instead of the real www.alpha.beta.

The reason we call the whole setup as a "pseudo"-hotspot is because the client is free to access the local network without any authentication required. Real hotspots can be configured to block access to the network. But there are situations where such authentication is not required and in fact is not wanted. For example in the wireless community context it makes no sense to block access to the free network at the hotspot level.

        WiFi         |

client - - - - -> AP -| IP : 10.140.X.Y |-Web Server DNS: | |-MoufoDNS Server |

  1. client connects to AP
  2. AP dhcp server assigns it IP: 10.140.X.Y and DNS:
  3. Now client has access to the full network.
  4. client asks for on a web browser
  5. MoufoDNS ( replies that is @
  6. client is fooled to think that is in
  7. client opens the pseudo-hotspot web page from


o Configurable behavior by command line arguments and config file. o Verbose output, prints all details of each DNS request received by the moufoDNS server, including date and time. o Supports dumping to log file which can be later parsed for statistics. o Filtering of the output that goes to the log file by blac/white lists.


DNS requests -> |Moufo DNS| -> stdout +---------+ | filters -> log file


Pseudo DNS server







No releases published


No packages published