TS-WARP(8)

πŸ“¦
version 1.5.11 Β· 2 versions
, in nixpkgs unstable

🌸 NAME 🌸

okay bestie, welcome to the TS-WARP(8) manual page πŸ’– the name is ts-warp β€” a transparent proxy server and traffic wrapper. periodt.

✨ SYNOPSIS ✨

run her like this, no cap:

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

πŸ’… DESCRIPTION πŸ’…

okay so ts-warp is a transparent firewall-based redirector of TCP/IP traffic to SOCKS-proxy servers. iconic behavior ✨ On macOS, FreeBSD, and OpenBSD, ts-warp utilizes PF, and on Linux-based environments it uses Iptables firewall facilities. It supports IPv6 stack, has a simple INI-like configuration file with password obfuscation function, supports SOCK5 authentication methods and SOCKS proxy chains. lowkey a whole queen πŸ‘‘

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. iykyk πŸ’…

πŸŽ€ 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. very main character signal handling tbh πŸ’€βœ¨

🌈 SEE ALSO 🌈

go give these a read bestie 🫢


mwah πŸ’‹ this page is from version 1.0, dated June 6, 2022, by Mikhail Zakharov β€” bye bestie πŸŽ€πŸ’–

πŸ“¦ where this page comes from
  • nixpkgs unstable: ts-warp 1.5.11
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms