borg

这里是borg2！

请注意,这是borg2/master分支的README。

稳定版文档请见:

https://borgbackup.readthedocs.io/en/stable/

Borg2目前处于beta测试阶段,beta版本之间可能会有重大和/或破坏性的变更(并且没有beta到下一个beta的升级代码,所以您需要删除并重新创建存储库)。

因此,请勿将BORG2用于生产备份! 请帮助测试,但将其设置为生产备份的额外备份。

待办:需要使用borg2重新制作屏幕录像,请参见:

https://github.com/borgbackup/borg/issues/6303

什么是BorgBackup?

BorgBackup(简称:Borg)是一个重复数据删除备份程序。 它可选择支持压缩和经过身份验证的加密。

Borg的主要目标是提供一种高效且安全的数据备份方式。 所使用的数据重复删除技术使Borg适合每日备份, 因为只存储变更的部分。 经过身份验证的加密技术使其适合备份到不完全可信的目标。

请参阅'安装手册'_或者如果您已经下载了Borg,请查看 docs/installation.rst 以开始使用Borg。 还有多种格式的'离线文档'_可用。

.. _安装手册: https://borgbackup.readthedocs.org/en/stable/installation.html .. _离线文档: https://readthedocs.org/projects/borgbackup/downloads

主要特性

**空间高效存储**
  基于内容定义分块的重复数据删除用于减少存储的字节数:每个文件被分割成多个可变长度的块,
  只有之前从未见过的块才会被添加到存储库。

  如果块的id_hash值相同,则认为是重复块。
  使用加密强度高的哈希或MAC函数作为id_hash,例如
  (hmac-)sha256。

  为了进行重复数据删除,会考虑同一存储库中的所有块,
  无论它们来自不同的机器,之前的备份,
  同一备份还是同一单个文件。

  与其他重复数据删除方法相比,此方法不依赖于:

  * 文件/目录名称保持不变:因此您可以在机器之间移动文件,
    而不会破坏重复数据删除,即使是在共享存储库的机器之间。

  * 完整文件或时间戳保持不变:如果一个大文件只有小的变化,
    只需要存储几个新块 - 这对虚拟机或原始磁盘很有用。

  * 数据块在文件中的绝对位置:内容可能会移动,
    但仍然可以被重复数据删除算法找到。

**速度**
  * 性能关键代码(分块、压缩、加密)用C/Cython实现
  * 本地缓存文件/块索引数据
  * 快速检测未修改的文件

**数据加密**
    所有数据都可以在客户端使用256位认证加密进行保护
    (AES-OCB或chacha20-poly1305),确保数据保密性、完整性和真实性。

**混淆**
    可选地,borg可以主动混淆文件/块的大小等,
    以使指纹攻击更加困难。

**压缩**
    所有数据都可以选择性压缩:

    * lz4(超快,低压缩)
    * zstd(范围广泛,从高速低压缩到高压缩低速)
    * zlib(中等速度和压缩)
    * lzma(低速,高压缩)

**异地备份**
    Borg可以在任何可通过SSH访问的远程主机上存储数据。如果在远程主机上安装了Borg,
    与使用网络文件系统(sshfs, nfs, ...)相比可以获得巨大的性能提升。

**备份可作为文件系统挂载**
    备份存档可以作为用户空间文件系统挂载,便于交互式检查备份和恢复
    (例如使用常规文件管理器)。

**在多个平台上易于安装**
    我们提供单文件二进制文件,无需安装任何东西 -
    您可以直接在以下平台上运行:

    * Linux
    * macOS
    * FreeBSD
    * OpenBSD和NetBSD(尚不支持xattrs/ACLs或二进制文件)
    * Cygwin(实验性,尚无二进制文件)
    * Windows 10的Linux子系统(实验性)

**自由开源软件**
  * 安全性和功能可以独立审核
  * 基于BSD(3条款)许可证授权,完整许可证请参见'许可证'_

易于使用
~~~~~~~~~~~

为了便于使用,设置BORG_REPO环境变量::

    $ export BORG_REPO=/path/to/repo

创建新的备份存储库(加密选项请参见 ``borg rcreate --help``)::

    $ borg rcreate -e repokey-aes-ocb

创建新的备份存档::

    $ borg create Monday1 ~/Documents

再次进行备份,展示优秀的重复数据删除::

    $ borg create -v --stats Monday2 ~/Documents
    Repository: /path/to/repo
    Archive name: Monday2
    Archive fingerprint: 7714aef97c1a24539cc3dc73f79b060f14af04e2541da33d54c7ee8e81a00089
    Time (start): Mon, 2022-10-03 19:57:35 +0200
    Time (end):   Mon, 2022-10-03 19:57:35 +0200
    Duration: 0.01 seconds
    Number of files: 24
    Original size: 29.73 MB
    Deduplicated size: 520 B


帮助、捐赠和赏金、成为赞助人
--------------------------------------------------

我们随时欢迎您的帮助!

传播信息、提供反馈、帮助文档编写、测试或开发。

您还可以为项目提供资金支持,详情请参见:

https://www.borgbackup.org/support/fund.html

链接
-----

* '主网站 <https://borgbackup.readthedocs.org/>'_
* '发布 <https://github.com/borgbackup/borg/releases>'_,
  'PyPI包 <https://pypi.python.org/pypi/borgbackup>'_ 和
  '更新日志 <https://github.com/borgbackup/borg/blob/master/docs/changes.rst>'_
* '离线文档 <https://readthedocs.org/projects/borgbackup/downloads>'_
* 'GitHub <https://github.com/borgbackup/borg>'_ 和
  '问题跟踪器 <https://github.com/borgbackup/borg/issues>'_.
* '网络聊天(IRC) <https://web.libera.chat/#borgbackup>'_ 和
  '邮件列表 <https://mail.python.org/mailman/listinfo/borgbackup>'_
* '许可证 <https://borgbackup.readthedocs.org/en/stable/authors.html#license>'_
* '安全联系 <https://borgbackup.readthedocs.io/en/latest/support.html#security-contact>'_

兼容性说明
-------------------

当主版本号变更时(如从0.x.y到1.0.0或从1.x.y到2.0.0),请预期我们将反复破坏兼容性。

未发布的开发版本具有未知的兼容性。

这是开发中的软件,请自行决定是否适合您的需求。

安全问题应报告给'安全联系人'_(或参见源代码分发中的 ``docs/support.rst``)。

.. start-badges

|doc| |build| |coverage| |bestpractices|

.. |doc| image:: https://readthedocs.org/projects/borgbackup/badge/?version=stable
        :alt: 文档
        :target: https://borgbackup.readthedocs.org/en/stable/

.. |build| image:: https://github.com/borgbackup/borg/workflows/CI/badge.svg?branch=master
        :alt: 构建状态(master)
        :target: https://github.com/borgbackup/borg/actions

.. |coverage| image:: https://codecov.io/github/borgbackup/borg/coverage.svg?branch=master
        :alt: 测试覆盖率
        :target: https://codecov.io/github/borgbackup/borg?branch=master

.. |screencast_basic| image:: https://asciinema.org/a/133292.png
        :alt: BorgBackup基本用法
        :target: https://asciinema.org/a/133292?autoplay=1&speed=1
        :width: 100%

.. _安装: https://asciinema.org/a/133291?autoplay=1&speed=1

.. _高级用法: https://asciinema.org/a/133293?autoplay=1&speed=1

.. |bestpractices| image:: https://bestpractices.coreinfrastructure.org/projects/271/badge
        :alt: 最佳实践评分
        :target: https://bestpractices.coreinfrastructure.org/projects/271

.. end-badges