[Docker] lsyncd (로컬) 데이터 이중화 docker-compose.yaml 구성

 

서버 데이터를 외장 하드나 다른 디스크에 실시간으로 백업(미러링) 하고 싶을 때,
Lsyncd는 매우 강력한 선택이다.

이 글에서는 Docker 환경에서 Lsyncd를 구성해, 재부팅 후에도 자동으로 동작하는 하드 백업 시스템을 완성하도로 하겠다.

---

우선 Lsyncd란?

Lsyncd(Live Syncing Daemon)는 Linux의 inotify 기능을 활용해,
특정 폴더의 변경을 실시간 감지하고 rsync로 동기화하는 데몬이다.

즉, 파일이 추가·수정·삭제될 때마다 대상 폴더에 자동 반영한다.
→ “실시간 미러링 백업” 과 동일한 효과를 낸다.

 

---

구성 방식

[호스트: /data] ←→ [Docker 컨테이너: lsyncd] ←→ [외장하드: /backup]

• /data: 원본 데이터가 있는 폴더 (예: 서버 데이터, 로그, 프로젝트 파일 등)
• /backup: 외장 하드 마운트 경로 (동기화 대상)
• lsyncd: Docker 컨테이너로 동작하며 실시간 감시 + 동기화 수행

 

---

1. 폴더 준비

먼저, 동기화할 폴더와 백업 폴더를 만든다.

sudo mkdir -p /data sudo mkdir -p /backup

 

이제 외장하드를 /backup 경로에 마운트한다.
UUID 기반으로 자동 마운트되도록 /etc/fstab에 등록해두는 게 좋다.

 

sudo blkid # 외장하드의 UUID 확인

sudo vi /etc/fstab # 맨 아랫줄에 예시 추가

 

 

예시:

UUID=1234-ABCD /backup ext4 defaults 0 0

 

 

적용:

sudo mount -a

 

 

 

---

2. Dockerfile 작성

lsyncd를 Docker로 실행할 수 있도록 이미지 구성을 만든다.

 

Dockerfile

FROM ubuntu:22.04

RUN apt-get update && \
    apt-get install -y lsyncd rsync && \
    mkdir -p /etc/lsyncd /sync_source /sync_target

COPY lsyncd.conf.lua /etc/lsyncd/lsyncd.conf.lua

CMD ["lsyncd", "-nodaemon", "/etc/lsyncd/lsyncd.conf.lua"]

 

 

 

---

3. Lsyncd 설정파일 작성

lsyncd.conf.lua

settings {
    logfile = "/var/log/lsyncd.log",
    statusFile = "/var/log/lsyncd.status",
    maxDelays = 5,
}

sync {
    default.rsync,
    source = "/sync_source",
    target = "/sync_target",
    rsync = {
        archive = true,
        compress = false,
        verbose = true,
    }
}

 

주요 옵션 설명

항목	설명
logfile	로그 경로
inotifyMode	변경 감지 모드 (CloseWrite는 파일 닫힐 때 감지)
maxDelays	동기화 지연 최대 시간 (초 단위)
archive	파일 소유자/권한/타임스탬프 유지
--delete	원본에서 삭제된 파일은 대상에서도 삭제 (완전 미러링)

---

4. docker-compose.yml 작성

docker-compose.yml

version: "3.8"

services:
  lsyncd:
    build: .
    container_name: lsyncd_backup
    volumes:
      - /data:/sync_source:ro
      - /backup:/sync_target
      - ./lsyncd.conf.lua:/etc/lsyncd/lsyncd.conf.lua:ro
    restart: unless-stopped

 

/data는 읽기 전용(:ro)로 마운트해 원본을 보호하고,
/backup은 쓰기 가능으로 두어 복제 작업이 가능하게 한다.

---

5. 실행하기

docker compose up -d # -d 옵션을 빼면 현재 상태를 바로 확인

 

정상 실행되면 Lsyncd가 /data 폴더의 변경을 실시간 감지하여
/backup에 자동으로 반영한다.

 

 

로그 확인:

docker logs -f lsyncd_backup

 

---

6. 재부팅 후 자동 실행

Compose 파일의 restart: unless-stopped 옵션 덕분에
Docker 데몬이 부팅될 때 Lsyncd 컨테이너가 자동 재시작된다.

 

확인:

sudo systemctl is-enabled docker

 

만약 비활성이라면:

sudo systemctl enable docker

 

이제 서버가 재부팅돼도 자동 백업이 유지된다.

 

---

7. Docker 권한 구조 이해

Lsyncd 컨테이너는 컨테이너 내부에서 root 권한으로 동작한다.
하지만 호스트 전체의 root 권한은 아니다.

 

권한 종류	설명
컨테이너 내부 root	있음
호스트 전체 root	없음
마운트된 디렉토리 조작	가능
시스템 설정 / 커널 접근	불가능

즉, /data, /backup 폴더 내의 파일 읽기/쓰기/삭제는 가능하지만
호스트 OS 자체에는 영향을 주지 않는다.

 

⚠️ --privileged 옵션을 주면 호스트의 root 권한과 거의 동일해지지만,
보안상 매우 위험하므로 절대 추천하지 않는다.

---

8. 실제 동작 예시

1️⃣ /data에 파일을 생성

echo "test" > /data/example.txt

2️⃣ /backup 확인

cat /backup/example.txt

3️⃣ /data에서 파일 삭제

rm /data/example.txt

→ 잠시 후 /backup/example.txt도 자동 삭제됨.

 

---

결론

• 실시간 변경 감지 (inotify 기반)
• Docker로 환경 분리
• 재부팅 후에도 자동 실행
• 원본 보호 (:ro 마운트)
• 호스트 시스템에 영향 없음

단점이라면, Docker를 통한 오버헤드가 아주 약간 존재한다는 점 정도다.
하지만 안전하고, 유지보수가 쉬우며, 이식성이 높다.

 

---

 

💡 이 설정을 기반으로, NAS나 백업 서버 자동화에도 확장 가능하다.
예를 들어 /backup을 NFS나 SMB 공유 폴더로 연결해 네트워크 백업 시스템으로도 손쉽게 확장할 수 있다.