..
2026-07-28 20:43:46 +08:00

drosync POC source contract

当前上传内容校验采用 MD5,协议 v2 / 本地 schema 7;历史 SHA256 内容回执退出支持。切换步骤见 MD5 说明。

drosync is the supported one-way synchronization path from customer-owned local directories to Baidu Object Storage (BOS). It is not a mounted filesystem: v1 does not download, propagate remote deletion, merge file contents, preserve POSIX ownership/mode, follow symlinks, or create empty remote directories.

Frozen scope

  • Control plane: existing Go API plus the drosync-coordinator asynchronous worker.
  • Client: Rust CLI, daemon, read-only Web report viewer, updater, and SQLite crash journal.
  • UI: /object-sync with role-specific administration, operations, release, and audit surfaces.
  • Targets: Windows 10/11 x86_64, Ubuntu 22.04/24.04 x86_64/ARM64, and macOS 13+ arm64.
  • Limits per session: 1,000,000 files, 1 TiB per object, 20 TiB total; 500 devices per organization and at most 16 client data requests per device.
  • Retention: session/item 90 days, versions/audit 1 year, heads indefinitely, staging/multipart 24 hours, conflicts indefinitely.

Document map

Safety invariant

A space starts blocked/unverified. A successful If-None-Match: * probe permits create-only operation. Original-key update is available only after conditional update and conditional multipart completion probes pass and an administrator explicitly confirms that the shared prefix has no platform-external writer. Any observed drift disables the space. The UI cannot bypass these gates.

当前入口约束:功能入口唯一性。CLI 是唯一操作入口;Web 只读;GUI 和旧命令别名退出支持。历史验收报告保留原始记录,不作为当前命令手册。