NetDetour for macOS - CLI Edition

NetDetour for macOS provides the full core functionality of the Windows version. It allows you to route application network connections through proxy servers according to configurable rules, with support for proxy chains and SSH tunnels.

The macOS Command Line Edition has no graphical user interface for configuring or monitoring NetDetour. Configuration, status queries, connection monitoring, and other operations are performed using the ndtadmin command-line tool.

The CLI Edition is intended primarily for advanced users and system administrators who are comfortable working in Terminal. However, you can also create configuration files for macOS using the Windows version of NetDetour and apply them on macOS.

ndtadmin

Download NetDetour for macOS

Installation

  1. Download and open the DMG disk image.
  2. In the window that opens, drag the NetDetour application to the /Applications shortcut.
  3. Once copying is complete, launch /Applications/NetDetour.app to complete the setup. NetDetour will detect that setup is incomplete and display instructions. Follow the instructions to finish setup.
  4. After setup is complete, open Terminal and use the installed ndtadmin command-line tool to configure and control NetDetour. See the command-line tool documentation below for available operations.

The ndtadmin command-line tool is used to configure and control NetDetour and retrieve its status and diagnostic information.

Its operations include:

  • Enabling or disabling NetDetour.
  • Applying proxifying settings from an XML-based .npsx configuration file.
  • Querying NetDetour status and configuration options.
  • Listing active proxied connections and SSH tunnels.
  • Retrieving and clearing error log entries.
  • Viewing and resetting connection and traffic counters.

Run ndtadmin from Terminal to view its command-line syntax and available options.

The macOS version of npsxutil provides useful tools for working with .npsx configuration files, along with the NPSX XML format specification. Alternatively, you can use the GUI in NetDetour for Windows v1.16 or later to create configurations for macOS; this version supports Unix-style file paths.


The separate npsxutil command-line utility can perform operations on .npsx files, including:

  • Encrypting proxy authentication credentials, including passwords and authentication keys.
  • Importing SSH authentication keys from OpenSSH private-key files.
  • Importing SSH host keys from OpenSSH public-key files.

The package also includes the NPSX XML format specification and a sample configuration file.

Download npsxutil for macOS

Frequently asked questions