| 格式 | 模式 | 範例 |
|---|---|---|
rsync [OPT] SRC DEST | 本地複製 | rsync -a /data /backup |
rsync [OPT] SRC [USER@]HOST:DEST | 本地 → 遠端 (Shell) | rsync -avz *.c user@host:src/ |
rsync [OPT] [USER@]HOST:SRC DEST | 遠端 → 本地 (Shell) | rsync -avz user@host:src/ /data |
rsync [OPT] [USER@]HOST::SRC DEST | 遠端 rsync daemon → 本地 | rsync -av root@172.16.78.192::www /databack |
rsync [OPT] SRC [USER@]HOST::DEST | 本地 → 遠端 rsync daemon | rsync -av /databack root@172.16.78.192::www |
rsync [OPT] rsync://[USER@]HOST[:PORT]/SRC [DEST] | 列出/同步 rsync daemon 模組 | rsync -v rsync://172.16.78.192/www |
-v, --verbose 詳細;-q, --quiet 精簡。--progress 顯示傳輸進度;--stats 傳輸統計。-a, --archive = -rlptgoD (遞歸、連結、權限、時間、擁有者、群組、裝置) — **最常用**。-r, --recursive 遞歸目錄。-l, --links 保留符號連結;-L, --copy-links 複製連結指向的實體檔。-H, --hard-links 保留硬連結。-p, --perms 保留權限;-o, --owner 保留擁有者;-g, --group 保留群組。-t, --times 保留修改時間。-D, --devices 保留裝置檔。-S, --sparse 稀疏檔案優化。-u, --update 僅更新較新檔案 (跳過目標較新者)。--delete 刪除目標端來源不存在的檔案 (鏡像模式)。--delete-excluded 同步刪除被排除的檔案。--delete-after 傳輸完成後再刪除。--ignore-errors 即使 I/O 錯誤也執行刪除。--max-delete=N 最大刪除檔案數保護。--partial 保留部分傳輸檔案以便續傳 (同 -P)。--exclude=PATTERN 排除模式。--include=PATTERN 強制包含 (需配合 exclude 使用)。--exclude-from=FILE / --include-from=FILE 從檔案讀取模式。-C, --cvs-exclude 自動忽略 CVS/.git 等版控目錄。-z, --compress 傳輸時壓縮 (LAN 可關閉)。-e, --rsh=COMMAND 指定遠端 Shell (預設 ssh)。--bwlimit=KBPS 限制頻寬 (KB/s)。--block-size=SIZE 校驗塊大小 (預設 700 bytes)。--timeout=SECONDS 連線逾時。--rsync-path=PATH 指定遠端 rsync 完整路徑。--password-file=FILE 非互動式密碼 (daemon 模式)。--log-format=FORMAT 自訂日誌格式。-n, --dry-run 試運行 (不實際寫入)。-W, --whole-file 全檔複製 (關閉增量演算法,適合高頻寬低延遲)。-x, --one-file-system 不跨越檔案系統。
# 1. 生產環境備份至異地 (SSH、壓縮、保留屬性、刪除多餘、限速 10MB/s)
rsync -avz --delete --bwlimit=10240 -e "ssh -p 2222" /data/ backup@10.0.0.5:/backup/data/
# 2. 同步網站程式碼 (排除 .git、vendor、log、cache)
rsync -avz --delete \
--exclude='.git/' --exclude='vendor/' --exclude='var/log/' --exclude='var/cache/' \
/var/www/html/ web@staging:/var/www/html/
# 3. 僅同步最近 1 天修改的檔案
find /data -type f -mtime -1 -print0 | rsync -avz --files-from=- --from0 /data/ remote:/backup/