#Remoção de GSClient antigo

Somente realizar esse passo caso tenha algum GSClient instalado na máquina.

1 - Anotar a identificação do terminal da Central de Parceiros (CDP) que está instalado para reinstalar a OTP dele e utilizar na nova instalação:

cat /usr/gsurf/gsurfcli.txt

2 - Realizar a remoção completa dos arquivos antigos padrão GSurf:

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

Esses comandos realizam a desinstalação e limpeza completa do GSClient (Classic e AppImage), interrompendo os serviços em execução e removendo seus arquivos, pastas e registros de inicialização automática (systemd, init.d e rc.local).

Observação: Os comandos removerão automaticamente apenas instalações no padrão GSurf. Instalações customizadas (outras pastas, arquivos ou serviços renomeados) exigem remoção manual.

#Início da instalação

1 - Realizar o início da instalação:

Executar os comandos abaixo caso a versão da glibc no Sistema Operacional seja 2.34 ou superior:

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/*

Executar os comandos abaixo caso a versão da glibc no Sistema Operacional esteja entre 2.27 e 2.33:

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/*

Os comandos executados linha por linha criam o diretório gsurf, instalam e descompactam a versão do GSClient, além de conceder as permissões de execução.

#Instalação do Certificado

1 - Executar o instalador do certificado:

/usr/sbin/gsurf/gsclient_setup.AppImage

Com o instalador em execução, informe na seguinte ordem: usuário, senha da Central de Parceiros e o OTP (código de 10 números encontrados dentro do terminal na Central).

No final deverá ocorrer a mensagem Certificado instalado, pronto para execução do GS Client.

#Configurar execução como serviço

1 - Preparar o GSClient:

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

Os comandos movem o GSClient para a pasta /usr/sbin, restauram o contexto do SELinux para o padrão da pasta (caso o sistema utilize) e removem a pasta de instalação.

Para que a VPN seja iniciada automaticamente com o sistema operacional, utilize somente um dos métodos a seguir, escolhendo conforme o padrão suportado pela sua distribuição (Systemd, Init.d ou Rc.local):

#Opção 1: Systemd

1 - Verificar se o sistema utiliza systemd:

• Utilizando o comando abaixo o resultado deve ser systemd:

ps -p 1 -o comm=

2 - Realizar a criação do serviço no systemd:

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

Os comandos criam a pasta system no diretório systemd (caso não exista), geram o arquivo gsclient.service preenchido com o script de inicialização e concedem a ele permissão de execução.

3 - Realizar a inicialização do serviço no systemd:

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

Os comandos atualizam a lista de serviços do sistema, habilitam a inicialização automática, iniciam o serviço e, por fim, verificam o seu status de funcionamento.

#Opção 2: Init.d

1 - Caso não utilize systemd, verificar se o sistema utiliza init.d:

• O comando abaixo deve executar sem erros:

ls /etc/init.d/

2 - Realizar a criação do serviço no init.d:

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

Os comandos criam o arquivo gsclient no diretório init.d (preenchido com o script de inicialização), aplicam as permissões necessárias e configuram o serviço como automático.

Observação: Caso retorne comando não encontrado, significa que o sistema não utiliza init.d.

3 - Iniciar o serviço:

/etc/init.d/gsclient start

#Opção 3: Rc.local

1 - Caso não utilize systemd ou init.d, verificar se o sistema utiliza rc.local:

• Verificar se a localização é: /etc/rc.local

ls /etc/rc.local

• Verificar se a localização é: /etc/rc.d/rc.local

ls /etc/rc.d/rc.local

2 - Adicionar a inicialização do serviço no rc.local:

• Caso seja: /etc/rc.local

grep -qxF '/usr/sbin/gsclient.AppImage &' /etc/rc.local || echo '/usr/sbin/gsclient.AppImage &' >> /etc/rc.local
chmod +x /etc/rc.local

• Caso seja: /etc/rc.d/rc.local

grep -qxF '/usr/sbin/gsclient.AppImage &' /etc/rc.d/rc.local || echo '/usr/sbin/gsclient.AppImage &' >> /etc/rc.d/rc.local
chmod +x /etc/rc.d/rc.local

Os comandos adicionam a instrução de inicialização do serviço na última linha do arquivo rc.local (caso ainda não esteja presente) e concedem permissão de execução a ele.

3 - Iniciar o serviço:

• Caso seja: /etc/rc.local

/etc/rc.local

• Caso seja: /etc/rc.d/rc.local

/etc/rc.d/rc.local