naiveproxy/USAGE.txt

81 lines
2.5 KiB
Plaintext
Raw Normal View History

2019-01-14 11:24:16 +03:00
Usage: naive { OPTIONS | [/path/to/config.json] }
Description:
naive is a proxy to transport traffic as Chromium traffic. It can be
used as both the client and the server or together.
There are two ways to specify options. The first is through command
line flags: naive OPTIONS. The second is through a JSON
configuration file. If there are no command line flags or path
specified, it will try to read from "config.json" by default.
The syntax of config.json fields are mapped exactly to command line
flags, e.g.
{
"proxy": "https://user:pass@example.org"
}
is exactly the same as --proxy=https://user:pass@example.org. All
command line flags must have string values in config.json, except if
the flags are boolean then they must have boolean values too.
Options:
-h, --help
Shows help message.
--version
Prints version
--listen=<proto>://[addr][:port]
Listens at addr:port with protocol <proto>. Allowed values for
2019-09-28 16:33:33 +03:00
proto: "socks", "http", "redir". The default proto is socks.
The default addr is 0.0.0.0. The default port is 1080.
For redirecting local traffic from the same machine:
iptables -t nat -A OUTPUT -p tcp -d ... -j REDIRECT --to-ports 1080
For redirecting forwarded traffic on a router:
iptables -t nat -A PREROUTING -p tcp -d ... -j REDIRECT --to-ports 1080
2019-01-14 11:24:16 +03:00
--proxy=<proto>://[<user>:<pass>@]<hostname>[:<port>]
Routes traffic via the proxy server. Allowed values for proto:
"https", "quic". The value of port is inferred from proto if not
specified. If hostname is an IP address, an internal host
resolver rule is setup to resolve "example" to it to make TLS
certificate validation work.
If this option is not set, connects to origin server directly.
--padding
Obfuscates traffic by adding length paddings.
--host-resolver-rules=...
This is the same as Chromium's flag of the same name. Google it
as the full description is too technical.
--log=[<path>]
Saves log to the file at <path>. If <path> is empty, prints to
console.
If this option is not set, no log is saved for privacy.
--log-net-log=<path>
Saves NetLog. View at https://netlog-viewer.appspot.com/.
--ssl-key-log-file=<path>
Saves SSL keys for Wireshark inspection.