리눅스 Rsync 명령어 완전 정복: 사용법과 고급 팁 매뉴얼
Linux Rsync Command Complete Guide
리눅스 시스템 관리에서 파일 동기화와 백업은 필수적인 작업입니다. Rsync는 이러한 작업을 효율적으로 수행할 수 있는 강력한 도구로, 네트워크를 통한 파일 전송과 동기화에서 업계 표준으로 자리잡고 있습니다. 이 포스트에서는 Rsync의 기본 개념부터 고급 활용법까지 상세히 다루어보겠습니다.
🎯 이 글에서 배울 내용
- Rsync의 기본 개념과 작동 원리
- 핵심 옵션과 실무 활용 예제
- SSH를 활용한 안전한 원격 동기화
- 성능 최적화 및 트러블슈팅
- 실제 시나리오별 활용 전략
📋 목차
1. Rsync란 무엇인가? 🤔
Rsync (Remote Sync)는 유닉스 계열 시스템에서 파일과 디렉터리를 효율적으로 동기화하고 전송하는 도구입니다. 1996년 Andrew Tridgell과 Paul Mackerras에 의해 개발된 이후, 시스템 관리자들의 필수 도구로 자리잡았습니다.
✨ Rsync의 주요 특징
🎯 핵심 장점
- 증분 전송: 변경된 부분만 전송하여 대역폭 절약
- 압축 지원: 네트워크 전송 시 데이터 압축으로 속도 향상
- 권한 보존: 파일 권한, 소유자, 타임스탬프 등 메타데이터 유지
- 암호화 지원: SSH를 통한 안전한 원격 전송
- 재개 기능: 중단된 전송을 이어서 진행 가능
🔍 작동 원리
Rsync는 rolling checksum 알고리즘을 사용하여 파일의 변경된 부분만을 식별하고 전송합니다. 이를 통해 전체 파일을 전송할 필요 없이 효율적인 동기화가 가능합니다.
# Rsync 설치 확인 which rsync rsync --version # 대부분의 리눅스 배포판에 기본 설치됨 # Ubuntu/Debian: apt install rsync # CentOS/RHEL: yum install rsync 또는 dnf install rsync
2. 기본 문법과 핵심 옵션 ⚙️
📝 기본 문법
rsync [옵션] 소스 목적지 rsync [옵션] 소스 사용자@호스트:목적지 rsync [옵션] 사용자@호스트:소스 목적지
🔧 핵심 옵션 완전 정리
| 옵션 | 단축형 | 설명 |
|---|---|---|
-v |
--verbose | 상세한 출력 정보 표시 |
-r |
--recursive | 하위 디렉터리까지 재귀적으로 처리 |
-a |
--archive | 아카이브 모드 (-rlptgoD와 동일) |
-z |
--compress | 전송 중 압축 적용 |
-h |
--human-readable | 사람이 읽기 쉬운 형태로 용량 표시 |
-P |
--progress | 진행 상황 표시 (--partial --progress) |
--delete |
- | 소스에 없는 파일을 목적지에서 삭제 |
--dry-run |
-n | 실제 실행 없이 시뮬레이션만 수행 |
--exclude |
- | 특정 파일/디렉터리 제외 |
--include |
- | 특정 파일/디렉터리 포함 |
🌟 자주 사용하는 옵션 조합
💡 추천 옵션 조합
-avzP: 아카이브 모드 + 압축 + 진행상황 표시-avzh --delete: 완전 동기화 (미러링)-avzh --dry-run: 안전한 사전 테스트
3. 실무 활용 예제 💼
📁 로컬 디렉터리 간 동기화
# 기본 복사 rsync -avzh /source/directory/ /destination/directory/ # 진행 상황과 함께 복사 rsync -avzP /home/user/documents/ /backup/documents/ # 삭제된 파일도 동기화 (완전 미러링) rsync -avzh --delete /source/ /destination/ # 특정 파일 형식만 복사 rsync -avzh --include="*.jpg" --include="*.png" --exclude="*" /photos/ /backup/photos/
🌐 원격 서버로 파일 전송
# 로컬에서 원격으로 전송 rsync -avzh /local/directory/ user@remote-server:/remote/directory/ # 원격에서 로컬로 가져오기 rsync -avzh user@remote-server:/remote/directory/ /local/directory/ # 특정 포트를 사용하는 SSH 연결 rsync -avzh -e "ssh -p 2222" /local/directory/ user@server:/remote/directory/ # SSH 키를 사용한 인증 rsync -avzh -e "ssh -i ~/.ssh/my-key" /local/directory/ user@server:/remote/directory/
🔒 보안을 강화한 전송
# SSH 압축과 함께 사용 rsync -avzh -e "ssh -C" /local/directory/ user@server:/remote/directory/ # 대역폭 제한 (1000 KB/s) rsync --bwlimit=1000 -avzh /local/directory/ user@server:/remote/directory/ # 체크섬을 이용한 무결성 검증 rsync -avzh --checksum /source/ /destination/
4. SSH 연동과 보안 🔐
🔑 SSH 키 기반 인증 설정
# SSH 키 생성 ssh-keygen -t rsa -b 4096 -C "your-email@example.com" # 공개 키를 원격 서버에 복사 ssh-copy-id user@remote-server # SSH 에이전트에 키 추가 ssh-add ~/.ssh/id_rsa # Rsync에서 SSH 키 사용 rsync -avzh -e "ssh -i ~/.ssh/id_rsa" /local/ user@server:/remote/
⚡ SSH 성능 최적화
# SSH 설정 파일 (~/.ssh/config) 예제
Host myserver
HostName 192.168.1.100
User myuser
Port 22
IdentityFile ~/.ssh/my-private-key
Compression yes
ServerAliveInterval 60
ServerAliveCountMax 3
# 설정 파일 사용
rsync -avzh /local/directory/ myserver:/remote/directory/
⚠️ 보안 주의사항
- SSH 키는 적절한 권한으로 보호하세요 (600 또는 400)
- 가능한 한 SSH 포트를 기본값(22)에서 변경하세요
- 방화벽 규칙을 적절히 설정하세요
- 정기적으로 SSH 키를 갱신하세요
5. 고급 기능과 팁 🚀
📋 제외/포함 패턴 활용
# 여러 파일 형식 제외 rsync -avzh --exclude="*.tmp" --exclude="*.log" --exclude=".git/" /source/ /dest/ # 제외 목록 파일 사용 echo "*.tmp" > exclude-list.txt echo "*.log" >> exclude-list.txt echo ".git/" >> exclude-list.txt rsync -avzh --exclude-from=exclude-list.txt /source/ /dest/ # 복잡한 패턴 예제 rsync -avzh \ --include="*.jpg" \ --include="*.png" \ --include="*/" \ --exclude="*" \ /photos/ /backup/photos/
🔄 백업 전략: 증분 백업
# 날짜별 백업 디렉터리 생성 BACKUP_DIR="/backup/$(date +%Y-%m-%d)" mkdir -p "$BACKUP_DIR" # 하드링크를 이용한 증분 백업 rsync -avzh --link-dest=/backup/latest /source/ "$BACKUP_DIR"/ ln -nsf "$BACKUP_DIR" /backup/latest # 백업 스크립트 예제 #!/bin/bash SOURCE="/home/user" BACKUP_BASE="/backup" DATE=$(date +%Y-%m-%d_%H-%M-%S) BACKUP_DIR="$BACKUP_BASE/$DATE" LATEST_LINK="$BACKUP_BASE/latest" # 백업 실행 rsync -avzh --delete --link-dest="$LATEST_LINK" "$SOURCE/" "$BACKUP_DIR/" # 최신 링크 업데이트 ln -nsf "$BACKUP_DIR" "$LATEST_LINK"
📊 로그 및 모니터링
# 상세 로그 파일 생성 rsync -avzh --log-file=/var/log/rsync.log /source/ /dest/ # 상태 정보와 함께 실행 rsync -avzh --stats /source/ /dest/ # 진행 상황을 실시간으로 모니터링 rsync -avzh --progress --stats /source/ /dest/ | tee rsync-log-$(date +%Y%m%d).txt
6. 성능 최적화 ⚡
🔧 전송 성능 튜닝
# 대역폭 제한 (KB/s 단위)
rsync --bwlimit=1000 -avzh /source/ /dest/
# 압축 레벨 조정 (1-9, 6이 기본값)
rsync -avzh --compress-level=9 /source/ user@server:/dest/
# 체크섬 알고리즘 선택
rsync -avzh --checksum-choice=md5 /source/ /dest/
# 병렬 전송을 위한 여러 프로세스
# (GNU parallel 사용)
find /source -maxdepth 1 -type d | parallel -j4 rsync -avzh {} /dest/
💾 대용량 파일 처리
# 부분 전송 활성화 (중단 시 재개 가능) rsync -avzh --partial /large-files/ /dest/ # 인플레이스 업데이트 (디스크 공간 절약) rsync -avzh --inplace /source/ /dest/ # 희소 파일 처리 rsync -avzh --sparse /source/ /dest/ # 대용량 파일용 최적화 조합 rsync -avzh --partial --inplace --progress /large-files/ /dest/
💡 성능 최적화 팁
- 네트워크 대역폭: --bwlimit으로 다른 서비스에 영향 최소화
- 압축 설정: CPU와 네트워크 상황에 맞게 조정
- 체크섬 방식: 작은 파일은 --checksum, 큰 파일은 기본 설정
- SSH 압축: -e "ssh -C"로 SSH 레벨에서도 압축 적용
7. 트러블슈팅 🔍
❌ 자주 발생하는 문제와 해결법
🔐 권한 문제
# 권한 오류 시 해결법 # 1. 소유자 정보 무시 rsync -avzh --no-owner --no-group /source/ /dest/ # 2. 권한 정보 무시 rsync -rvzh --no-perms /source/ /dest/ # 3. 관리자 권한으로 실행 sudo rsync -avzh /source/ /dest/
🌐 네트워크 연결 문제
# 타임아웃 설정 rsync -avzh --timeout=30 /source/ user@server:/dest/ # 재시도 횟수 설정 rsync -avzh --timeout=30 --contimeout=10 /source/ user@server:/dest/ # 연결 상태 확인 rsync -avzh --dry-run user@server:/source/ /dest/
💾 디스크 공간 부족
# 디스크 사용량 확인 df -h # 부분 전송으로 공간 효율성 개선 rsync -avzh --partial --inplace /source/ /dest/ # 임시 파일 위치 변경 rsync -avzh --temp-dir=/tmp/large-temp /source/ /dest/
🐛 디버깅 및 로그 분석
# 상세 디버그 정보 rsync -avzh --debug=ALL /source/ /dest/ # 특정 모듈 디버깅 rsync -avzh --debug=FILTER /source/ /dest/ # 로그 레벨 조정 rsync -avzh --verbose --verbose /source/ /dest/ # 오류만 출력 rsync -avzh --quiet /source/ /dest/ 2>&1 | grep -i error
⚠️ 주의사항
- --delete 옵션: 실수로 중요한 파일을 삭제할 수 있음
- 경로 끝의 슬래시: /source/와 /source는 다른 결과를 만듦
- 심볼릭 링크: -L 옵션으로 링크 대상을 복사할지 결정
- 네트워크 안정성: 불안정한 연결에서는 --partial 사용 권장
8. 실무 시나리오 🏢
🎯 시나리오 1: 웹사이트 배포
#!/bin/bash # 웹사이트 배포 스크립트 # 설정 LOCAL_DIR="/var/www/html" REMOTE_SERVER="web-server.example.com" REMOTE_DIR="/var/www/html" BACKUP_DIR="/backup/website-$(date +%Y%m%d-%H%M%S)" # 원격 서버 백업 ssh user@$REMOTE_SERVER "mkdir -p /backup" rsync -avzh user@$REMOTE_SERVER:$REMOTE_DIR/ $BACKUP_DIR/ # 새 버전 배포 rsync -avzh --delete \ --exclude=".git/" \ --exclude="*.log" \ --exclude="config/local.php" \ $LOCAL_DIR/ user@$REMOTE_SERVER:$REMOTE_DIR/ echo "배포 완료. 백업: $BACKUP_DIR"
💾 시나리오 2: 데이터베이스 백업 동기화
#!/bin/bash # 데이터베이스 백업 동기화 스크립트 DB_NAME="myapp" BACKUP_LOCAL="/backup/db" BACKUP_REMOTE="backup-server:/backup/db" DATE=$(date +%Y%m%d) # 데이터베이스 덤프 mysqldump -u root -p$DB_PASSWORD $DB_NAME | gzip > $BACKUP_LOCAL/db-$DATE.sql.gz # 원격 백업 서버로 동기화 rsync -avzh --delete \ --include="*.sql.gz" \ --exclude="*" \ $BACKUP_LOCAL/ $BACKUP_REMOTE/ # 30일 이상 된 백업 파일 삭제 find $BACKUP_LOCAL -name "*.sql.gz" -mtime +30 -delete
📱 시나리오 3: 개발 환경 동기화
#!/bin/bash
# 개발 환경 동기화 스크립트
PROJECT_DIR="/home/developer/projects/myapp"
DEV_SERVER="dev.example.com"
STAGING_SERVER="staging.example.com"
# 개발 서버에서 스테이징으로 동기화
sync_to_staging() {
rsync -avzh --delete \
--exclude="node_modules/" \
--exclude=".env.local" \
--exclude="*.log" \
--exclude=".git/" \
developer@$DEV_SERVER:$PROJECT_DIR/ \
developer@$STAGING_SERVER:$PROJECT_DIR/
}
# 로컬에서 개발 서버로 동기화
sync_to_dev() {
rsync -avzh \
--exclude="node_modules/" \
--exclude=".env.local" \
--exclude="*.log" \
$PROJECT_DIR/ developer@$DEV_SERVER:$PROJECT_DIR/
}
case "$1" in
"staging")
sync_to_staging
;;
"dev")
sync_to_dev
;;
*)
echo "사용법: $0 {staging|dev}"
exit 1
;;
esac
🔄 시나리오 4: 실시간 동기화 (inotify 활용)
#!/bin/bash
# 실시간 파일 동기화 스크립트
SOURCE_DIR="/home/user/documents"
DEST_DIR="backup-server:/backup/documents"
LOCK_FILE="/tmp/rsync-monitor.lock"
# 이미 실행 중인지 확인
if [ -f "$LOCK_FILE" ]; then
echo "이미 실행 중입니다."
exit 1
fi
# 락 파일 생성
touch "$LOCK_FILE"
# 종료 시 락 파일 제거
trap "rm -f $LOCK_FILE" EXIT
# 실시간 모니터링 및 동기화
inotifywait -m -r -e modify,create,delete,move "$SOURCE_DIR" |
while read path action file; do
echo "변경 감지: $path$file ($action)"
# 짧은 지연 후 동기화 (연속 변경 처리)
sleep 2
rsync -avzh --delete "$SOURCE_DIR/" "$DEST_DIR/"
if [ $? -eq 0 ]; then
echo "동기화 완료: $(date)"
else
echo "동기화 실패: $(date)"
fi
done
📝 정리 및 베스트 프랙티스
✅ Rsync 사용 체크리스트
- 사전 테스트: 항상 --dry-run으로 먼저 확인
- 백업 준비: 중요한 데이터는 사전 백업
- 권한 확인: 소스와 목적지의 권한 설정 점검
- 네트워크 상태: 안정적인 연결 환경에서 실행
- 로그 관리: 작업 기록을 남겨 추후 분석 가능하도록
🎯 상황별 권장 옵션
- 일반 백업:
rsync -avzh --progress - 완전 미러링:
rsync -avzh --delete - 원격 전송:
rsync -avzh -e ssh - 대용량 파일:
rsync -avzh --partial --inplace - 느린 네트워크:
rsync -avzh --compress-level=9 --bwlimit=500
🚨 주의해야 할 함정들
- 경로 끝의 슬래시:
/dir/와/dir는 다른 결과 - --delete 옵션: 신중하게 사용, 중요 파일 삭제 위험
- 심볼릭 링크: -l, -L, -k 옵션의 차이점 이해
- 권한 문제: sudo 사용 시 소유자 변경 주의
- 문자 인코딩: 다른 시스템 간 파일명 문제 가능
Rsync는 단순해 보이지만 매우 강력하고 유연한 도구입니다. 이 가이드에서 제시한 예제들을 바탕으로 실제 환경에서 테스트해보시고, 각자의 요구사항에 맞게 옵션을 조합해 사용하시기 바랍니다. 효율적인 파일 동기화와 백업으로 시스템 관리의 생산성을 크게 향상시킬 수 있을 것입니다.
🔗 추가 리소스
- 공식 문서:
man rsync또는 rsync.samba.org - 고급 가이드: Arch Linux Rsync Wiki
- 성능 튜닝: Rsync Performance Analysis