View source for Sshuttle

=Sissejuhatus=
[https://sshuttle.readthedocs.io/en/stable/index.html sshuttle] on programm mis käitub kui läbipaistev puhverserver (''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 GNU/Linux, FreeBSD või macOS operatsioonisüsteemil.

- Teise 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 -x server -r kasutajanimi@server 0.0.0.0/0
<code>--dns</code> - saada DNS päringud läbi serveri;

<code>-x</code><ref>[https://www.reddit.com/r/archlinux/comments/7kxdvw/trouble_running_sshuttle_these_days/ r/archlinux]</ref> - ära edastada SSH serverit kuhu ühendutakse (Ubuntu 18.04 LTS ja uuemad);

<code>-r</code> - SSH server kuhu ühendutakse ja seal serveris toimiv kasutaja;

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


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 -x server -r kasutajanimi@server 0.0.0.0/0'

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 -x server -e "ssh -i /home/kasutaja/.ssh/voti" -Nvr kasutajanimi@server 0.0.0.0/0'</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 -x server -e "ssh -i /home/kasutaja/.ssh/voti" -HNvr kasutajanimi@server 0.0.0.0/0'</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>
Kui soovitakse kõikidele kasutajatele lubada:
<pre>
ALL ALL=(ALL) NOPASSWD: /usr/bin/sshuttle
</pre>

=Autor=
Vahur Lepvalts

AK21

Täiendanud:
[https://wiki.itcollege.ee/index.php/User:Edmund Edmund Laugasson]

=Kasutatud materjal=
<references />
* https://github.com/sshuttle/sshuttle
* [https://sshuttle.readthedocs.io/en/stable/windows.html sshuttle'i kasutamisest MS Windowsis]

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