如何最大化B2 Command Line Tool的sync命令多线程、正则排除与dry-run参数全解析【免费下载链接】B2_Command_Line_ToolThe command-line tool that gives easy access to all of the capabilities of B2 Cloud Storage项目地址: https://gitcode.com/gh_mirrors/b2/B2_Command_Line_ToolB2 Command Line Tool 是 Backblaze B2 云存储的官方命令行工具一条sync命令就能完成本地与云端之间的文件同步。这篇文章带你吃透 sync 命令的三大核心能力多线程并发、正则排除规则与 dry-run 模拟运行让你的 B2 备份和迁移又快又稳。sync 命令能做什么sync是 B2 CLI 中功能最强的子命令支持四种同步方向 本地文件夹 → B2 存储桶上传备份 B2 存储桶 → 本地文件夹下载恢复 B2 桶 → 另一个 B2 桶跨桶迁移 同一 B2 桶内不同目录之间目录整理B2 路径使用b2://桶名/前缀格式例如b2://my-bucket-name/a/path/prefix/。先完成安装和授权只需一次pip install b2 b2 authorize-account之后最基础的同步命令形如b2 sync /local/folder b2://my-bucket/backup/完整的参数定义位于 b2/_internal/console_tool.py各版本命令注册逻辑见 b2/_internal/b2v3/sync.py 与 b2/_internal/b2v4/registry.py。多线程参数如何调出最高同步速度sync 默认使用10 个线程但你可以精细控制三类并发参数作用默认值--threads一键同时设置下面三项10--sync-threads并行处理的文件数量10--upload-threads并行上传的文件/分片数10--download-threads并行下载的文件/分片数10调参技巧⚡千兆网络 大量小文件把--threads调高到 20~50上传下载明显提速弱网或办公室共享带宽官方明确建议减少线程数甚至只用 1 个线程避免影响其他同事注意--threads不能与三个细分参数混用混用会直接报错逻辑见 b2/_internal/console_tool.py。经验法则是文件越大--upload-threads/--download-threads越重要分片并行传输文件越多越小--sync-threads越重要并行扫描与调度。正则排除精准控制哪些文件不参与同步这是 sync 最实用的能力之一共四个正则参数--exclude-regex—— 忽略匹配的文件。模式针对文件完整路径做 Python 正则匹配--include-regex—— 在排除中捞回指定文件⚠️ 必须搭配--exclude-regex使用单独使用会报错--exclude-dir-regex—— 排除整个目录目录内文件一律跳过即使命中 include 规则也不看目录内部--exclude-all-symlinks—— 从本地同步时跳过所有符号链接。两条关键规则一条命令里可用竖线|分隔多条正则例如同时排除.DS_Store和.Spotlight-V100正则按从第一个字符开始的子串匹配判定所以.*e会匹配hello。想匹配完整路径请在末尾加$锚定如.*llo$。一个典型示例——备份时排除 macOS 垃圾文件和构建目录b2 sync ./project b2://my-bucket/project/ \ --exclude-regex .*\.DS_Store$ --exclude-dir-regex .*node_modules 用--exclude-dir-regex排除无读权限的目录还能顺带避免权限报错非常实用。正则规则的管理逻辑封装在ScanPoliciesManager参见 b2/_internal/console_tool.py。dry-run 参数先模拟后执行零风险同步--dry-run是新手和运维人员都该养成的习惯它只打印将要执行的操作清单不真正上传、下载或删除任何文件。三个最佳使用场景首次同步前先跑b2 sync ... --dry-run确认文件范围和方向没有搞反⚠️配合--delete使用想删除目标端多余文件前先用 dry-run 预览将被删除的完整清单确认无误再真正执行排查比较策略搭配--verbose --dry-run可以看到文件的修改时间/大小差异判断哪些文件会被重新同步。b2 sync ./project b2://my-bucket/project/ --delete --dry-run --verbosedry-run 标志从命令行解析后直接传给 Synchronizer实现见 b2/_internal/console_tool.py。进阶参数组合让同步策略更智能参数用途--compare-versions none / modTime / size文件比较策略默认按修改时间--compare-threshold模糊比较阈值毫秒/字节范围内视为相同减少重复传输--delete删除目标端源端没有的文件与--keep-days互斥--keep-days N保留旧版本 N 天后删除官方比--delete更推荐因为误删后有时间恢复--skip-newer / --replace-newer目标文件更新时跳过 / 强制用源端覆盖--allow-empty-source允许源目录为空时继续否则直接报错防止误清空桶--no-progress隐藏进度条适合脚本日志 想让目标端与源端完全一致推荐组合是--delete --replace-newer如果担心误删把--delete换成--keep-days 30就安全得多。新手常见坑点清单❌--include-regex单独使用 → 报错必须先有--exclude-regex❌--threads与--upload-threads混用 → 报错❌ 源目录为空或不存在 → 同步失败这是保护机制加--allow-empty-source才能继续❌ 正则没加$锚定 → 意外匹配大量文件❌ 同步出现警告或错误时命令退出码为 1写脚本时务必检查退出码这些行为的边界情况在项目测试中有完整覆盖可参考 test/integration/test_b2_command_line.py命令帮助文档源文件见 doc/source/commands.rst 和 doc/source/quick_start.rst。总结一条命令的黄金模板把今天的干货浓缩成一个可复用的黄金模板b2 sync /local/data b2://my-bucket/data/ \ --threads 20 \ --exclude-regex .*\.log$|.*\.tmp$ \ --exclude-dir-regex .*cache \ --keep-days 30 \ --dry-run # 首次执行务必保留确认无误后去掉掌握多线程调参 正则排除 dry-run 预演这三件套你就解锁了 B2 Command Line Tool 中最高效的文件同步工作流——无论是每日增量备份、网站静态资源发布还是跨桶数据迁移一条 sync 命令全部搞定。【免费下载链接】B2_Command_Line_ToolThe command-line tool that gives easy access to all of the capabilities of B2 Cloud Storage项目地址: https://gitcode.com/gh_mirrors/b2/B2_Command_Line_Tool创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考