설치 가이드 · 5 min read · Dec 18, 2025

우분투 22.04에 Syncthing 설치하는 방법

Syncthing은 Windows, macOS, Linux, Android, Solaris, Darwin 및 BSD와 같은 여러 플랫폼을 위한 안전하고 오픈 소스 파일 동기화 프로그램입니다. 이는 로컬 네트워크의 장치 간 또는 인터넷을 통한 원격 장치 간에 파일을 동기화할 수 있는 분산형 P2P(피어 투 피어) 파일 동기화 도구입니다.

이 튜토리얼에서는 우분투 22.04 서버에 Syncthing을 설치하는 방법을 보여드리겠습니다. 그런 다음 Syncthing 인스턴스 간의 연결을 설정하고, 디렉토리 동기화를 설정하고, 동기화를 확인하는 방법을 배우게 됩니다.

전제 조건

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

  • 두 대의 우분투 22.04 머신 - 이 예제에서는 두 대의 우분투 서버 server1server2를 사용합니다.
  • 관리자 권한이 있는 비루트 사용자.

Syncthing 저장소 추가

Syncthing은 여러 방법으로 설치할 수 있으며, 바이너리 파일을 통해 수동으로 설치하거나 우분투의 APT를 통해 설치할 수 있습니다. 이 예제에서는 두 대의 우분투 머신에 공식 저장소를 추가하여 APT를 통해 syncthing을 설치합니다.

시작하려면, 우분투 시스템에 몇 가지 기본 패키지를 설치하기 위해 다음 명령을 실행하세요.

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

install basic packages

이제 두 대의 우분투 시스템에 syncthing GPG 키와 저장소를 추가합니다. 이 경우, APT 저장소를 통해 Syncthing의 최신 릴리스를 설치합니다.

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

그런 다음, 다음 명령을 사용하여 우분투 저장소를 업데이트하고 새로 고칩니다.

sudo apt update

syncthing 저장소가 사용 가능하다는 메시지가 표시되면 준비가 완료된 것입니다.

refresh repo

Syncthing 설치

이제 두 대의 우분투 머신에 syncthing 저장소를 추가했으므로, 다음 단계는 두 대의 머신에 설치하고 systemd 서비스로 실행하도록 구성하는 것입니다. 또한, 두 머신 모두에서 syncthing을 실행할 비루트 사용자가 있는지 확인하세요.

syncthing을 설치하려면 다음 apt 명령을 실행하세요. 설치를 진행하려면 y를 입력하고 ENTER를 누르세요.

sudo apt install syncthing

install syncthing

설치가 완료되면 다음과 같이 syncthing 버전을 확인하세요:

syncthing --version  
syncthing -h

다음 출력에서 syncthing 1.26이 설치되어 있어야 합니다.

check syncthing version

이제 syncthing을 설치했으므로 사용자별로 시작해야 합니다. 이 예제에서는 server1에서 사용자 alice를, server2에서 사용자 bob을 사용할 것입니다.

아래 명령을 사용하여 사용자로 로그인하세요.

su - alice

그런 다음, 아래와 같은 명령을 사용하여 사용자 alice에 대한 syncthing 서비스를 시작하고 활성화하세요:

sudo systemctl start [email protected]  
sudo systemctl enable [email protected]

요청 시 루트 권한을 얻기 위해 비밀번호를 입력해야 합니다:

start enable syncthing

이제 아래 명령을 사용하여 syncthing 서비스가 실행 중인지 확인하세요.

sudo systemctl status [email protected]

사용자 alice에 대한 syncthing 서비스가 실행 중이어야 합니다. 또한 두 서버 모두에서 syncthing 서비스가 실행 중인지 확인하세요.

check synchthing

방화벽 설정

이 가이드에서는 두 대의 우분투 머신에서 방화벽을 활성화합니다. 우분투에서는 UFW(간단한 방화벽)를 사용할 수 있으며, 기본적으로 syncthing은 UFW 애플리케이션 프로필도 제공하므로 쉽게 활성화할 수 있습니다.

아래 명령을 실행하여 syncthingsyncthing-gui 프로필을 UFW에 추가하세요.

sudo ufw allow syncthing  
sudo ufw allow syncthing-gui

이제 OpenSSH 프로필을 추가한 후, 아래 명령을 사용하여 UFW를 시작하고 활성화하세요. 작업을 확인하려면 y를 입력하세요.

sudo ufw allow OpenSSH  
sudo ufw enable

완료되면 다음과 같은 출력이 표시됩니다.

setup ufw

다음으로, 아래 명령을 사용하여 UFW에서 활성화된 규칙 및 프로필 목록을 확인하세요.

sudo ufw status verbose

syncthing 및 syncthing-gui가 UFW에 추가되었는지 확인하세요.

verify ufw

Syncthing 인스턴스 초기화

이제 Syncthing을 설치하고 UFW를 구성했으므로 설치 초기화를 시작할 준비가 되었습니다. 이 단계에서는 syncthing을 HTTPS가 활성화된 로컬 IP 주소에서 실행하도록 설정하고, syncthing에 대한 사용자 인증을 설정합니다.

기본적으로 syncthing은 localhost에서 실행됩니다. syncthing을 로컬 IP 주소에서 실행하려면 syncthing 구성 ~/.config/syncthing/conf.xml 파일을 수정하세요.

아래 nano 편집기 명령을 사용하여 ~/.config/syncthing/conf.xml 파일을 엽니다.

nano ~/.config/syncthing/conf.xml file

섹션 내에서 ‘ tls ‘ 값을 ‘ true ‘로 변경하고 기본 localhost를 로컬 IP 주소로 변경하세요.

      
        
