chtunn/README.md

# WIP

## L'argomento -p ancora non funziona:

CON L'ARGOMENTO -p SI VUOLE ATTIVARE uBlockOrigin PREINSTALLATO

### La funzione ublock:
- scarico lo zip del plugin nella cartella /tmp 

# CHTUNN

Utility per tunnel SOCKS5 su Chromium


## INSTALLAZIONE
### INSTALLAZIONE VELOCE (Debian/Ubuntu):
```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 VELOCE (Arch):
```bash
curl https://repo.esiliati.org/scossa/chtunn/raw/branch/main/easysetup_arch.sh -o ./easysetup_arch.sh; chmod +x easysetup_arch.sh; ./easysetup_arch.sh; rm easysetup_arch.sh
```
### INSTALLAZIONE NORMALE:
#### DIPENDENZE
Debian
```bash
sudo apt install chromium
```
Ubuntu
```bash
sudo apt install chromium-browser
```
Arch
```bash
sudo pacman -Syu chromium
```
#### 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
```

## MENU HELP MOSTRATO DA "chtunn --help"

```bash
[Utility per tunnel SOCKS5 su Chromium]

utilizzo: chtunn <1025-65535> [-i] [-p]

esempio:
Su una finestra del terminale: ssh user@server.mio -D 1234
Su una altra finestra del terminale: chtunn 1234
Argomenti
-i    attiva incognito mode
-p    uBlock Origin preinstallato
-h    Mostra questo menu
```