DragonFly On-Line Manual Pages

Search: Section:  

MEEK-CLIENT(1)                                                  MEEK-CLIENT(1)


NAME

       meek-client - The meek client transport plugin


SYNOPSIS

       meek-client [OPTIONS]


DESCRIPTION

       meek-client is a transport plugin for Tor that encodes a stream as a
       sequence of HTTP requests and responses. It is usually run with the
       --url and --front options. The --url option controls what URL requests
       are made to; the web server at that URL should be configured to forward
       requests to a meek-server somewhere. The --front option is for domain
       name camouflage: The domain name in the URL is replaced by the front
       domain before the request is made, but the Host header inside the HTTP
       request still points to the original domain. The idea is to front
       through a domain that is not blocked to a domain that is blocked.

       Configuration for meek-client usually appears in a torrc file. Most
       user configuration can happen either through SOCKS args (i.e., args on
       a Bridge line) or through command line options. SOCKS args take
       precedence per-connection over command line options. For example, this
       configuration using SOCKS args:

           Bridge meek 0.0.2.0:1 url=https://meek-reflect.appspot.com/ front=www.google.com
           ClientTransportPlugin meek exec ./meek-client

       is the same as this one using command line options:

           Bridge meek 0.0.2.0:1
           ClientTransportPlugin meek exec ./meek-client --url=https://meek-reflect.appspot.com/ --front=www.google.com

       The advantage of SOCKS args is that multiple Bridge lines can have
       different configurations.

       The --helper option prevents meek-client from doing any network
       operations itself. Rather, it will send all requests through a browser
       extension, which must be set up separately.

       You can also control an upstream proxy using torrc options:

           HTTPSProxy localhost:8080
           Socks4Proxy localhost:1080
           Socks5Proxy localhost:1080

       or, equivalently, using the --proxy command-line option.

       When the --helper option is used, you can use any type of proxy: HTTP
       or SOCKS. Without --helper, you can only use an HTTP proxy.


OPTIONS

       --front=DOMAIN
           Front domain name. The front SOCKS arg overrides the command line.

       --helper=ADDRESS
           Address of HTTP helper browser extension. For example, --helper
           127.0.0.1:7000.

       --proxy=URL
           URL of upstream proxy. For example, --proxy=http://localhost:8080/,
           --proxy=socks4a://localhost:1080, or
           --proxy=socks5://localhost:1080. You would normally control the
           proxy using the HTTPSProxy, Socks4Proxy, or Socks5Proxy
           configuration options in a torrc file, instead of using this
           option.

       --log=FILENAME
           Name of a file to write log messages to (default stderr).

       --url=URL
           URL to correspond with. The domain part of the URL may be modified
           by --front.

       -h, --help
           Display a help message and exit.


SEE ALSO

       https://trac.torproject.org/projects/tor/wiki/doc/meek


BUGS

       Please report at https://trac.torproject.org/projects/tor.

                                  10/25/2014                    MEEK-CLIENT(1)

Search: Section: