🥮 mooncakes.io

    moonrestore

    Verifiable incremental backups with content-addressed storage and safe restore, powered by MoonBit.

    backup
    restore
    integrity
    deduplication
    Download zip
    Author
    Version
    0.12.0
    License
    Apache-2.0
    Repository
    Last updated
    5 days ago
    Downloads
    65

    #MoonRestore

    用 MoonBit 实现的可验证增量备份与恢复工具。面向论文、代码、实验资料及小团队文件资产：不仅保存历史，还检查损坏范围、演练恢复，并对实际读回留下证据。

    公开源码 · CI · Mooncakes 核心库 · 测试报告 · 更新记录

    #0.12.0：源码工具与 MoonBit 核心库

    0.12补齐格式4/5的元数据页无损换主密钥重建、运输归档和双供体新库修复；MoonBit PagedWriter/GCPlanner 接管分页边界、已落盘页确认和回收批次规划。新增恢复后应用契约（文件/JSON/SQLite附件）、独立追加接收协议、分页远端只读审计、统一恢复/续作工作台，以及按白名单校验的并排安装。源码使用与拒绝预算见 0.12指南，本轮执行与未验证边界见 执行记录。用户已追加授权发布Mooncakes 0.12.0核心库，实际注册表与独立消费者证据见发布记录；不公开运行包。

    #0.11基础与验收边界

    分页恢复续作现由 MoonBit RestoreWriter 决定逐块前缀验证长度、稀疏写出区间、逻辑进度和终结条件；发布状态门禁也在核心验证。Node/系统仍负责身份、真实字节比较、短写循环、fsync、ACL与排他发布，不把纯计划当实际恢复成功。见 0.11使用指南。旧格式和元数据保真边界保留；注册表新版本是否已发布以发布记录为准。

    编译门槛已升至moonc≥0.10.16，本轮私有SDK为0.10.18。第一条“主要实现语言”仍有审查风险：虽然领域核心在MoonBit，JavaScript字节数仍明显更多，分页作业/数据库/系统编排仍有Node逻辑。没有修改Linguist或隐藏源码；node scripts/language-audit.mjs 可复核实际分工，不能仅凭新增接口宣称九条均已无缺口。

    0.11.0核心库已正式发布，moon add bzhangui/moonrestore@0.11.0 可安装；独立注册表消费者在四目标检查、release构建和运行通过。源码 06325b2 的四作业CI全部成功。CLI/工作台仍须源码构建；本轮未公开运行包。

    #0.10.0 历史功能与发布状态

    0.10增加format4/5恢复写出续作：验证自有暂存前缀后继续、完成文件与整树读回、发布不确定性对账；显式新format5归档原生元数据（Windows ACL/ADS、安全属性、稀疏；POSIX xattr/ACL、uid/gid及精确时间；所选内部硬链接）。原生恢复须同平台、显式允许权限且全部读回通过；便携降级必须明确选择并报告损失，不承诺所有文件系统元数据。见 0.10使用指南。旧库不原地改写，本轮仅推送源码，不发布Mooncakes/运行包。

    0.12核心库安装示例为 moon add bzhangui/moonrestore@0.12.0，包含新的分页写入和回收规划API；0.11不含这些新增接口。CLI/工作台仍须按下文源码构建，Mooncakes不是Windows二进制下载。验收进度 与 发布记录 区分当前与历史证据。

    0.9将format4接入普通备份、计划、工作台历史和选择恢复，并增加认证续作、分批巡检、分页加密远端副本、独立救援、保留及WAL诊断等。见 0.9历史指南。历史章节的“本轮/未发布”只描述当时，不替代当前发布状态；旧库不自动转换。

    能力当前行为和边界
    增量备份CDC、SHA-256 内容寻址、跨版本去重；不可变快照、输入预算与中断保护
    严格恢复全量预校验、排他发布新目录；隔离恢复演练独立读回，不覆盖已有目标
    应急救援只读源仓库，逐文件判断可救内容，显式接受部分恢复；损坏文件不补零、不报全量成功
    健康副本重建两个只读来源补齐指定快照的对象或清单，在新仓库完整校验后发布；不原地修复
    恢复准备与巡检独立密钥、无密钥准备清单、持久检查游标、完整周期和新鲜度；不是未来恢复保证
    历史搜索有预算的可重建索引，源变化拒绝旧缓存，加密源索引也加密；不用于恢复或删除决策
    SQLite在线导出、恢复后重新打开及完整性/外键/可选表列行数检查；不保证多库事务或应用业务语义
    S3 兼容副本显式联网，仅加密源，SigV4、条件不覆盖写、读回校验、固定摘要下载；本机模拟通过，真实供应商待验证
    本机工作台任务、历史、选择恢复、会话解锁、进度/取消、应急救援与健康证据；仅回环
    可靠任务与续作私有认证日志；文件级及每1024完整分块检查点、重新读取前缀核对及发布后读回；取消/中断保留旧版本
    统一应用计划文件/SQLite/PostgreSQL，分项证据、容量/源异常及清理保护；默认手动，0.6 源码可显式配置调度，不隐式连接远端
    分段运输归档有界页/段、可选压缩、外部固定根摘要，导入完整审计后新建仓库；不改 live 仓库格式
    PostgreSQL保留逻辑导出；新增物理基准/完整 WAL 归档及 Unix 隔离 PITR 门禁，可信原生工具和源必须显式指定，不自动恢复生产库
    format 4MoonBit 流式验证、128记录/页、8MiB包、私有SQLite索引、加密、完整恢复读回；新仓库显式选择，不原地升级旧格式
    format 5 元数据显式新库，原始ACL/ADS/xattr/时间/内部硬链接及系统报告范围归档；原生恢复独立验证，Windows冻结有效ACL并报告继承差异，不承诺全部文件系统属性
    回收与回滚GC审计全部根后隔离无引用页/包，再等至少7日独立清理；快照退休另需双确认、宽限期及保留点实际恢复演练，默认不启用
    VSS 请求器Windows SDK 可编译的进程自有 copy-backup 生命周期；显式现有管理员会话、写入器检查/精确释放，无提权或活文件回退；真实 VSS 未验证
    独立监控适配可独立部署的认证/TLS接收端、私有持久回执、序号防重放/过期/回退；本机回环不等于已经部署独立主机或告警投递
    日常恢复准备RPO/演练RTO与缺席判断；离线计划有限展示、显式脱敏心跳、白名单配置迁移，不自动移动密钥
    远端只读审计固定回执和成员versionId、摘要/大小及可选服务端保留读回；不是明文恢复或真实供应商验证

    规模上限是拒绝预算，并非性能认证。备份续作仍重读源；恢复续作只接纳认证且内容匹配的自有暂存前缀。缓存不授权清理，新备份成功不修复坏历史。0.12新增格式4/5运输、双供体修复与分页密文版本审计；审计周期累计观测不证明全局唯一库存、明文可恢复或授权删除。真实管理员VSS、独立介质/NAS/跨主机、真实云、物理断电、长期生产和外部用户仍待验证；原生PITR以精确CI为准。系统任务状态无法确认则不注册、不提权；本轮专用演练不处置历史待核查任务。

    #0.5 可靠性入口

    node bin/moonrestore.mjs backup-resumable REPO SOURCE
