Instalação GSClient AppImage no Linux

Documento com a lista de códigos de erros

Requisitos Básicos

Liberações no Firewall

Segue abaixo o nosso range de IPs e portas para liberação no firewall da máquina ou da rede, ou validação da rota por parte do provedor de internet.

IP:

• 18.231.194.64/26

Portas:

• 443/UDP
• 443/TCP
• 55844/TCP
• 55845/TCP

E DNS local 53/UDP (consultas em gsurfnet.com).

Sistema Operacional

Requisitos mínimos do Sistema Operacional e como validá-los.

1 - Arquitetura 64 bits.

• Utilizando o comando abaixo um dos números deve ser 64:
  bash uname -m

2 - Framework FUSE (Filesystem in Userspace)

• O utilizando os comandos abaixo, um deles deve retornar a versão se estiver instalado:
  bash (fusermount3 --version || fusermount --version)

3 - Biblioteca GNU C Library (glibc) versão 2.27 ou superior.

• Utilizando o comando abaixo, o número no final da primeira linha deve ser maior ou igual a 2.27:
  bash ldd --version

Caso a versão da distribuição Linux sendo utilizada não atenda esses requisitos, será necessário uma das 3 alternativas abaixo:

1. Atualizar a versão da distribuição ou das dependências para que atendam os requisitos.

2. Utilizar outra distribuição ou versão que atenda os requisitos.

3. Em último caso, menos recomendado, utilizar o GSClient Classic.

Instalação

A instalação deve ser realizada com o usuário root:

sudo su

Existem duas maneiras de realizar a instalação, via script ou manualmente.

Instalação via script

Executar o comando abaixo e seguir a instalação conforme o script solicitar:

U="https://gsurf.com.br/lib/linux/script_gsclient"; (curl -sL $U || wget -qO- $U) | bash

Observação: Antes de iniciar a nova instalação, o script removerá automaticamente versões anteriores, mas apenas se estiverem no padrão GSurf, instalações customizadas (pastas, arquivos ou serviços renomeados) exigem remoção manual.

Instalação manual

cat /usr/gsurf/gsurfcli.txt

killall serverSSL 2>/dev/null
killall gsclient 2>/dev/null
rm -r /usr/gsurf 2>/dev/null
rm -r /gsurf/ 2>/dev/null
rm -r /usr/sbin/gsurf/ 2>/dev/null
rm /usr/sbin/gsclient.AppImage 2>/dev/null    
find /lib* /usr/lib* -name "libGSurfRSA.so" -delete 2>/dev/null
rm /usr/lib/systemd/system/libssl.service 2>/dev/null
rm /usr/lib/systemd/system/gsclient.service 2>/dev/null
rm /etc/init.d/serverSSL 2>/dev/null
rm /etc/init.d/gsclient 2>/dev/null
sed -i '/serverSSL/d' /etc/rc.local 2>/dev/null
sed -i '/gsclient.AppImage/d' /etc/rc.local 2>/dev/null
sed -i '/serverSSL/d' /etc/rc.d/rc.local 2>/dev/null
sed -i '/gsclient.AppImage/d' /etc/rc.d/rc.local 2>/dev/null

