Instalação Syncthing · 6 min read · Sep 15, 2025

Como Instalar o Syncthing no Debian 12

Syncthing é uma ferramenta de sincronização de arquivos peer-to-peer de código aberto, projetada para sincronizar arquivos entre vários dispositivos de forma segura. Ao contrário dos serviços baseados em nuvem, o Syncthing opera diretamente entre dispositivos, sem armazenar dados em servidores externos, dando aos usuários total controle sobre seus arquivos e privacidade. Ele utiliza comunicação criptografada entre dispositivos, garantindo que os dados sejam transferidos de forma segura.

O Syncthing pode sincronizar arquivos entre computadores, dispositivos móveis e servidores, tornando-se uma solução versátil para usuários que precisam de sincronização de arquivos confiável, privada e em tempo real. É fácil de configurar, multiplataforma e funciona em segundo plano, sincronizando automaticamente os arquivos sempre que alterações são detectadas.

Este tutorial mostrará como instalar o software de sincronização de arquivos Syncthing em servidores Debian 12. Você então configurará a autenticação do Syncthing, conectando entre dois servidores Syncthing, e depois configurará o compartilhamento e a sincronização de diretórios entre os servidores Syncthing.

Pré-requisitos

Para começar este tutorial, certifique-se de ter o seguinte:

  • Dois ou mais servidores Debian 12
  • Um usuário não-root com privilégios de administração

Instalando o Syncthing no Debian

O Syncthing é uma ferramenta de sincronização peer-to-peer para compartilhamento seguro. Nesta seção, você instalará o Syncthing através do repositório oficial do Syncthing usando o gerenciador de pacotes APT.

Primeiro, execute o comando abaixo para atualizar o índice de pacotes do Debian e instalar algumas dependências básicas.

sudo apt update && sudo apt install gnupg2 curl apt-transport-https -y

install deps

Agora adicione a chave GPG do Syncthing e o repositório para o sistema Debian com o comando abaixo.

curl -fsSL https://syncthing.net/release-key.txt | \  
sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/syncthing.gpg
echo "deb https://apt.syncthing.net/ syncthing release" | \  
sudo tee /etc/apt/sources.list.d/syncthing.list

add repo install syncthing

Em seguida, execute o seguinte comando ‘apt’ abaixo para atualizar seu índice de pacotes e instalar o pacote ‘ syncthing ‘. Digite ‘ Y ‘ para confirmar a instalação.

sudo apt update && sudo apt install syncthing

install syncthing

Após a instalação ser concluída, verifique o arquivo binário ‘ syncthing ‘ e verifique sua versão com o seguinte.

which syncthing
syncthing --version  
syncthing --help

Como você pode ver abaixo, o Syncthing 1.27 está instalado em ‘ /usr/bin/syncthing ‘.

check version

Configurando o UFW (Firewall Descomplicado)

Depois de instalar o Syncthing, você instalará o UFW (Firewall Descomplicado), abrirá portas para os serviços OpenSSH e Syncthing, e então iniciará e habilitará o UFW em seus servidores Debian.

Instale o pacote ‘ ufw ‘ usando o comando ‘ apt ‘ abaixo.

sudo apt install ufw -y

Execute o comando abaixo para habilitar o perfil ‘OpenSSH’ e ativar o UFW. Digite ‘ y ‘ para confirmar, e você verá a saída ‘ Firewall está em execução e habilitado na inicialização do sistema ‘ quando o UFW estiver em execução e habilitado.

sudo ufw allow OpenSSH  
sudo ufw enable

Em seguida, execute o comando ‘ufw’ abaixo para habilitar os perfis ‘ syncthing ‘ e ‘ syncthing-gui ‘.

sudo ufw allow syncthing  
sudo ufw allow syncthing-gui

Por último, verifique o status do UFW executando o comando abaixo. O UFW deve estar ‘ativo’ com os perfis ‘ OpenSSH ‘, ‘ syncthing ‘ e ‘ syncthing-gui ‘ habilitados.

sudo ufw status

Configurando o Syncthing

Nesta seção, você configurará o Syncthing iniciando o serviço ‘syncthing’ para seu usuário e configurando o endereço IP local para o painel da web do Syncthing. Neste exemplo, usaremos dois servidores Debian, ‘debian1’ e ‘debian2’.

Faça login no seu usuário com o comando abaixo. Neste caso, usaremos ‘ user1 ‘ para o ‘ debian1 ‘ e ‘ user2 ‘ para o ‘ debian2 ‘.

su - user1

Agora execute o seguinte comando ‘ systemctl ‘ para iniciar, habilitar e verificar o ‘ [email protected] ‘. Quanto ao servidor ‘ debian2 ‘ com o ‘ user2 ‘, o nome do serviço deve se tornar como ‘ [email protected] ‘.

