xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.


Changes between Version 9 and Version 10 of ProxyServer


Ignore:
Timestamp:
11/07/13 05:39:18 (7 years ago)
Author:
Antoine Martin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ProxyServer

    v9 v10  
    1717
    1818{{{#!div class="box"
    19 == Usage ==
     19== Basic Usage ==
     20'''Beware''': to simplify these instructions, we use the {{{allow}}} [/wiki/Authentication authentication module], which does '''no''' checking whatsoever!
     21
    2022To start the proxy server, simply run:
    2123{{{
    22 xpra proxy :20 --auth=sys --bind-tcp=0.0.0.0:443
     24xpra proxy :20 --auth=allow --bind-tcp=0.0.0.0:443
    2325}}}
     26
     27If only one session is accessible, users can connect as usual with:
     28{{{
     29xpra attach tcp:USERNAME@PROXYHOST:443
     30}}}
     31
     32If there is more than one session accessible for this user, the client also needs to specify which display it wishes to connect to, using one of those two switches:
     33* the "{{{--display=:N}}}" switch
     34* the extended attach syntax: "{{{tcp:USERNAME@SERVER:PORT:DISPLAY}}}
     35ie:
     36{{{
     37xpra attach tcp:john@127.0.0.1:443 --display=:100
     38}}}
     39[[BR]]
     40
    2441Notes:
    25 * if you run this command as root, all the user sessions will be exposed, and although a password will be required to access them - this is prone to man-in-the-middle attacks (see [/wiki/Authentication#SecurityConsiderations authentication security considerations])
     42* if you run this command as root, all the user sessions will be exposed!
    2643* if you run it a normal user, only this user's session will be exposed
    2744* once authenticated, the proxy server spawns a new process and no longer runs as root
    2845* the display number chosen for the proxy server is only used for identifying the proxy server and interacting with it using the regular tools ("{{{xpra info}}}", etc)
    29 [[BR]]
    30 
    31 When attaching, the client usually needs to specify its password using the {{{--password-file}}} switch, and if there is more than one live session for that user, it will also need to specify which display it wishes to connect to, using one of those two switches:
    32 * the "{{{--display=:N}}}" switch
    33 * the attach syntax: "{{{tcp:SERVER:PORT:DISPLAY}}}
    34 ie:
    35 {{{
    36 xpra attach tcp:127.0.0.1:443 --password-file=./password.txt --display=:100
    37 }}}
    3846}}}
    3947