node bin/moonrestore.mjs operation-resume REPO UUID --recover
node bin/moonrestore.mjs restore-resumable REPO SNAPSHOT_ID NEW_TARGET
node bin/moonrestore.mjs plan-save PRIVATE_CONFIG_JSON
node bin/moonrestore.mjs plan-run PLAN_UUID
node bin/moonrestore.mjs archive-export REPO NEW_ARCHIVE
node bin/moonrestore.mjs archive-import ARCHIVE EXTERNAL_CHECKSUM NEW_REPO

    --recover 仅在原进程停止后使用。工作台支持文件/SQLite/本机 PostgreSQL 计划和显式加密S3副本、分项证据、救援包及续作/新目录恢复；运输归档和新密钥仓库迁移仍使用 CLI。详见 0.7 指南、可靠任务与离线归档。S3 瞬态错误有界重试，403/409、错误版本、坏校验和和重定向不重试成功化。

    #安装与最小示例

    需要 moonc ≥ 0.10.16、Node ≥ 22.16.0（推荐当前 LTS）。Linux/macOS 还需系统 C 工具链用于排他目录提交和元数据帮助程序；Windows使用系统.NET Framework4.x自带C#编译器构建元数据帮助程序，不提权。无 npm 第三方运行依赖。构建优先用可选 .local/toolchain-0.10.18，再查 .local/toolchain，否则使用系统 SDK；可设 MOON_BIN / MOON_HOME。本轮仅安装独立私有SDK，不改变全局配置。

    git clone https://github.com/bzhangui/moonrestore.git