sudo systemctl enable --now [email protected]  
sudo systemctl status [email protected]

Você pode ver abaixo que o ‘ [email protected] ‘ está em execução e habilitado.

syncthing service

Em seguida, abra o arquivo de configuração do Syncthing ‘ ~/.local/state/syncthing/config.xml ‘ com o editor ‘ nano ‘.

nano ~/.local/state/syncthing/config.xml

Dentro da seção ‘ ‘, habilite a conexão TLS segura com ‘ tls=”true” ‘ e insira seu endereço IP interno. Para este exemplo, o servidor ‘ debian1 ‘ com endereço IP ‘ 192.168.5.123 ‘ e o servidor ‘ debian2 ‘ com endereço IP ‘ 192.168.5.120 ‘.

   
 
192.168.5.123:8384
GENERATED-API-KEY default

Quando terminar, salve o arquivo e saia do editor.

Por último, execute o comando ‘ systemctl ‘ abaixo para reiniciar o serviço Syncthing. Com isso, o Syncthing deve estar em execução em um endereço IP local com uma conexão TLS segura habilitada.

sudo systemctl restart [email protected]

Configurando o usuário do Syncthing

Neste ponto, seu Syncthing está em execução com o painel de administração da web habilitado. Portanto, por agora, você configurará a autenticação do usuário para ambos os Syncthing ‘debian1’ e ‘ debian2 ‘.

Abra seu navegador da web e visite https://192.168.5.123:8384/. Certifique-se de alterar o endereço IP pelo endereço IP de seus servidores Debian. Agora você verá o painel de administração do Syncthing.

Clique no botão ‘ Configurações ‘ para configurar seu nome de usuário e senha para o Syncthing.

dashboard

Na seção ‘ GUI ‘, insira seu nome de usuário e senha, e então clique em ‘ Salvar ‘ para confirmar.

setup admin

Agora você será redirecionado para a página de login do syncthing. Insira seu nome de usuário e senha para fazer login.

login

Se for bem-sucedido, você verá o seguinte painel do Syncthing.

dashboard

Conectando dispositivos Syncthing

Agora que você garantiu a autenticação de usuário e senha do Syncthing, vamos conectar o Syncthing no servidor ‘ debian2 ‘ ao ‘ debian1 ‘.

No servidor ‘ debian2 ‘, selecione Ação > Mostrar ID para exibir o ID ou identidade do servidor. Isso mostrará um QR code do servidor ‘ debian2 ‘ e você pode copiar este ID do dispositivo.

Show ID

Clique no botão Copiar.

copy id

Agora vá para o painel do ‘ debian1 ‘ e clique em ‘ Adicionar Dispositivo Remoto ‘ na seção Dispositivos Remotos.

Na janela pop-up, cole o ID do dispositivo ‘ debian2 ‘ e clique em Salvar.

add device

Em seguida, vá para o painel do ‘ debian2 ‘ e você verá a configuração como a seguinte:

Clique em ‘ Adicionar Dispositivo ‘ para confirmar e conectar o servidor ‘ debian2 ‘ ao ‘ debian1 ‘.

Se tudo correr bem, você verá que o servidor ‘ debian2 ‘ está conectado a partir do painel do ‘ debian1 ‘.

connected

Sincronizando pastas entre dispositivos

Com os servidores ‘ debian1 ‘ e ‘ debian2 ‘ conectados, você pode agora configurar um diretório compartilhado e sincronizar arquivos entre esses dois servidores.

Certifique-se de estar no painel do ‘ debian1 ‘, então na seção Pasta você verá a ‘ Pasta Padrão ‘ com o status ‘ Não Compartilhada ‘.

status unshared

Clique no botão ‘ Editar ‘ para compartilhar esta pasta.

  • Na aba ‘ Compartilhamento ‘, clique em ‘ debian2 ‘ para compartilhar e sincronizar esta pasta com o servidor ‘ debian2 ‘.
  • Na aba ‘ Versionamento de Arquivos ‘, selecione o método de versionamento de arquivos conforme necessário.
  • Clique em Salvar para confirmar.

share device

Agora vá para o painel do ‘ debian2 ‘ e você verá a notificação como a seguinte:

Clique em Compartilhar para confirmar e compartilhar a pasta.

confirm share

Se o compartilhamento da pasta for bem-sucedido, você verá a ‘ Pasta Padrão ‘ com o status ‘Compartilhada’. A seguir, o servidor ‘ debian1 ‘ está compartilhado com o servidor ‘ debian2 ‘.

shared

Conclusão

Parabéns! Você completou a instalação do Syncthing em dois servidores Debian 12. Você também aprendeu como conectar dispositivos Syncthing através do painel e sincronizar pastas/diretórios entre dois dispositivos ou máquinas diferentes.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.