1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
|
HOWTO
=====
Dumped 2014-01-16 from https://code.google.com/p/gitso/wiki/Howto
See also: http://doc.ubuntu-fr.org/gitso (French)
http://wiki.ubuntuusers.de/Gitso (German)
--------
Howto
Updated Sep 26, 2012 by herr.bi...@gmail.com
First, the person giving support needs to:
1. Launch Gitso.
2. Click on "Give Support"
3. Click "Start"
Second, the person who needs help, needs to:
1. Launch Gitso.
2. Click on "Get Help"
3. Type in the "IP Address" provided by the supporter
4. Click "Start"
Now the person who needs help sits back and watches as someone else
moves their mouse and operates their pc from afar.
Note: The person who is giving support needs to have port 5500 open to
their machine which requires a port forward on a NATed network.
FAQ
* Q: I want to help someone, but I’m behind a router, and it doesn’t
work!
* A: The person who is going to “give support” must have port 5500
open to their PC. This usually means enabling port forwarding on
your router and poking holes through any firewalls.
* Q: How do I get an IP that can be reached by a person who is in
another city or simply another ISP(network)? I don't have an IP.
The public IP that I get from a whatismyip type website is actually
common to everybody around me.
* A: In order to give support through Gitso, you need to be able to
have access to the firewall/router of the subnet you're on. If you
don't have access to that, you unfortunately won't be able to use
Gitso. If you do have access, then you forward the external IP/port
to your internal IP/port. Usually in VNC, it's the person "getting
support" who has to do this, but with Gitso, we reverse this and
have the person "giving support" set this up. For example, that's
what I do at home. But when I'm at work and don't have access to
the router, I can't use Gitso to give support.
* Q: (Ubuntu) When I try to install Gitso, it says "Dependency is not
satisfiable: x11vnc". What's up?
* A: This is because that program isn't enabled for install by
default, please follow these steps to enable it.
1. Enable universe repository by going to the following menu:
System > Administration > Software Sources > check all >
Close > Reload
2. Now you should be able to install Gitso by double clicking
gitso_0.6_all.deb and then clicking "Install Package".
* Q: (Windows - Get help) I'm not able to get help, I know I have
IP's and the support guys says his network is set-up correctly.
* A: Selecting "Unblock" when prompted by Windows Firewall or disable
the firewall on that port.
* Q: Why is there no temporary shared secret needed to make sure the
connection is legitimate and not accidental or manipulative?
* A: Because Gitso is based on reverse VNC, you have to connect to
someone to share your screen, not the other-way around; as such it
reduces the need for a password. Specifically, the server that is
running, allows you to connect to other peoples' screens, not to
share your screen (which is traditionally used).
Advanced
There are a number of command line switches that Gitso supports.
* --dev This should be used when calling gitso from the source. This
enables the code to look in the appropriate place for various
assets.
* --listen Gitso will start and automatically listen for connections
(AKA give support)..
* --connect IP Gitso will start and automatically try to connect to
the IP address.
* --list list_file Gitso will look to this external list, can be
local or via HTTP for the hosts lists. Ex: You could add a list to
your web server so every time the user connected with this option,
they would get an up-to-date support list from your server.
* list_file Should be something like
http://www.myserver.com/path/to/support_ips.txt
* support_ips.txt Should be a comma separated list of IP's. These
will then show up in the menu of support IP addresses in Gitso.
* --low-colors Use 8bit colors (for slow connections). Linux only.
* --version Show the current release of Gitso.
* --help Show these options.
Comments
Comment by amshepp...@gmail.com, Jun 5, 2010
SUggestion: Until SSH Tunneling is in some future release, could I
suggest someone compose a good article on setting up gitso to run over
a ssh tunnel on the various support operating systems?
Comment by Riks...@gmail.com, Jun 30, 2010
Scaling is not supported, right?
Comment by project member gerbe...@gmail.com, Jun 30, 2010
Correct, scaling is not supported, or at least to the best of my
knowledge by any of the VNC clients Gitso is using. It'd be awesome if
it did though!
Comment by dserba...@gmail.com, Jul 12, 2010
I don't know about compatibility with MacOSX and Win32, I've only used
x11vnc in combination with the vncviewer that is part of the tightvnc
package on Linux. Some time after an x11vnc upgrade, I hit this really
difficult bug to hunt down, and eventually found the solution on this
blog post: http://www.bramschoenmakers.nl/en/node/714
Comment by project member gerbe...@gmail.com, Jul 12, 2010
Created a ticket in the issues tracker:
http://code.google.com/p/gitso/issues/detail?id=61
Comment by p.gwill...@gmail.com, Feb 17, 2011
Is there any way to change the port number from 5500? I would rather
select my own port number.
It seems like a security issue if 5500 is known to potentially connect
to an active Gitso server.
Comment by project member gerbe...@gmail.com, Feb 17, 2011
Because the server is the side that can see the other person's screen,
the security seems like less of an issue, outside of any VNC bugs...
Ex: If a hacker found out that the port was open, the worst they could
do is show their screen to the person running the server...
The point of wanting to change ports is still legit though. There is a
ticket open for this feature request:
http://code.google.com/p/gitso/issues/detail?id=17
Comment by emcpol...@gmail.com, Apr 27, 2011
Much better than other alternatives (and faster), And a simple clean
interface The only thing is it definitely needs some quality
preferences, to save bandwidth
thanks for a great product
Comment by darcy...@gmail.com, Feb 23, 2012
Great product. It would be nice to be able to create a client that had
an IP or a --list URL built in. That way we can build a custom client
that connects to us. Saves having to explain things to the user we are
trying to help. Maybe it could use a config file if it found one and we
could distribute that with the standard executible. Splitting out the
client would be cool too.
Comment by rula...@gmail.com, May 28, 2013
> If a hacker found out that the port was open, the worst > they could
do is show their screen to the person running > the server...
No, the worst they could do is open 3.7*10^6 support requests and DOS
the machine running the server, and this is actually pretty bad. PLEASE
DO implement a shared secret!
Comment by nicolas....@gmail.com, Dec 4, 2013
hello,
I want to run more than one instance of gitso "helper chair" on the
same network. it is possible to make client connect to mydomain:5500 or
mydomain:5501 and so on, so the router can route the client (from the
internet) to the right helper depending on what the customer enter on
the support box.
Or any suggestions ?? thanks :)
|