From JonDonym Wiki
Revision as of 13:05, 24 July 2011 by AnonymousTerrorist (Talk | contribs)
Jump to: navigation, search

En2.png De2.png  Main Page | JonDo Console Software Collection


JonDoConsole for Windows, Linux and MaxOS

JonDoConsole is a Java application. You have to install a Java Runtime Environment (JRE) first. Because no GUI functions are used, you can install a headless version of the JRE:

  • For Windows you may download Java from website
  • For Linux/UNIX, you may install the package sun-java6-jre or openjdk-6-jre-headless with the package manager of your distribution.
  • MacOS contains a Java Runtime Environment by default installation.

Installation of JonDoConsole

Simply download JonDoConsole.jar (2011-03-12, 6.3 MB, Signature) and save it to your hard disk.

JonDoConsole command line options

You can start the console client JonDoConsole at the command line. Add the full path if required.

> java -jar JonDoConsole.jar [Options]

Currently implemented options are the following ones:

  • -c,--configuration <arg>: A custom file path to the configuration file. Its default name is '.jondoconsole.conf'.
  • -s,--sqliteCache <arg>: Sets an arbitrary file path as sqlite cache database for InfoService data. 'cache.sqlite' is recommended as file name. This will speed up startup but will take some mega bytes of disk space.
  • -t,--daemonAuthentication: Sets the authentication password for the daemon. It will be stored in the configuration. The daemon won't start without a password in its configuration. Stop the daemon before resetting the password!
  • -d,--daemon <arg>: Start as daemon server process at [host]{:port}. Default host is localhost. You may access the daemon via telnet or using the built-in client interface, option -i,--clientInterface (recommended).
  • -i,--clientInterface <arg>: Starts as client interface and try to connect to a daemon running at [host]{:port}. Default host is localhost.
  • -defaultService <arg>: {hostname}{:port} of the default service. This is for testing purposes only (no certificate verification is done for this service in the automatically chosen filter!).
  • -f,--forwarder <[port]>: Activates the anti-censorship forwarding server to help other people connecting to JonDonym. You may enter a [port] (if you don't, a random port is chosen) on which the server should listen. If you do not have root/admin privileges, you might need to choose a port higher than 1024.
  • -h,--help: Prints this message.
  • -l,--logFile <arg>: The path to a file where the log messages are stored. Only the log level ALERT will then be visible on the console. 'jondoconsole.log' is recommended as file name.
  • -m,--multiple: Allow multiple instances of JonDoConsole.
  • -n,--networkInterface <arg>: The network interface [hostname][:port] where the local JonDo proxy should listen on. You may enter either host name or port, or both. Enter ALL_HOSTS for the host name if you want to listen on all interfaces. Default is localhost:4001.
  • -noConfiguration: Do not use any configuration. Warning: Accounts will not be stored. Use this for testing purposes only!
  • -noJonDonymProxy: Does not start the JonDonym proxy. Only usable together with the -f,--forwarder option.
  • -p,--proxy <arg>: {hostname}{:port}[s] of the compulsory proxy that you have to use. Add 's' to the port for specifying the proxy as SOCKS. Default is HTTP.
  • -a,--proxyAuthentication <arg>: {username}[:password] of the compulsory proxy if any is defined. You may leave out the password if you would like to enter it in a hidden console on startup.
  • --defaultNoInfoServiceUpdate: When creating a new configuration, do not automatically update InfoService data by default. This option has no effect if a configuration already exists.
  • --defaultNoAccountUpdate: When creating a new configuration, do not automatically update account data by default. This option has no effect if a configuration already exists.
  • -v,--version: Prints the program version.

During the first start a configuration file will be created: $HOME/.jondoconsole.conf.

JonDoConsole commands

To get all the possible commands at the JonDoConsole command promt type help just after you started the client successfully and any time later. You will have the following options to control the behavior from within the client:

  • help: Shows all the commands you may use to configure JonDoConsole after you have started it.
  • exit or quit: Closes JonDoConsole and saves the configuration.
  • status: Gives you some details about the current cascade and the balance you have (if you surfing via a premium cascade).
  • info: Prints detailed information about available services and their operators.
  • choose: Offers you some cascades to choose; if you have a valid account the premium cascades otherwise the free ones.
  • switch: Typing this you may switch to another cascade.
  • start: Connects to a mix cascade.
  • stop: Disconnects from a mix cascade.
  • reload: Use this command to obtain the latest InfoService information.
  • reloadPay: Use this command to update the balances of your JonDonym accounts.
  • autoReload: Enable/disable automatic updates of InfoService information.
  • autoReloadPay: Enable/disable automatic updates of JonDonym account balances.
  • blacklist: Allows you to disable/enable the usage of one or more mixes.
  • filter: Lets you choose between different configurations for filtering the mixes you want to use.
  • http: Enables/disables the JonDo HTTP-Filter.
  • autoswitch: Enables/disables the option to let JonDoConsole switch between mix cascades automatically.
  • pi: Offers you different payment instances to choose.
  • create: Allows you to create an account using the 'coupon' option.
  • coupon: Allows you to enter a coupon code and thus use the premium services.
  • import: You may import an account.
  • export: You may export an account.
  • delete: You may delete an account.
  • password: You may alter the password that is securing your account(s).
  • requestMonthlyBytes: You may request additional bytes for a monthly volume account by using bytes of future months.
  • paymentProxy: You may choose how you want to connect to payment instances (directly; only directly if it is not possible via mix cascades; always use mix cascades).
  • infoserviceProxy: You may choose how you want to connect to InfoServices (directly; only directly if it is not possible via mix cascades; always use mix cascades).
  • logdetail: You may determine how detailed your log messages will be.
  • loglevel: You may determine which kind of problems (if problems at all) will be reported.
  • logtype: You may determine which subsystems' messages you want to receive.
  • shutdown: If you are running JonDoConsole as a daemon you may shut down the daemon as well (and not just quit the client).

You do not have to remember all those explanations given above. If you have started JonDoConsole just type help <command> to get more information about a specific command.

Using premium services with JonDoConsole

For using premium services, you have to enter a coupon-code, import an account created with GUI client. To create a new account, use JonDo GUI client, export the account and afterwards import it into JonDoConsole. The account creation system of JonDo GUI will not be ported into JonDoConsole, it's rather going to be changed anyway.

If a premium account is available, JonDoConsole uses only premium cascades by default. You can modify the list of cascades used by JonDoConsole you can edit the blacklist with the command blacklist.

Remote control

You can start JonDoConsole as a daemon in background. It is possible to control the running daemon using the controler interface. The remote control interface is a simple Telnet interface.

At first you have to set a password for the remote control interface using the option -t.

> java -jar JonDoConsole.jar -t 
Please enter a password to protect the daemon from hacking or enter 'break' to cancel.
Use at least 10 characters: letters, numbers, upper and lower case. Special characters are allowed.
Please type your daemon password a second time.

Afterwards you may run JonDoConsole as a daemon in background using the option "-d [host]{:port}".

> java -jar JonDoConsole.jar -d localhost:4004

You may use the option " -i [host]{:port}" to connect to a running daemon.

> java -jar JonDoConsole.jar -i localhost:4004
Please enter the daemon password or type 'break' to cancel.
JonDoConsole#password> *******
You are logged in...

But you can use a simple telnet client too:

$ telnet localhost 4004
Connected to localhost.
Escape character is '^]'.
Type 'login' to log into JonDoConsole.
JonDoConsole> login
Received login request! Please wait some seconds for the authentication request...
Please enter the daemon password or type 'break' to cancel.
JonDoConsole#password> <passwort>
You are logged in...
JonDoConsole> status
State:CONNECTED, AutoSwitch:ON, ServiceFilter:'Default Filter', HTTPFilter:ON
JonDoConsole> exit
Personal tools