View source for Sshuttle

=Sissejuhatus=
[https://sshuttle.readthedocs.io/en/stable/index.html sshuttle] on programm mis käitub kui läbipaistev proxy (''ingl. transparent proxy'') ja VPN klient.


Programm on sobiv juhul kui<ref>[https://sshuttle.readthedocs.io/en/stable/overview.html sshuttle overview]</ref>:

- Klientmasin töötab Linux, FreeBSD või MacOS operatsioonisüsteemil.

- Teisse võrku on SSH ligipääs, kusjuures see ei pea olema admin õigustega.

- Kasutaja ei taha või ei saa teha võrgus pordisuunamisi.

=Nõuded=
==Klient==
sudo või root ligipääs masinale;

Python 2.7 või Python 3.5<ref>[https://sshuttle.readthedocs.io/en/stable/requirements.html Requirements]</ref>.


==Server==
Python 2.7 või Python 3.5.

=Paigaldamine=
* APT:
<source lang="bash">
sudo apt-get update && sudo apt-get -y install sshuttle && sudo apt-get clean
</source>


* PyPI:
<source lang="bash">
sudo pip install sshuttle
</source>


* Kloonimine Git'ist:
<source lang="bash">
git clone https://github.com/sshuttle/sshuttle.git
sudo ./setup.py install
</source>


* Sshuttle paigaldamine macOS'is:
<source lang="bash">
brew install sshuttle
</source>

=Kasutamine=
Peale edukat paigaldust saab hakata programmi kasutama.

Ühendumiseks serverisse ning kogu kliendi liikluse suunamine sellesse<ref>[https://sshuttle.readthedocs.io/en/stable/usage.html Usage]</ref>:
 sshuttle --dns -r kasutajanimi@server 0.0.0.0/0 -x server
<code>--dns</code> - saada DNS päringud läbi serveri;

<code>-r</code> - näitab, et edasi tuleb serveri kasutaja ja aadress;

<code>0.0.0.0/0</code> - suuna kogu liiklus läbi serveri. Lühendina võib kasutada <code>0/0</code>;

<code>-x</code> - ära edastada näidatud server, alamvõrk (Ubuntu 18.04 LTS ja uuemad).


Võidakse küsida klientmasina root parooli, et saada sudo õigused ja seejärel SSH serveri kasutaja parooli.


==Alias==
Kiiremaks ühendamiseks võib luua süsteemi vastava aliase.

Ubuntu näitel lisa <code>~/.bash_aliases</code> faili rida:
 alias aliase_nimi='sudo sshuttle --dns -r kasutajanimi@server 0.0.0.0/0 -x server'

Muudetud aliaste fail lugeda uuesti sisse <code>source ~/.bash_aliases</code> ning sisesta vastloodud alias käsuna.

Näide koos võtmefaili kasutamisega:

<code>alias vpn='sudo sshuttle --dns -Nvr kasutajanimi@server 0.0.0.0/0 -e "ssh -i /home/kasutaja/.ssh/voti kasutajanimi@server"'</code>

Asendada "kasutajanimi", "server", "kasutaja", "voti" tegelike väärtustega.

"vpn" asemel võib ka mõnda teist aliase nime kasutada.

Kui lisada ka -H parameeter siis skaneeritakse ka sihtkoha masinate nimed ja lisatakse /etc/hosts faili. Ühenduse katkestamisel taastatakse esialgne seis:

<code>alias vpn='sudo sshuttle --dns -HNvr kasutajanimi@server 0.0.0.0/0 -e "ssh -i /home/kasutaja/.ssh/voti kasutajanimi@server"'</code>

Aliase käivitamiseks piisab käsureale ''vpn'' sisestamisest ja ''Enter'' vajutamisest. Kui SSH võtmefail sisaldab salasõna siis tuleb see sisestada või kasutada agenti, et see sessiooni vältel meeles hoida. Lisaks tuleb ''sudo'' puhul salasõna sisestada, millest saab lahti [https://help.ubuntu.com/community/Sudoers sudoers] mehhanismi kasutades:
<pre>
sudo nano /etc/sudoers.d/permissions #failinimi permissions võib asendada millega iganes
username ALL=(ALL) NOPASSWD: /usr/bin/sshuttle #asendada username reaalse kasutajanimega ja seejärel fail salvestada
</pre>

=Autor=
Vahur Lepvalts

AK21

Täiendanud:
Edmund Laugasson, EIK õppejõud

=Kasutatud materjal=
<references />
* https://github.com/sshuttle/sshuttle

[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]