192.168.5.30:8384
        GENERATED-API-KEY         default    

작업이 완료되면 파일을 저장하고 닫습니다.

이제 다음 명령을 실행하여 syncthing 서비스를 재시작하세요.

sudo systemctl restart [email protected]

웹 브라우저를 열고 서버 IP 주소와 포트 8384(예: https://192.168.5.30:8384/)를 통해 syncthing에 방문하세요.

설치가 성공하면 다음 페이지가 표시됩니다:

설정을 클릭하여 syncthing을 설정하세요.

setup syncthing

GUI 탭 내에서 사용자 이름과 비밀번호를 변경한 후 저장을 클릭하세요.

setup admin user

새 비밀번호가 구성된 후, syncthing 인증이 요청됩니다.

사용자 이름과 비밀번호를 입력한 후 로그인을 클릭하세요.

login syncthing

적절한 사용자 이름과 비밀번호가 있으면 다음과 같은 syncthing 대시보드가 표시됩니다:

syncthing dashboard

아래는 사용자 이름과 비밀번호가 구성된 server2의 syncthing 대시보드입니다.

syncthing dashboard server2

두 Syncthing 인스턴스 연결

두 대의 우분투 머신에서 Syncthing을 구성한 후, 파일을 동기화할 수 있도록 연결합니다. 이를 위해 GUI를 통해 두 머신을 확인해야 합니다.

server1에서 오른쪽 상단의 작업 버튼을 클릭한 다음 ID 표시를 선택하세요.

show id

server1의 장치 ID를 복사하세요. syncthing 장치 ID는 시작 시 자동으로 생성됩니다. 또한 QR코드를 사용하여 syncthing 인스턴스 간에 연결할 수도 있습니다. 예를 들어 컴퓨터와 Android 전화 간에 연결할 수 있습니다.

device id server1

server2로 이동하여 원격 장치 추가를 클릭하여 새 syncthing 인스턴스를 추가하세요.

add remote device

server1의 장치 ID를 붙여넣고 이름을 server1으로 입력한 후 저장을 클릭하여 확인하세요.

add server1

다음으로 server1 대시보드로 돌아가서 server2가 연결하고 싶어하는 정보를 확인하세요. 장치 추가를 클릭하여 server1을 추가하세요.

confirm server2

이제 새 팝업이 나타나면 server2의 장치 ID를 확인한 후 저장을 클릭하세요.

confirm server2

마지막으로 syncthing 대시보드로 이동하여 원격 장치 섹션으로 이동하세요. 프로세스가 성공하면 server2연결됨 상태로 표시됩니다.

server1 connected to server2

반면에 server2를 확인하면 server1연결됨 상태로 표시됩니다.

server2 connected to server1

Syncthing으로 디렉토리 동기화

이제 server1과 server2가 syncthing을 통해 연결되었습니다. 이제 디렉토리/폴더를 공유하고 syncthing 인스턴스 간에 파일을 동기화하는 방법을 배웁니다.

server1 대시보드에서 폴더 섹션을 살펴보면 경로 디렉토리 /home/alice/Sync와 상태 비공유기본 폴더를 찾을 수 있습니다.

기본 폴더를 공유하려면 편집을 클릭하세요.

edit folder

  • 공유 탭으로 이동하면 연결된 syncthing 인스턴스 목록이 표시됩니다. server2를 선택하여 기본 폴더를 syncthing 인스턴스 server2와 공유하세요.
  • 파일 버전 관리 탭으로 이동하여 사용하려는 파일 버전 관리 방법을 선택한 후, 유지할 버전 수를 입력하세요.

저장을 클릭하여 수정 사항을 적용하세요.

share with server2

마지막으로 server2 대시보드로 이동하면 server1이 기본 폴더를 공유하고 싶어한다는 알림 메시지가 표시됩니다. 공유를 클릭하여 확인하세요.

confirm share

프로세스가 완료되면 기본 폴더가 공유되었음을 확인할 수 있습니다.

server1기본 폴더 섹션에서 서버2와 공유됨 섹션에 server2 값이 표시되어야 합니다.

shared directory

server2에서는 기본 폴더서버1과 공유됨 섹션이 표시되어야 합니다.

shared directory

Syncthing 인스턴스 간 파일 동기화

이제 Syncthing을 통해 공유 디렉토리를 구성했으므로, server1에서 새 파일을 생성하고 server2에서 파일 목록을 확인하여 동기화가 작동하는지 확인해 보겠습니다.

server1에서 Sync 디렉토리로 이동하여 다음 명령을 사용하여 새 파일을 생성하세요.

cd ~/Sync/  
touch {1..20}.txt

create files server1

server2로 이동하여 Sync 디렉토리로 가서 해당 디렉토리의 파일 목록을 확인하세요.

cd ~/Sync/  
ls -ah

Sync 디렉토리에 여러 개의 .txt 파일이 표시되면 syncthing 설치가 문제 없이 완료된 것입니다.

여기서 syncthing 인스턴스 간에 새 디렉토리를 생성하고 공유할 수 있으며, 새 인스턴스를 추가할 수도 있습니다.

결론

축하합니다! 우분투 22.04 서버에 Syncthing 설치를 완료했습니다. 또한 UFW(간단한 방화벽)로 syncthing을 보호하는 방법, syncthing 인스턴스 간에 연결하는 방법, 공유 폴더를 설정하는 방법 및 공유 디렉토리 간의 동기화를 확인하는 방법을 배웠습니다.

또한 현재 syncthing 설치에 새 장치를 추가하고 공유 폴더를 설정하여 여러 장치에서 파일에 접근할 수 있습니다.

Share: X/Twitter LinkedIn

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

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