NAME

TS-Warp - Transparent proxy server and traffic wrapper

SYNOPSIS

ts-warp [ -i IP:Port -c file.ini -l file.log -v 0-4 -d -p file.pid -f -u user -h ]

DESCRIPTION

ts-warp is a transparent firewall-based redirector of TCP/IP traffic to SOCKS-proxy servers. For macOS, FreeBSD and OpenBSD ts-warp utilizes PF and for Linux based environments Iptables firewal facilities. ts-warp supports IPv6 stack, has a simple INI-like configuration file with password obfuscation function, supports SOCK5 authentication methods and SOCKS proxy chains.

Sample PF and nftables/iptables configuration files for ts-warp can be found in ts-warp_pf_<OSNAME>.conf and ts-warp_nftables.sh or ts-warp_iptables.sh respectively.

Example of the INI-file can be found in ts-warp.ini.

Typically ts-warp, as well as firewall, are controlled using ts-warp.sh script, but they also can be managed manually. In this case, see the OPTIONS and NOTES sections below, check pfctl(8) or 0t(8), iptables(8) for the firewall control operations.

OPTIONS

The options are as follows:

-i IP:Port

Incoming local IP address and port

-c file.ini

Configuration file

-l file.log

Log filename. If ts-warp runs in foreground, the default log is STDOUT.

-v 0..4

Log verbosity level: 0 - off, default 3

-d

Daemon mode

-p file.pid

PID filename

-f

Force start

-u user

A user to run ts-warp. On macOS this has no effect, ts-warp runs alwas as root.

-h

A short help message

NOTES

ts-warp understands SIGHUP signal as command to reload configuration and SIGINT to stop the daemon.

SEE ALSO

ts-warp.ini(5), ts-warp.sh(1), ts-pass(1), gui-warp.py(1)