Command line arguments

As WebOne is a console program, it accepts command line arguments.

Syntax

webone [PORT] [CONFIG FILE] [--ARGUMENT 1] [--ARGUMENT 2] ... [--ARGUMENT N]

All arguments are optional.

Arguments

Port selection

webone n, webone -p n , webone --port n, webone --http-port n, - override Port number set in configuration file, and run HTTP Proxy on port "n".

Configuration file selection

webone NAME.EXT - use "NAME.EXT" configuration file instead of default webone.conf (and all files in webone.conf.d or program installation directory). May be used together with other arguments, even with port selection: webone 8888 mysuperconfig.txt.

Log file

webone -l X, webone --log X - write operation log to file "X". Equivalent to LogFile option of configuration file. To disable logging, use webone -l no, webone --log no.

Temporary directory

webone -t X, webone --temp X - specify a directory "X" for temporary files. Equivalent to TemporaryDirectory option of configuration file.

Host name

webone -h X, webone --host X, webone --hostname X - override DefaultHostName setting in configuration file. May be useful with dynamic IP addresses of server and DDNS.

Proxy authentication

webone -a login:password, webone --proxy-authenticate login:password - override or set Authenticate setting in configuration file. This may be used to set a dynamic password for the proxy, created from scripts. If configuration file(s) is (are) containing multiple authorization credentials, all of them will be overriden by single login:password pair set by this argument.

Daemon mode

webone --daemon - don't write log messages to console (STDOUT). This may be used to enlarge perfomance on high load or to prevent flooding in /var/log/syslog file on *nix when using systemd. All log messages will still writing to active log file. But if the log file cannot be opened for write, WebOne will report the error to console and then quit.

Traffic dumping mode

webone --dump, webone --dump my_dump_of_%Url%.txt - save dumps of all HTTP traffic through proxy to file. By default the file name is dump-%Url%.log, but it may be any. Equivalent of AddDumping edit rule.

Rebuild Root Certificate

webone --rebuild-ca - clear existing ssl.crt&ssl.key files and create new Certificate Authority Root Certificate files using options from configuration file. No backup will be saved. After successful rebuild, WebOne will exit, then you may start it normally and use SSL Proxy with new Root Certificate.