chtunn/README.md

# CHTUNN

Utility per tunnel SOCKS5 su Chromium


## INSTALLAZIONE
### INSTALLAZIONE VELOCE:
```bash
curl https://repo.esiliati.org/scossa/chtunn/raw/branch/main/easysetup.sh -o ./easysetup.sh; chmod +x easysetup.sh; ./easysetup.sh; rm easysetup.sh
```


### INSTALLAZIONE NORMALE:
#### DIPENDENZE
Debian
```bash
sudo apt install chromium
```
Ubuntu
```bash
sudo apt install chromium-browser
```
#### SCARICA LO SCRIPT
```bash
#scarica lo script in /usr/bin/
curl https://repo.esiliati.org/scossa/chtunn/raw/branch/main/chtunn.sh -o /usr/bin/chtunn.sh

#diventa proprietario del file e concedi permessi di esecuzione allo script
sudo chown $USER:root /usr/bin/chtunn.sh; chmod 770 /usr/bin/chtunn.sh

#LANCIA QUESTO COMANDO SOLO SE HAI UBUNTU
#cambia lo script impostando chromium-browser anzichè chromium
sudo sed -i 's/\/usr\/bin\/chromium/\/usr\/bin\/chromium-browser/' /usr/bin/chtunn.sh 
```

#### CREA UN ALIAS

Apri con un editor il file /home/$USER/.bashrc
```bash
nano /home/$USER/.bashrc
#OPPURE
vim /home/$USER/.bashrc
```

scorri finche non trovi  una roba come...
```bash
...
alias ll='ls -lah'
alias la='ls -la'
alias l='ls -CF'
alias _='sudo'
alias _i='sudo -i'
...
```
...e aggiungi l'alias di chtunn:
```bash
...
alias ll='ls -lah'
alias la='ls -la'
alias l='ls -CF'
alias _='sudo'
alias _i='sudo -i'
alias chtunn='/usr/bin/chtunn.sh'
...
```

## UTILIZZO

Su una finestra del terminale:<br>
Apri una connessione ssh forwardandola su una porta (esempio:la 5555)
```bash
ssh user@server.mio -D 5555
```
Su un'altra finestra del terminale:<br>
Avvia una sessione di Chromium usando come proxy SOCKS5 la connessione ssh stabilita
```bash
chtunn 5555
```
## NOTA
Chromium per funzionare crea una cartella di sessione. <br>
chtunn.sh crea la cartella "chtunn-$1" in /$HOME/.config/chromium/CHTUNN/ <br>
dove $1 = numero della porta scelta<br><br>

Per rimuovere tutte le cartelle di sessione create da chtunn.sh dai il comando:
```bash
rm -R /$HOME/.config/chromium/CHTUNN
```