mkdir -p /usr/sbin/gsurf
wget https://gsurf.com.br/lib/linux/gsclient_appimage_tls3.zip -P /usr/sbin/gsurf
(unzip -o /usr/sbin/gsurf/gsclient_appimage_tls3.zip -d /usr/sbin/gsurf || bsdtar -xf /usr/sbin/gsurf/gsclient_appimage_tls3.zip -C /usr/sbin/gsurf || busybox unzip -o /usr/sbin/gsurf/gsclient_appimage_tls3.zip -d /usr/sbin/gsurf) 2>/dev/null
chmod +x /usr/sbin/gsurf/*

mkdir -p /usr/sbin/gsurf
wget https://gsurf.com.br/lib/linux/gsclient_appimage_tls1.zip -P /usr/sbin/gsurf
(unzip -o /usr/sbin/gsurf/gsclient_appimage_tls1.zip -d /usr/sbin/gsurf || bsdtar -xf /usr/sbin/gsurf/gsclient_appimage_tls1.zip -C /usr/sbin/gsurf || busybox unzip -o /usr/sbin/gsurf/gsclient_appimage_tls1.zip -d /usr/sbin/gsurf) 2>/dev/null
chmod +x /usr/sbin/gsurf/*

/usr/sbin/gsurf/gsclient_setup.AppImage

mv /usr/sbin/gsurf/gsclient.AppImage /usr/sbin
restorecon -v /usr/sbin/gsclient.AppImage 2>/dev/null
rm -r /usr/sbin/gsurf

mkdir -p /usr/lib/systemd/system

cat <<EOF > /usr/lib/systemd/system/gsclient.service
[Unit]
Description=GSClient
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/sbin/gsclient.AppImage

[Install]
WantedBy=multi-user.target
EOF

chmod +x /usr/lib/systemd/system/gsclient.service

systemctl daemon-reload
systemctl enable gsclient.service
systemctl start gsclient.service
systemctl status gsclient.service

cat <<'EOF' > /etc/init.d/gsclient
#!/bin/sh
### BEGIN INIT INFO
# Provides:          gsclient
# Required-Start:    $local_fs
# Required-Stop:     $local_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# X-Interactive:     false
# Short-Description: GSClient script
# Description:       Start/Stop GSClient
### END INIT INFO

DESC="GSClient script"
NAME=gsclient

do_start() {
    echo "Starting $NAME!";
    /usr/sbin/gsclient.AppImage &
}

do_stop() {
    echo "Stopping $NAME!"
    killall gsclient
}

case "$1" in
    start)
        do_start
        ;;
    stop)
        do_stop
        ;;
esac
exit 0
EOF

chmod +x /etc/init.d/gsclient
update-rc.d gsclient defaults

/etc/init.d/gsclient start

Teste de conexão

1 - Caso a execução como serviço não tenha sido configurada, é possível iniciar manualmente:

/usr/sbin/gsclient.AppImage &

Apertar enter até ele voltar para o terminal normal (mostrando o usuário e etc).

2 - Verificar se o serviço está rodando:

pgrep -af gsclient

3 - Execute um teste de comunicação utilizando telnet ou nc no IP 127.0.0.1 e na porta desejada:

• Caso seja SiTef:
  
  bash telnet 127.0.0.1 4096

Aperte Ctrl e c ou Ctrl e ç, q e enter para fechar a conexão.

Logs

Existem diferentes arquivos onde podem ser armazenados os logs da VPN.

1 - Journal:

journalctl $(journalctl -F SYSLOG_IDENTIFIER | grep ^GSURF | sed 's/^/-t /') --no-pager -S today

2 - Syslog:

cat /var/log/syslog | grep GSURF

3 - Messages:

cat /var/log/messages | grep GSURF

Arquivos

Segue abaixo todos os arquivos do GSClient AppImage em suas localização padrões, juntamente de informações sobre eles:

• /usr/gsurf/certificado.pfx

• Certificado.

• /usr/gsurf/tk.dat

• Autenticador (criado após primeira conexão).

• /usr/gsurf/gsurfcli.txt

• Identificação do terminal da CDP.

• /usr/gsurf/region.txt

• Região de conexão.

  • Deve conter escrito somente 3 ou sp2.

• /usr/gsurf/service.cfg

• Contém os serviços do terminal da CDP na última instalação.

  • Adição de novos serviços no terminal da CDP com porta ou categoria diferentes dos anteriores exigem reinstalação do certificado.

• /usr/sbin/gsclient.AppImage

• Arquivo de execução da VPN.

• /usr/lib/systemd/system/gsclient.service

• Inicializador do serviço pelo Systemd.

• /etc/init.d/gsclient

• Inicializador do serviço pelo Init.d.

• /etc/rc.local

• Inicializador do serviço pelo rc.local.

• /etc/rc.d/rc.local

• Inicializador do serviço pelo rc.d/rc.local.

Histórico de Revisões