ns

NS-Warp

DNS responder/proxy for TS-Warp

NS-Warp allows to perform remote name resolution via Socks proxy server for transparent TS-Warp initiated connections and solve the issue if a target hostname is not known to a local DNS and you have to connect using an IP-address.

NS-Warp uses an IP subnet to define Name to IP translation Table (NIT), to temporary associate hostnames with IP-addresses from NIT before supplying them to TS-Warp.

Installation

# sudo make install

Install NS-Warp under the default PREFIX=/usr/local

Configuration

• Edit ts-warp.ini to add a NIT-pool and a related target network to a desired section:

  vi /usr/local/etc/ts-warp.ini
  [EXAMPLE]
  # ...
  # socks_server ...
  # target_network ...
  target_network = 192.168.168.0/255.255.255.0
  nit_pool = example.net:192.168.168.0/255.255.255.0
  # ...

  Defining nit_pool and target_network for NS-Warp to work, make sure this subnet is not used for actual connections.

Usage

For macOS: Start TS-Warp using ts-warp.sh to load required PF-anchors.

Start/stop/restart NS-Warp respectively:

# /usr/local/etc/ns-warp.sh start
# /usr/local/etc/ns-warp.sh stop
# /usr/local/etc/ns-warp.sh restart

NS-Warp understands also stop and restart commands

Notes:

• Adding -v 4 option enables more verbose logging, e.g. # /usr/local/etc/ns-warp.sh start -v 4
• Check contents of ns-warp.sh for the firewall rules if you nead to modify them

TO-DO

• Cache DNS records
• Multi- threading/processing and IPC to share NIT records from clients
• Documentation

Contacts

This is a very early development stage, NS-Warp contains bugs, there are many things to implement. If you have an idea, a question, or have found a problem, do not hesitate to open an issue or mail me: Mikhail Zakharov [email protected]