cd moonrestore
moon version --all
npm run build
npm run demo

    demo 只创建临时合成资料，备份两稿并恢复首稿，不接触个人文件。首次构建需联网下载固定依赖；已构建的文件工作流离线运行，S3 命令除外。

    以下路径需替换为自己控制的目录，仓库和恢复目标必须尚不存在，父目录必须存在。Unix 替换盘符，路径含空格时加引号。

    node bin/moonrestore.mjs init "E:/paper-vault"
node bin/moonrestore.mjs plan "E:/paper-vault" "D:/papers" --exclude node_modules
node bin/moonrestore.mjs backup "E:/paper-vault" "D:/papers" --label "初稿" --exclude node_modules
node bin/moonrestore.mjs list "E:/paper-vault"
node bin/moonrestore.mjs verify "E:/paper-vault" all
node bin/moonrestore.mjs restore "E:/paper-vault" SNAPSHOT_ID "D:/recovered-paper"

    ID 为完整 64 位小写十六进制。排除项是精确相对路径前缀，不是通配符。大字节计数为十进制字符串。错误/不完整退出 1，缺构建退出 2。确认结果后再自行处理工作文件，勿为试用删除原件。

    #工作台与运行包

    npm run workbench
node scripts/package.mjs
# Windows x64 内置运行时与原生启动器
npm run package:desktop

    工作台默认 127.0.0.1:8790，须使用控制台提供的完整临时会话链接，不可公开。浏览器不将凭据存入 localStorage。运行 node bin/moonrestore.mjs help 查看命令；索引、运输归档及部分高级参数仍为 CLI，图形向导不代表覆盖全部命令。

    桌面包不需要全局 Node/MoonBit，需系统 .NET Framework 4.x；EXE 尚未代码签名。包仅本地生成，不等于已发布 GitHub Release。不要求关闭系统安全策略。见 桌面包、工作台。

    #0.4 恢复优先用法

    node bin/moonrestore.mjs emergency-preview REPO SNAPSHOT_ID NEW_TARGET
# 复制实际 confirmation，明确接受可能的部分恢复
node bin/moonrestore.mjs emergency-restore REPO SNAPSHOT_ID NEW_TARGET --accept-partial --confirmation HASH
node bin/moonrestore.mjs recovery-checklist REPO NEW_PRIVATE_JSON
node bin/moonrestore.mjs scrub REPO --files 100 --bytes 268435456
node bin/moonrestore.mjs health-status REPO --max-age-hours 168
node bin/moonrestore.mjs index-build REPO
node bin/moonrestore.mjs index-search REPO paper
node bin/moonrestore.mjs sqlite-backup REPO DATABASE_FILE --label "应用备份"

    恢复/重建/巡检/索引 · SQLite 与 VSS 边界 · 远端副本与授权

    #MoonBit 核心与结构

    core/ 实现分块、哈希、清单/路径/属性校验、范围、保留规则与巡检批次；app/ 用 MoonBit 编排备份、校验、恢复及救援；platform/ 用 Node/OS 提供文件、加密、网络、任务；ui/ 为原生 JS/CSS。不是包装 Node 备份库。

    核心支持 JS/Wasm/Wasm-GC/Native；完整磁盘、加密、网络及 GUI 运行时目前依赖 Node，不宣称四目标全具备这些系统能力。

    moon run examples/core --target wasm
# 独立 MoonBit 项目消费正式发布版
moon add bzhangui/moonrestore@0.12.0

    moon.pkg 导入 "bzhangui/moonrestore/core" @backup。见 样例、API。

    #维护与限制

    npm run validate
node scripts/repeat.mjs 3 120
node scripts/history-scale.mjs
node scripts/large-file.mjs
node scripts/package.mjs

    validate 覆盖四目标检查/构建/测试/样例、Node/HTTP/故障回归、三场景、核心覆盖率与包隐私。large-file 至少预留 6 GiB 临时空间。规模测试仅合成资料，不是生产压测。真实浏览器入口见 维护报告。

    默认仓库明文；敏感资料请显式加密，恢复密钥与仓库分开保管。丢失全部解锁方式不能恢复。格式 3 的 64 GiB 单文件/1 TiB 快照是拒绝阈值，不代表上限实测；旧仓库不原地改写。保留/清理默认只预览，隔离与永久清除分别确认。见 格式、运维、安全。

    采用 Apache-2.0，保留 NOTICE 和 第三方来源。私人申报书、密钥、备份、报告、SDK 与运行时缓存不公开。

    Powered by MoonBit

    Site sourceReport issueModulesSkillsCLIBuild queueStatistics

    © 2026 mooncakes.io