설치
# 다운로드 페이지에서 자신의 컴퓨터에 맞는 다운로드 url을 확인하고 복사
# 터미널에서 파일 다운로드
wget 위에서 확인한 url
# wget: 파일을 인터넷에서 다운로드하는 명령어
wget https://github.com/syncthing/syncthing/releases/download/v1.30.0/syncthing-linux-arm64-v1.30.0.tar.gz
# 압축 풀기
tar -xvf 파일명
tar -xvf syncthing-linux-arm64-v1.30.0.tar.gz
# tar: .tar.gz 파일(압축파일)을 해제
# -xvf: eXtract(추출), Verbose(상세출력), File(파일지정)
# 실행 파일 위치로 이동
cd 파일명
cd syncthing-linux-arm64-v1.30.0
# syncthing 바이너리를 시스템 경로(/usr/local/bin)로 복사
sudo cp syncthing /usr/local/bin
# /usr/local/bin은 시스템이 실행 파일을 자동으로 찾는 곳입니다.
# sudo 관리자 권한
# 설치 확인
syncthing --version
# 정상적으로 설치되었다면 syncthing 버전 정보가 표시됩니다.
apt명령어로 설치 링크의 가이드대로 명령어를 순서대로 실행
서비스 등록 및 실행
systemctl --user enable syncthing.service
systemctl --user start syncthing.service
# 또는
systemctl --user enable --now syncthing.service
# 재실행
systemctl --user restart syncthing
정상적으로 실행되었는지 확인
# 일반적으로 서비스화되어 구동 중인 경우:
systemctl status syncthing
systemctl status syncthing.service
# 사용자 단위(systemd user 서비스)로 구동 중일 경우
# (일반적으로 데스크탑이나 서버에서 개인 사용자로 동작시켰을 때)
systemctl --user status syncthing.service
# 서비스가 시스템(또는 사용자) 로그인시 자동시작되게 설정되었는지 확인하려면:
systemctl --user is-enabled syncthing.service
설치한 웹브라우저에서 아래 주소로 확인
http://127.0.0.1:8384
외부에서 브라우저로 접속시 페이지가 열리지 않은 경우
서비스가 정상 설치/작동중인지 확인
8384 포트 방화벽 오픈 확인 클라우드 서버인 경우 클라우드 방화벽 설정 확인 리눅스(우분투)의 자체 sw방화벽 설정 확인(iptables 등)
Syncthing 웹 UI가 바인딩된 주소 확인
Syncthing의 기본 GUI 리슨 주소는 127.0.0.1:8384입니다.
만약 외부(IP)에서 접속하려면 Syncthing의 웹 GUI 설정에서 Listen Address를 0.0.0.0:8384 또는 해당 서버 IP로 바꿔야 합니다.
이 설정을 변경하지 않았다면 서버 자체에서만 접속 가능하며, 외부에서 접속하면 연결이 거부됩니다.
설정 변경 방법
Syncthing 설정 파일(config.xml) 직접 수정
(보통 ~/.local/state/syncthing/config.xml, ~/.config/syncthing/config.xml 위치)
<gui> 항목의 <address> 값을 0.0.0.0:8384 등으로 변경하고 Syncthing을 재시작
<gui><address>0.0.0.0:8384</address></gui>
systemctl --user restart syncthing.service
삭제
sudo apt remove syncthing
# syncthing** 패키지(프로그램)만 삭제합니다.
sudo apt purge syncthing
# syncthing 패키지 + 설정 파일까지 함께 삭제합니다.
sudo apt autoremove
# 더 이상 필요 없는 관련 의존 패키지(부가 설치된 파일) 자동 정리.
rm -rf ~/.config/syncthing
## Syncthing 사용자 설정 폴더 삭제 (완전 삭제용)
# 사용자의 홈 디렉토리에 저장된 Syncthing 설정·로그 파일 등을 완전히 지웁니다.