설치 가이드 · 5 min read · Dec 18, 2025
우분투 22.04에 Syncthing 설치하는 방법

Syncthing은 Windows, macOS, Linux, Android, Solaris, Darwin 및 BSD와 같은 여러 플랫폼을 위한 안전하고 오픈 소스 파일 동기화 프로그램입니다. 이는 로컬 네트워크의 장치 간 또는 인터넷을 통한 원격 장치 간에 파일을 동기화할 수 있는 분산형 P2P(피어 투 피어) 파일 동기화 도구입니다.
이 튜토리얼에서는 우분투 22.04 서버에 Syncthing을 설치하는 방법을 보여드리겠습니다. 그런 다음 Syncthing 인스턴스 간의 연결을 설정하고, 디렉토리 동기화를 설정하고, 동기화를 확인하는 방법을 배우게 됩니다.
전제 조건
이 튜토리얼을 시작하려면 다음이 필요합니다:
- 두 대의 우분투 22.04 머신 - 이 예제에서는 두 대의 우분투 서버 server1과 server2를 사용합니다.
- 관리자 권한이 있는 비루트 사용자.
Syncthing 저장소 추가
Syncthing은 여러 방법으로 설치할 수 있으며, 바이너리 파일을 통해 수동으로 설치하거나 우분투의 APT를 통해 설치할 수 있습니다. 이 예제에서는 두 대의 우분투 머신에 공식 저장소를 추가하여 APT를 통해 syncthing을 설치합니다.
시작하려면, 우분투 시스템에 몇 가지 기본 패키지를 설치하기 위해 다음 명령을 실행하세요.
sudo apt install gnupg2 curl apt-transport-https -y
이제 두 대의 우분투 시스템에 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
그런 다음, 다음 명령을 사용하여 우분투 저장소를 업데이트하고 새로 고칩니다.
sudo apt updatesyncthing 저장소가 사용 가능하다는 메시지가 표시되면 준비가 완료된 것입니다.

Syncthing 설치
이제 두 대의 우분투 머신에 syncthing 저장소를 추가했으므로, 다음 단계는 두 대의 머신에 설치하고 systemd 서비스로 실행하도록 구성하는 것입니다. 또한, 두 머신 모두에서 syncthing을 실행할 비루트 사용자가 있는지 확인하세요.
syncthing을 설치하려면 다음 apt 명령을 실행하세요. 설치를 진행하려면 y를 입력하고 ENTER를 누르세요.
sudo apt install syncthing
설치가 완료되면 다음과 같이 syncthing 버전을 확인하세요:
syncthing --version
syncthing -h다음 출력에서 syncthing 1.26이 설치되어 있어야 합니다.

이제 syncthing을 설치했으므로 사용자별로 시작해야 합니다. 이 예제에서는 server1에서 사용자 alice를, server2에서 사용자 bob을 사용할 것입니다.
아래 명령을 사용하여 사용자로 로그인하세요.
su - alice그런 다음, 아래와 같은 명령을 사용하여 사용자 alice에 대한 syncthing 서비스를 시작하고 활성화하세요:
sudo systemctl start [email protected]
sudo systemctl enable [email protected]요청 시 루트 권한을 얻기 위해 비밀번호를 입력해야 합니다:

이제 아래 명령을 사용하여 syncthing 서비스가 실행 중인지 확인하세요.
sudo systemctl status [email protected]사용자 alice에 대한 syncthing 서비스가 실행 중이어야 합니다. 또한 두 서버 모두에서 syncthing 서비스가 실행 중인지 확인하세요.

방화벽 설정
이 가이드에서는 두 대의 우분투 머신에서 방화벽을 활성화합니다. 우분투에서는 UFW(간단한 방화벽)를 사용할 수 있으며, 기본적으로 syncthing은 UFW 애플리케이션 프로필도 제공하므로 쉽게 활성화할 수 있습니다.
아래 명령을 실행하여 syncthing 및 syncthing-gui 프로필을 UFW에 추가하세요.
sudo ufw allow syncthing
sudo ufw allow syncthing-gui이제 OpenSSH 프로필을 추가한 후, 아래 명령을 사용하여 UFW를 시작하고 활성화하세요. 작업을 확인하려면 y를 입력하세요.
sudo ufw allow OpenSSH
sudo ufw enable완료되면 다음과 같은 출력이 표시됩니다.

다음으로, 아래 명령을 사용하여 UFW에서 활성화된 규칙 및 프로필 목록을 확인하세요.
sudo ufw status verbosesyncthing 및 syncthing-gui가 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‘
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을 설정하세요.

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

새 비밀번호가 구성된 후, syncthing 인증이 요청됩니다.
사용자 이름과 비밀번호를 입력한 후 로그인을 클릭하세요.

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

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

두 Syncthing 인스턴스 연결
두 대의 우분투 머신에서 Syncthing을 구성한 후, 파일을 동기화할 수 있도록 연결합니다. 이를 위해 GUI를 통해 두 머신을 확인해야 합니다.
server1에서 오른쪽 상단의 작업 버튼을 클릭한 다음 ID 표시를 선택하세요.

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

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

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

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

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

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

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

Syncthing으로 디렉토리 동기화
이제 server1과 server2가 syncthing을 통해 연결되었습니다. 이제 디렉토리/폴더를 공유하고 syncthing 인스턴스 간에 파일을 동기화하는 방법을 배웁니다.
server1 대시보드에서 폴더 섹션을 살펴보면 경로 디렉토리 /home/alice/Sync와 상태 비공유인 기본 폴더를 찾을 수 있습니다.
기본 폴더를 공유하려면 편집을 클릭하세요.

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

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

프로세스가 완료되면 기본 폴더가 공유되었음을 확인할 수 있습니다.
server1의 기본 폴더 섹션에서 서버2와 공유됨 섹션에 server2 값이 표시되어야 합니다.

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

Syncthing 인스턴스 간 파일 동기화
이제 Syncthing을 통해 공유 디렉토리를 구성했으므로, server1에서 새 파일을 생성하고 server2에서 파일 목록을 확인하여 동기화가 작동하는지 확인해 보겠습니다.
server1에서 Sync 디렉토리로 이동하여 다음 명령을 사용하여 새 파일을 생성하세요.
cd ~/Sync/
touch {1..20}.txt
server2로 이동하여 Sync 디렉토리로 가서 해당 디렉토리의 파일 목록을 확인하세요.
cd ~/Sync/
ls -ahSync 디렉토리에 여러 개의 .txt 파일이 표시되면 syncthing 설치가 문제 없이 완료된 것입니다.
여기서 syncthing 인스턴스 간에 새 디렉토리를 생성하고 공유할 수 있으며, 새 인스턴스를 추가할 수도 있습니다.
결론
축하합니다! 우분투 22.04 서버에 Syncthing 설치를 완료했습니다. 또한 UFW(간단한 방화벽)로 syncthing을 보호하는 방법, syncthing 인스턴스 간에 연결하는 방법, 공유 폴더를 설정하는 방법 및 공유 디렉토리 간의 동기화를 확인하는 방법을 배웠습니다.
또한 현재 syncthing 설치에 새 장치를 추가하고 공유 폴더를 설정하여 여러 장치에서 파일에 접근할 수 있습니다.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.