설치 가이드 · 2 min read · Sep 15, 2025

Debian 12에 Syncthing 설치하는 방법

Syncthing은 여러 장치 간에 파일을 안전하게 동기화하도록 설계된 오픈 소스 P2P 파일 동기화 도구입니다. 클라우드 기반 서비스와 달리 Syncthing은 외부 서버에 데이터를 저장하지 않고 장치 간에 직접 작동하여 사용자가 파일과 개인 정보를 완전히 제어할 수 있도록 합니다. 장치 간에 암호화된 통신을 사용하여 데이터가 안전하게 전송되도록 보장합니다.

Syncthing은 컴퓨터, 모바일 장치 및 서버 간에 파일을 동기화할 수 있어 신뢰할 수 있고 개인적이며 실시간 파일 동기화가 필요한 사용자에게 다재다능한 솔루션입니다. 설정이 간편하고 크로스 플랫폼이며 백그라운드에서 실행되어 변경 사항이 감지될 때마다 자동으로 파일을 동기화합니다.

이 튜토리얼에서는 Debian 12 서버에 Syncthing 파일 동기화 소프트웨어를 설치하는 방법을 보여줍니다. 그런 다음 syncthing 인증을 설정하고 두 개의 Syncthing 서버 간에 연결한 다음 Syncthing 서버 간의 디렉터리 공유 및 동기화를 설정합니다.

전제 조건

이 튜토리얼을 시작하려면 다음이 필요합니다:

  • 두 개 이상의 Debian 12 서버
  • 관리 권한이 있는 비루트 사용자

Debian에 Syncthing 설치하기

Syncthing은 안전한 공유를 위한 P2P 동기화 도구입니다. 이 섹션에서는 APT 패키지 관리자를 사용하여 공식 Syncthing 리포지토리를 통해 Syncthing을 설치합니다.

먼저 아래 명령어를 실행하여 Debian 패키지 인덱스를 업데이트하고 몇 가지 기본 종속성을 설치합니다.

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

install deps

이제 아래 명령어를 사용하여 Debian 시스템에 Syncthing GPG 키와 리포지토리를 추가합니다.

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

다음으로 아래 ‘apt’ 명령어를 실행하여 패키지 인덱스를 새로 고치고 ‘ syncthing ‘ 패키지를 설치합니다. 설치를 확인하려면 ‘ Y ‘를 입력합니다.

sudo apt update && sudo apt install synching

install syncthing

설치가 완료되면 ‘ syncthing ‘ 바이너리 파일을 확인하고 다음을 사용하여 버전을 확인합니다.

which syncthing
syncthing --version  
syncthing --help

아래와 같이 Syncthing 1.27이 ‘ /usr/bin/syncthing ‘에 설치되어 있습니다.

check version

UFW(간단한 방화벽) 설정하기

Syncthing을 설치한 후 UFW(간단한 방화벽)를 설치하고 OpenSSH 및 Syncthing 서비스에 대한 포트를 열고 Debian 서버에서 UFW를 시작하고 활성화합니다.

아래 ‘ ufw ‘ 패키지를 ‘ apt ‘ 명령어를 사용하여 설치합니다.

sudo apt install ufw -y

아래 명령어를 실행하여 ‘OpenSSH’ 프로필을 활성화하고 UFW를 활성화합니다. 확인하려면 ‘ y ‘를 입력하고 UFW가 실행되고 활성화되면 ‘ Firewall is running and enabled on system startup ‘라는 출력이 표시됩니다.

sudo ufw allow OpenSSH  
sudo ufw enable

다음으로 아래 ‘ufw’ 명령어를 실행하여 ‘ syncthing ‘ 및 ‘ syncthing-gui ‘ 프로필을 활성화합니다.

sudo ufw allow syncthing  
sudo ufw allow syncthing-gui

마지막으로 아래 명령어를 실행하여 UFW 상태를 확인합니다. UFW는 ‘ OpenSSH ‘, ‘ syncthing ‘, ‘ syncthing-gui ‘ 프로필이 활성화된 상태로 ‘active’여야 합니다.

sudo ufw status

Syncthing 구성하기

이 섹션에서는 사용자를 위한 ‘syncthing’ 서비스를 시작하고 Syncthing 웹 대시보드를 위한 로컬 IP 주소를 설정하여 Syncthing을 구성합니다. 이 예에서는 두 개의 Debian 서버인 ‘debian1’과 ‘debian2’를 사용할 것입니다.

아래 명령어로 사용자로 로그인합니다. 이 경우 ‘ debian1 ‘에는 ‘ user1 ‘을 사용하고 ‘ debian2 ‘에는 ‘ user2 ‘를 사용합니다.

su - user1

이제 다음 ‘ systemctl ‘ 명령어를 실행하여 ‘ [email protected] ‘를 시작하고 활성화하며 상태를 확인합니다. ‘ debian2 ‘ 서버의 ‘ user2 ‘에 대해서는 서비스 이름이 ‘ [email protected] ‘와 같아야 합니다.

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

아래와 같이 ‘ [email protected] ‘가 실행 중이고 활성화되어 있는 것을 확인할 수 있습니다.

syncthing service

다음으로 ‘ nano ‘ 편집기를 사용하여 Syncthing의 구성 파일 ‘ ~/.local/state/syncthing/config.xml ‘을 엽니다.

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

‘ 섹션 내에서 ‘ *tls=

Share: X/Twitter LinkedIn

새 게시물을 받은 편지함에서 받기

스팸은 없습니다. 언제든지 구독 해지 가능합니다.