版本发布说明
简介
pgBackRest 版本号由主版本、次版本和补丁版本三部分组成。主版本 可能 与上一主版本不兼容，但 v2 与 v1 仓库完全兼容，并接受所有 v1 选项。次版本可以包含缺陷修复和新功能，但不改变仓库格式，并尽量避免修改选项和命名。补丁版本包含针对最新次版本的缺陷修复。
功能版本计划在一月、四月、七月和十月的第三个星期一发布。补丁版本则根据需要，在其余月份的第三个星期一发布。
v1 版本的文档可在 此处 查阅。
版本说明还可能包含“附加说明”，但该部分仅涉及文档或测试套件的变更，不会直接影响 pgBackRest 代码库。
本站文档版本
本文档镜像覆盖 v2.60.0。更新版本请查阅 上游发布历史。
v2.60.0 版本说明
页面校验和错误与对象存储预取
发布于 2026 年 10 月 18 日
重要说明：restore 命令现在会在任一恢复文件包含无效页面校验和时报错并停止，此时集群不完整、无法启动，必须重新执行恢复。如果保留的最旧备份将包含校验和错误，expire 命令现在会拒绝执行过期操作，该仓库中的归档也因此无法过期。设置 checksum-page-error=n 可改为仅发出警告。
新功能：
新增
checksum-page-error选项，在页面校验和无效时报错。（贡献：Andrew Pogrebnoi. 审核：Douglas J Hunley, David Steele, Greg Sabino Mullane, Stefan Fercot. 建议：Greg Sabino Mullane.）此选项适用于
backup、restore和expire命令。backup命令默认仍对每个出错文件发出警告，并新增了备份结束时的校验和警告总数统计。restore和expire命令默认报错。此前，restore命令完全不会报告无效页面校验和。支持 GCS 工作负载身份联合（Workload Identity Federation）。（贡献：Adol Rodriguez. 审核：Douglas J Hunley, David Steele.）
设置
repo-gcs-key-type=web-id，并将repo-gcs-key设为外部账户凭据文件，例如通过gcloud iam workload-identity-pools create-cred-config生成的文件。Web 身份令牌可直接换取访问令牌，无需服务账户密钥。每次交换都会重新加载令牌文件，以获取轮换后的令牌，例如 Kubernetes 投射的服务账户令牌。不支持服务账户模拟。从对象存储预取多个文件或范围的读取请求。（审核：Andrew Pogrebnoi, Douglas J Hunley.）
请求会在当前读取之前排入队列，使后续请求在读取过程中推进；文件间较小的间隙则通过连续读取跳过，无需另发请求。
Restore用它读取文件包和块级增量映射，backup用它读取前一次备份的块级增量映射。repo-storage-prefetch（默认 3）设置预先排队的请求数量，repo-storage-read-over（默认 64KiB）设置可连续读取跳过的最大间隙。
改进：
减少发送给远程进程的保活请求。（审核：Douglas J Hunley.）
此前，
archive-push和backup每完成一个任务，都会向所有远程进程发送保活请求，即使刚刚才向其发送过请求。现在，仅在 30 秒内未向某个远程进程发送过请求时，才会发送保活请求。提交
f652261重试 Azure 响应中缺失的批处理子请求。（审核：Douglas J Hunley.）
Azure 批量删除失败时，可能仅为整个批次返回一个响应。没有响应的子请求此前会被视为已完成，导致每批只删除一个文件，命令却报告成功。现在会重试没有响应的子请求。
减少重建
backup.info时的清单检查。（审核：Douglas J Hunley. 建议：todeb.）当仓库列表表明备份路径不存在，或某个差异/增量备份所属的全量备份集不在
backup.info中时，backup、expire和annotate命令不再检查是否存在backup.manifest。每次检查都要发出请求，因此在对象存储上检查不存在的清单会产生 404 日志。使用原始大小判断文件是否应打包。（审核：Douglas J Hunley.）
此前依据前一次备份中块级增量文件的大小决定是否打包，因此已经增长到超过
repo-bundle-limit的文件仍可能存入文件包。现在改用文件的当前大小。为备份期间的块映射读取错误添加上下文。（审核：Stefan Fercot, Douglas J Hunley.）
读取前一次备份的块映射出错时，现在会报告文件、仓库路径、偏移量和映射大小。如果读取的字节数少于预期，会明确报告这一情况，不再将其报告为解析错误。
bc91688为备份期间的块映射读取错误添加上下文。; 议题 #2489; 议题 #2829; 拉取请求 #2830f46bfaf修正块级增量映射错误信息中的选项名。在备份开始标签中将
current_timestamp显式转换为text。（贡献：Tiago Corcelli de Oliveira. 审核：David Steele.）用户定义的
timestamptz到text隐式转换曾导致备份失败，并报错 “operator is not unique: unknown || timestamp with time zone”。标签文本保持不变。支持在 illumos 上构建。（贡献：Kalevi Kolttonen. 审核：Douglas J Hunley, David Steele.）
CI 新增了 OmniOS 任务。Solaris 也可能可用，但尚未测试。
支持 OpenSSL 4。（审核：Douglas J Hunley.）
由于
X509_get_subject_name()现在返回const名称对象，使用 OpenSSL 4 构建曾会失败。提交
a729ac8修复 clang 构建。（审核：Douglas J Hunley.）
在 Linux 上，gcc 将
libbacktrace.a安装到 clang 也会搜索的位置，却将backtrace.h安装到仅 gcc 能找到的位置。clang 构建因此会找到库，却编译失败。现在只有找到头文件时才使用该库。同时修复了调试构建中被 clang 报告为窄化转换的返回类型。84b031a检查 libbacktrace 时要求同时存在头文件。195e66b返回基于 StringId 的枚举的函数须返回其声明的类型。d9e5e14声明返回 bool 的函数须返回 bool。将代码生成从 C 迁移到 Python。
构建时，根据选项、错误、帮助和 PostgreSQL 声明生成代码的工作，现在由 Python 工具完成，不再使用需要先行编译的 C 工具。从 Git 检出目录构建时需要 PyYAML，不再需要 libyaml。发行版 tar 包包含生成的代码，两者均不需要。
提交
59bd2cd
文档改进：
更新网站设计。特别感谢 Jan 设计了构思巧妙又诙谐的标志。（贡献：David Steele, Jan Wieremjewicz. 审核：Steve Atkins, Kai Wagner, Douglas J Hunley, Nikolaos Stamatopoulos, Matt Hudson, Stefan Fercot.）
网站采用了新的设计，提供浅色、深色主题，并适配手机布局。有目录的页面会在正文旁显示目录，标出当前阅读的章节。命令和配置文件可以通过按钮复制，配置文件会标记各节修改的行，发行说明还可展开查看详细信息。
5bc14b5缩短文档标题并消除歧义。b668d71将赞助商移到首页下方，并缩短赞助呼吁。60b85c5更新网站设计。ab8df23分享链接时显示卡片，而非标志。76ae494移除发行页面的目录，并收紧日期周围的间距。3e86c71命令参考通过链接引用选项，不再重复列出。dc3af7b明确命令参考中的命令标题。078d52c在配置文件中标记各节修改的行。bd33623按配置文件的方式标记命令输出。578fc2d支持复制命令及配置文件。1fb93f9配置节没有产生读者可见的更改时报错。2f3b2f2将站点标志设为首页链接。8f902c6加快文档构建。b56b6ab在首页自动列出最新新闻。5b8987d在参考文档中将选项类型示例呈现为代码块。b5d5274菜单采用横向滚动，避免换行后超出可见区域。9ae2c32在菜单中高亮当前页面，而非将其省略。b8da5b0为样式和脚本链接添加版本标识，确保旧缓存重新获取。ec57431直接跳转至章节，不再平滑滚动。46babed菜单超出可见范围的一端采用渐隐效果，而非直接截断。17de501将 section2 标题的横线置于标题下方，而非旁边。940f431页面标题在标志旁居中，换行后左对齐。050ca9e为发行说明添加可展开的详细信息。bd8f99b补充 v2.33 至 v2.60 的发行说明详情。28a1e3d调整浅色模式下的关键词样式。1911f5f将发行说明历史的终点设为上游集成到 CI 的位置。记录发布计划。
功能版本计划在一月、四月、七月和十月的第三个星期一发布。补丁版本则根据需要，在其余月份的第三个星期一发布。发行说明的引言也解释了版本号中的主版本、次版本和补丁版本三部分。
9bca69a记录发布计划。c179f3f更新发行说明引言中的版本编号规则。将文档工具从 C 和 Perl 迁移到 Python。
文档改由
doc/doc.py构建，不再使用由doc/doc.pl运行的 C 工具，构建文档也不再需要 Perl。59bd2cd将构建和文档代码从 C 迁移到 Python。fa3d197将剩余的文档代码从 Perl 迁移到 Python。
测试套件改进：
将测试框架从 C 和 Perl 迁移到 Python。
测试改用
test/test.py运行，不再使用test/test.pl。测试容器和 CI 运行器不再需要 Perl，测试框架自身也纳入了测试覆盖。163e5ba将测试框架从 C 迁移到 Python。e25c662将测试框架的其余部分从 Perl 迁移到 Python。为 CI 添加 Fil-C 任务。
Fil-C 是一种内存安全的 C 实现，会检查每次指针访问。它发现了 gcc、clang 和 Valgrind 未能发现的两处越界读取。新增工作流还会直接在 CI 运行器上使用 gcc 和 clang 构建并测试，覆盖包含和不包含可选库的情况。
f32a5d5添加直接在运行器上编译和测试的工作流，无需容器。12396fb为编译工作流添加 Fil-C 任务。908a11aFil-C 发行包现已包含所需的所有库，可以直接使用。为
JSON、Ini和Pack读取器添加模糊测试。CI 使用 libFuzzer、AddressSanitizer 和 UndefinedBehaviorSanitizer 对这些读取器进行模糊测试。测试发现了处理无效输入时的多处缺陷，例如信息文件或对象存储响应中嵌套过深的 JSON 数组可能导致内存上下文栈溢出。
提交
4c65010允许使用 Debian 上 adduser 会拒绝的测试用户名。（贡献：Stefan Fercot. 审核：David Steele.）
测试容器使用与宿主机用户相同的用户名构建。Debian 的
adduser会拒绝包含句点的名称，例如first.last，因此这些用户在基于 Debian 的镜像上构建容器时会失败。
稳定版本
v2.59.3 版本说明
弱加密子密钥缺陷
发布于 2026 年 10 月 4 日
重要说明：旧版本在访问系统随机数据出错时，可能生成弱加密子密钥和盐值。详情请参阅 弱加密子密钥和盐值。
缺陷修复:
修复加载加密的信息文件和清单文件时可能出现校验和错误的问题。（由 j0uinim 修复，David Steele 审核。）
较大的加密信息文件或清单文件在加载时可能丢失最后几行，导致校验和验证失败。只有这些行能够容纳在最后一个加密块中才会发生，因此实际出现的可能性较低。
修复可能生成弱加密子密钥或盐值的问题。（由 j0uinim 修复，David Steele, Stefan Fercot, Douglas J Hunley 审核。）
当 OpenSSL 无法从操作系统获取随机数据时，此前会忽略失败，使用非随机的内存数据生成子密钥和盐值。现在会报告错误。
v2.59.2 版本说明
支持 PostgreSQL 19beta4
发布于 2026 年 9 月 27 日
漏洞修复：
修复备份期间文件被截断为零长度时产生空块映射的问题。（由 Douglas J Hunley 审核，JPCOSTA78 报告。）
如果块级增量文件大于
repo-bundle-limit，且在备份期间被 PostgreSQL 截断为零长度，就会被存储成不含任何块的块映射。在下一次全量备份之前，之后引用该文件的每次备份都会因 “unexpected eof” 而失败。向驱动传入过滤器时，禁用读取重试。（由 Douglas J Hunley 审核，megamaced 报告。）
通过仓库主机访问对象存储中的仓库时，重试读取会导致崩溃。客户端不再重试此类读取；仓库主机仍会重试从对象存储读取。
修复 S3 对象版本列表的分页问题。（由 Douglas J Hunley、guruguruguru 审核，guruguruguru 报告。）
使用
repo-target-time按目标时间读取仓库时，如果某个前缀下列出的版本超过一千个，就会因 “unable to find child ‘NextContinuationToken’” 而失败。使用
SAS认证时设置 Azure 版本请求头。（审核：Douglas J Hunley. 报告：Florian Helmberger.）批量删除要求包含版本请求头，因此使用
SAS认证时，所有批次都会被拒绝。该拒绝被误认为单个文件失败，每个批次中的其余文件都未删除，expire却报告成功，导致过期备份和 WAL 留在仓库中。修复异步
archive-push遇到零长度备份历史文件时停滞的问题。（由 Andrew Kroh 修复，David Steele、Douglas J Hunley 审核。）零长度的备份历史文件（例如在从存储快照复制的集群中）会使每次异步
archive-push运行失败，导致没有任何 WAL 被归档。现在会根据第一个就绪 WAL 段的大小，将archive-push-batch-size换算为段数。修复
annotate命令在远程加密仓库上执行时的问题。（由 Douglas J Hunley 修复，David Steele 审核。）如果仓库已加密，且仅在仓库主机上配置了加密设置，
annotate就无法加载backup.info。提交
497ad5a
新功能：
支持 PostgreSQL 19beta4/rc1。
PostgreSQL 19beta4 撤销了在线页面校验和变更，因此页面校验和版本重新限定为 0 和 1。它还更改了
pg_control版本和 WAL 页魔数。提交
89eae83
v2.59.1 版本说明
支持 PostgreSQL 19beta3
发布于 2026 年 8 月 17 日
漏洞修复：
修复分块缓冲区小于输入缓冲区时发生挂起的问题。（由 Andrew Pogrebnoi、Douglas J Hunley 审核，crajac66 报告。）
向 S3、GCS 或 Azure 分段上传时，如果分段缓冲区小于输入缓冲区（例如上传过程中分段大小增大后），就可能陷入无限循环。现在始终确保分段缓冲区足以容纳输入缓冲区。
新备份标签仅与其所属的全量备份集比较。（由 Douglas J Hunley 审核，Anton Glushakov 报告。）
某些对象存储在前缀下的所有对象都被删除后，仍会列出该前缀，例如启用对象锁定的 MinIO 或 SeaweedFS，因此已经删除的全量备份仍可能出现在仓库列表中。之后的每次差异和增量备份都会因 “new backup label … is not later than latest backup label …” 而失败。现在，新标签只与所属全量备份集中的备份比较。
修复 GitHub 生成的源码归档缺少构建所需文件的问题。（由 aardvarkzed 报告。）
GitHub 为发行版本生成的源码归档缺少代码生成工具及其输入文件，因此无法构建。现在仅对发行版 tar 包进行裁剪。
新功能：
支持 PostgreSQL 19beta3。（由 Lardière Sébastien 贡献，David Steele 审核。）
PostgreSQL 19beta3 更改了 WAL 页魔数。
提交
5cbc256
文档改进：
说明使用
repo-s3-uri-style=path时，S3 存储桶名称可以包含点号。设置
repo-s3-uri-style=path后，存储桶名称是路径的一部分，而非主机名的一部分，因此桶名称中的句点不会导致证书主机名不匹配。提交
bbdc4b9从用户指南中移除显式的
hot_standby配置。从 PostgreSQL 10 起，
hot_standby默认启用。快速入门现在说明：如果不启用它，备库不会接受只读连接。提交
cda454d
v2.59.0 版本说明
支持 PostgreSQL 19beta2
发布于 2026 年 7 月 20 日
打包维护者注意：新增的发行版 tar 包提供预生成的 HTML 文档、man 手册页和代码，可简化构建流程。该 tar 包作为每个发行版本的附件提供，名称为 pgbackrest-{version}.tar.gz。详情请参阅包内的 README.md。请使用新的发行版 tar 包，以免后续版本需要额外的代码生成工具。更多信息请参阅 新的发行版 tar 包。
打包维护者注意：新增可选依赖 libsystemd。
重要说明：从本版本起，默认仅允许 restore 命令以 root 身份运行。可使用 allow-root 让其他命令以 root 身份运行，但不建议这样做。
漏洞修复：
修复
expire删除另一台主机上正在进行的备份的问题。（由 Douglas J Hunley 审核，Dmitrii 报告。）备份只有完成后才会加入
backup.info，因此在一台主机备份期间，若另一台主机运行expire（例如主库备份时在备库运行expire），正在进行的备份可能被删除。过期处理现在不会删除仍在进行或可续传的最新备份。修复 WAL 文件出错时未执行
archive-push-queue-max限制的问题。（由 Stefan Fercot 审核，vut12 报告。）在异步模式下，此前根据尚未推送的 WAL 计算队列大小。如果某个 WAL 文件反复出错，后续 WAL 虽已推送、不再计入队列，却仍留在
pg_wal中，因此永远无法达到队列上限，pg_wal可能占满磁盘。现在与同步模式一样，队列大小按 PostgreSQL 正在等待归档的全部 WAL 计算。修复跨时间线切换恢复期间异步
archive-get失败的问题。（由 Douglas J Hunley 审核，Jimmy Yih 报告。）两个异步进程可能竞争归档锁，未获取锁的进程在获取所需 WAL 段前便退出。启动它的
archive-get随后等待archive-timeout，并对实际存在的 WAL 段返回错误，可能导致恢复提前结束，尤其是在切换时间线时。现在，如果负责获取该段的异步进程未运行，会直接获取该段。修复错误模块中潜在的缓冲区越界问题。（由 Christophe Pettus 修复，David Steele 审核。）
堆栈跟踪过长、超出缓冲区时，此前不会正确终止字符串，可能导致越界读取；错误信息过长时，在追加系统错误信息时也可能写出缓冲区边界。两种情况都需要异常长的信息才会触发。
7fd8bc8修复错误模块中潜在的缓冲区越界问题。5ca98ab格式化错误信息时使用完整缓冲区。3a71dc8防止超长信息导致错误缓冲区越界写入。修复并行协议客户端释放后使用的问题。（由 Douglas J Hunley 审核，Georgy Shelkovy 报告。）
没有剩余任务的客户端被释放后，仍留在客户端列表中，后续调用会再次释放它。在 debug 或 trace 日志级别下，这会读取已释放内存并可能崩溃，例如设置
log-level-file=trace的并行备份。修复未设置
pg1却设置pg选项时发生的堆溢出。（由 Douglas J Hunley 审核，Naveen 报告。）未设置
pg1-path却为其他索引设置pg选项（例如pg2-path和pg3-path）时，索引映射会被覆盖。这在使用 musl 的系统（如 Alpine）上会损坏堆并引发段错误，编号最大的pg-path也会丢失。修复 musl 1.2.6 上退出期间收到信号导致崩溃的问题。
musl 1.2.6（例如 Alpine 3.24 所用版本）在退出已开始后再次调用
exit()会崩溃。退出期间收到信号时会触发此问题，例如server命令终止一个已经开始退出的子进程。现在会忽略退出期间到达的信号。提交
e166a33
新功能：
支持 PostgreSQL 19beta1/beta2。（审核：Stefan Fercot.）
新增 PostgreSQL 19beta1/beta2 支持。PostgreSQL 19 可以在线启用和禁用页面校验和，这两种操作进行期间不会验证页面校验和。
bc6d399支持 PostgreSQL 19beta1。; 拉取请求 #27792777395支持 PostgreSQL 19beta2。新增
archive-expire-before选项，用于清理 WAL 归档。（由 Stefan Fercot 贡献，David Steele 审核。）expire的archive-expire-before选项可从归档中删除指定 WAL 段之前的 WAL，但绝不会删除保留备份所需的 WAL。它可以通过archive_cleanup_command，从备库的重启点开始清理归档，替代不了解保留策略的pg_archivecleanup。6cd692b将 WAL 过期处理提取到 expireArchiveId()。为 Azure 存储添加批量删除功能。（由 Douglas J Hunley、Crispy 审核。）
文件删除改用 Azure Blob Batch API，每个请求最多删除 256 个文件，不再为每个文件单独发出请求。这可加快
expire等从仓库删除文件的命令。添加对 S3 Outposts 的支持。（由 Shiva Kumar Ambigi 贡献，David Steele、Roberto Mello 审核。）
使用 S3 Outposts 端点时，设置
repo-s3-service=s3-outposts。该选项设置请求签名所用的服务名称，默认值为s3。添加 S3 进程认证支持。（由 Andrew Charlton 审核，Andrew Charlton 建议。）
设置
repo-s3-key-type=process，并将repo-s3-process-cmd设为以 AWS 进程凭据提供程序的 JSON 格式输出临时凭据的命令。凭据会在过期之前刷新。提供包含生成代码和文档的发行版 tar 包。
tar 包包含生成的代码以及已呈现的 man 手册页和 HTML 文档，因此构建和安装无需代码生成或文档工具，也无需
libyaml。提交
8fcfef5
改进：
服务器断开空闲连接后，重新建立 SFTP 存储连接。（由 Stefan Fercot 审核，mustafa0x、tisserat 建议。）
SFTP 服务器和防火墙可能断开空闲一段时间的连接，例如备份复制阶段的仓库读取连接，导致下次使用时出现套接字错误。现在会重新建立已断开的连接，并重试一次操作。
d72bea9在 SFTP 读写对象中从存储对象获取 libssh2 会话。a31febf服务器断开空闲连接后，重新连接 SFTP 存储。; 议题 #2739; 议题 #2772; 拉取请求 #2793添加用户/组缓存，加快清单构建速度。（由 Gunnar Lindholm 贡献，David Steele 审核。）
通过远程名称服务（如 sssd 或 LDAP）查询用户和组名时，每次查询都需往返通信，在有数百万文件的集群上成为构建清单的主要耗时。现在会缓存用户和组名。
在
info命令输出中添加各仓库的备份进度。（由 Will Morland 贡献，David Steele、Stefan Fercot 审核。）同时向多个仓库执行备份时，
info命令现在会分别报告各仓库的进度及总体进度。JSON 输出为每个备份锁增加了repo数组。为
verify命令添加backup.info检查。（由 Denis Garsh 贡献，David Steele、Douglas J Hunley 审核。）当仓库中的备份不在
backup.info中，或backup.info中的备份在仓库中缺失时，verify命令现在会发出警告。缺失的备份会被报告为清单缺失。允许配置 S3 STS 端点。（由 Simon Gratton 贡献，David Steele 审核。）
配合
repo-s3-key-type=web-id，可设置repo-s3-sts-host使用区域 STS 端点，例如sts.eu-central-2.amazonaws.com。需要显式启用的 AWS 区域不接受全球端点签发的凭据，但全球端点仍是默认值。新增
archive-push-batch-size，用于限制每次异步运行推送的 WAL 数据量。（由 Stefan Fercot 审核。）在异步模式下，
archive-push-queue-max仅在每次运行开始时检查，因此处理大量积压 WAL 时，队列可能远超上限。archive-push-batch-size（默认 16GiB）限制每次运行推送的 WAL 数量，使队列更早得到再次检查。异步
archive-push遇到第一个错误时退出。（由 Stefan Fercot 审核，Lardière Sébastien 建议。）仓库不可用时，异步进程此前会不断尝试每个就绪 WAL 段，单次运行可能长到尚未再次检查
archive-push-queue-max，pg_wal就已占满磁盘。现在发生第一个错误后，等待进行中的任务完成便退出。加固 HTTP 分块响应解析。（由 Shubham 贡献，David Steele 审核。）
现在接受分块扩展和尾部字段，对
transfer-encoding进行不区分大小写的比较，并拒绝同时包含transfer-encoding和content-length的响应。未启用
allow-root时，由 root 用户运行命令将报错。（由 Douglas J Hunley 审核。）以 root 身份运行
restore以外的命令，可能在仓库中创建 PostgreSQL 用户无法访问的文件，例如backup.info。除restore外，所有命令默认禁用allow-root，远程主机也会执行这项检查。构建清单时减少二分查找次数。（由 Gunnar Lindholm 贡献，David Steele 审核。）
构建差异或增量备份清单时，此前会为每个文件搜索前一份清单三次。现在仅搜索一次，可为有数百万文件的集群节省数百万次搜索。
提升块级增量 delta 恢复期间的文件定位性能。（由 David Christensen、Douglas J Hunley 审核。）
块级增量 delta 恢复此前每写一个块，都要定位文件并刷新写缓冲区，而块通常只有 8KiB。现在会跟踪文件位置，仅在必要时定位和刷新。
按顺序将备份文件打包，不再扫描以寻找更合适的文件组合。（由 Stefan Fercot 审核。）
此前，如果加入某个文件会使文件包超过
repo-bundle-size，就会跳过它，转而加入队列后方较小的文件。现在按顺序添加文件，达到repo-bundle-size后关闭文件包，因此包大小可能超过该阈值，超出量最多为repo-bundle-limit。查询未能完成时报告底层错误。（由 Andrew Pogrebnoi 审核，Marco Fontana 建议。）
查询返回第一个结果后连接丢失时（例如负载较高时），此前只会报告笼统的 “NULL result required to complete request”。现在会报告 PostgreSQL 返回的错误，并提示可能是连接丢失，或
idle_session_timeout、idle_in_transaction_session_timeout设置过于激进。S3 凭据请求失败时报告实际错误。（由 Douglas J Hunley 审核，Mitchell Grice 建议。）
AWS 对
web-id或pod-id凭据请求返回错误时，此前会报告响应解析失败。现在会报告 AWS 返回的错误，并在记录请求日志时隐藏令牌。将
archive-push的spool-path错误报告到 PostgreSQL 日志。（由 Douglas J Hunley 审核，Don Seiler 建议。）无法创建异步 spool 路径时（例如权限不足），错误无法写入 spool，
archive-push只会因笼统的超时而失败，并提示查看异步日志。现在在启动异步进程之前创建 spool 路径，使错误能出现在 PostgreSQL 日志中。遇到不受支持的版本时，提示 pgBackRest 可能版本过旧。
pgBackRest 无法识别 PostgreSQL 版本时（例如恢复主机上的旧版 pgBackRest 读取新版集群的备份），错误现在会提示可能需要更新所有主机上的 pgBackRest。版本号会以用户可读的形式报告，例如 13，而非 130000。
提交
d4f697e添加 systemd 通知集成。（由 Andrew Jackson 贡献，David Steele 审核。）
使用
libsystemd构建时，server命令会像 PostgreSQL 和 PgBouncer 一样，在准备接受连接和停止时通知 systemd。在 meson 编译器探测中抑制
unused parameter错误。（由 Jörg Plate 贡献，David Steele 审核。）meson 的编译器探测代码声明了未使用的
main()参数；当未使用参数警告被视为错误时，会导致探测失败。C11 现为最低 C 语言标准。（由 Mohammad Ali Nazir Kosar 审核。）
文档改进：
将
repo-*命令的stanza选项设为内部选项。（由 Stefan Fercot 审核。）stanza选项对repo-*命令仅在使用未公开的存储路径常量时有效，此前文档却让人误以为它具有实际并不存在的作用。现在不再为这些命令列出该选项，其行为保持不变。说明
info会从全局配置节读取加密设置。（由 Stefan Fercot 审核，Ron Johnson 建议。）不指定
stanza运行info时，只会从全局配置节读取加密设置。因此，若加密设置配置在 stanza 节中，就必须指定stanza。说明
expire-auto使用backup命令的配置。（由 Stefan Fercot 审核，Lardière Sébastien 建议。）备份后的自动过期处理使用
backup命令的配置，因此仅为expire命令设置的选项不会生效。如果需要单独的配置，应禁用expire-auto并另行运行expire。说明使用专用用户时需要调整 logrotate 的
su指令。（由 Douglas J Hunley 审核，lkanbus 建议。）软件包可能安装以
postgres用户轮转日志的 logrotate 配置。如果仓库和日志归专用用户所有，必须将su指令改为该用户，否则轮转会因权限错误而失败。说明配置文件不支持行尾注释。（由 Douglas J Hunley 审核，Alex Richman 建议。）
从未支持过行尾注释，尽管对某些选项看起来似乎有效。仅支持独占一行的注释。
测试套件改进：
修复 CI 容器中的 Alpine 用户组冲突。（由 Artur Zakirov 贡献，David Steele 审核。）
重命名测试组时，现在会处理含有成员的组条目；仅在 Alpine 组尚不存在时才创建它。
v2.58.0 版本说明
对象存储改进
发布于 2026 年 1 月 19 日
重要提示：repo-storage-upload-chunk-size 选项的最小值已提高，现在代表各云存储供应商所允许的最小值。
漏洞修复：
修复信号处理程序中日志记录引发的死锁问题。（由 Maxim Michkov 修复，David Steele 审核。）
在
gmtime_r()持锁期间到达的信号（例如 带--force的stop命令 发送的 SIGTERM），可能在信号处理器记录日志时导致死锁。信号处理器现在只使用异步信号安全的函数记录日志。
新功能：
为 S3、GCS 和 Azure 添加 HTTP 支持。（由 Will Morland 贡献，David Steele 审核。）
对象存储端点现在可以使用
http://前缀，以不启用 TLS 的方式连接。未指定协议时仍使用 HTTPS。允许直接过期最旧的全量备份，不受当前保留策略限制。（由 Stefan Fercot 贡献，David Steele 审核，Ron Johnson 建议。）
expire的--oldest选项会忽略保留设置，使最旧的全量备份及依赖它的备份过期，例如可在仓库空间不足时使用。早于剩余最旧全量备份的 WAL 也会过期。支持 Azure 托管标识（managed identities）。（由 Moiz Ibrar、Matthew Mols 贡献，David Steele 审核。）
设置
repo-azure-key-type=auto可通过托管身份自动获取凭据，无需手动配置。凭据会在过期之前刷新。实验性 支持 S3 EKS Pod 身份认证。（由 Pierre BOUTELOUP 贡献，David Steele 审核。）
设置
repo-s3-key-type=pod-id可通过 EKS Pod 身份自动获取凭据，无需手动配置。凭据会在过期之前刷新。允许配置 TLS 密码套件。（由 Gunnar “Nick” Bluth 贡献，David Steele 审核。）
使用
tls-cipher-12设置 TLS 1.2 的密码套件，使用tls-cipher-13设置 TLS 1.3 的密码套件，例如用于满足合规要求。这些密码套件设置适用于进程建立的所有连接。fbc607a允许配置 TLS 密码套件。; 议题 #2697; 拉取请求 #270091ad655修复 fbc607a4 中新增的 common/io-tls 单元测试偶发失败问题。允许设置进程优先级。（由 Douglas J Hunley 审核。）
priority可像nice一样，将 pgBackRest 进程的调度优先级设置为 -20 至 19。值越高，pgBackRest 越不容易影响 PostgreSQL。
改进：
使用 path-style URI 时，允许 S3 桶名中包含点号。（由 Joakim Hindersson 贡献，David Steele 审核。）
桶名称中的句点仅在主机式 URI 中会导致证书主机名不匹配，因此现在允许在
repo-s3-uri-style=path下使用。大多数自建 S3 服务采用路径式 URI。除非禁用验证，否则要求 TLS >= 1.2。（由 Douglas J Hunley、Gunnar “Nick” Bluth 审核。）
TLS 1.0 和 1.1 自 2021 年起已被弃用。pgBackRest 主机之间的连接始终启用验证。如果通过
repo-storage-verify-tls禁用对象存储的验证（例如使用自签名证书时），则允许所有协议版本。针对大文件上传，动态调整 S3/GCS/Azure 的分块大小。（由 Douglas J Hunley 审核，Timothée Peignier 建议。）
上传的分段数量有限，因此使用默认的
repo-storage-upload-chunk-size时，S3、GCS 和 Azure 可上传的最大文件分别为 50GiB、40GiB 和 200GiB。现在分段大小会在上传过程中增长，因此 S3 和 GCS 可上传最大 5TiB 的文件，Azure 可上传最大 45TiB 的文件。针对小文件，优化 S3/GCS/Azure 的分块大小。（由 Douglas J Hunley 审核。）
此前打开文件时就会分配整个分段缓冲区，尽管许多文件比一个分段还小。现在缓冲区随数据到达逐渐增长，可减少上传小文件时的内存占用。
移除对 PostgreSQL
9.5的支持。（由 Douglas J Hunley 审核。）按照支持五个已结束生命周期的 PostgreSQL 版本的策略，不再支持 PostgreSQL 9.5。
改进存在未解析依赖项的选项在默认值日志中的输出信息。（由 Stefan Fercot 审核。）
配置文件中设置的选项在依赖条件未满足时，实际使用的是默认值，此前却仍会在命令开始时记录该选项。现在不再记录这种情况。
文档改进：
从用户指南中移除显式的
max_wal_senders/wal_level配置说明。（由 Jamie Nguyen 建议。）从 PostgreSQL 10 起，
max_wal_senders和wal_level的默认值已符合用户指南的要求。阐明 bundling（包捆绑）在大块大小文件系统上的优势。（由 Ron Johnson 建议。）
在块较大的文件系统上，每个小文件都会占用一整个块，因此文件打包可节省空间。
v2.57.0 版本说明
禁止仓库符号链接
发布于 2025 年 10 月 18 日
漏洞修复：
解除 HTTP/TLS/socket 超时的嵌套处理。（由 David Christensen 审核。）
套接字连接失败后，TLS 和 HTTP 层也会重复重试，导致在
io-timeout默认为 60 秒时，连接竟需九分钟才超时。现在每一层仅重试自身的失败。修复页面校验和错误信息中可能出现的段错误。（由 Zsolt Parragi 修复，David Steele 审核。）
无效页面校验和的错误信息使用了已超出作用域的字符串，可能记录乱码或导致崩溃。使用 pg_tde 时最容易出现，因为每个加密文件都会使页面校验和验证失败。
修复备份续传信息可能导致段错误的问题。
用于解释备份为何无法续传的信息使用了已超出作用域的字符串，可能记录乱码或导致崩溃。
提交
c1c40a4
新功能：
新增
repo-symlink选项，用于禁止创建仓库符号链接。（由 Douglas J Hunley 审核，Ron Johnson 建议。）某些在其他方面兼容 Posix 的文件系统不支持符号链接。设置
repo-symlink=n可避免在仓库中创建latest和表空间符号链接。
改进：
为 HTTP 408 和 429 错误添加重试机制。（由 David Christensen 审核。）
现在会重试 HTTP 408（Request Timeout）和 429（Too Many Requests）错误。429 错误在 Cloudflare R2 上较为常见。
v2.56.0 版本说明
进度信息改进
发布于 2025 年 7 月 21 日
漏洞修复：
修复仓库中无备份时临时过期操作（adhoc expiration）的问题。（由 Stefan Fercot 审核，Anup Gupta 报告。）
仓库中没有备份时，临时指定的过期操作会因 “cannot get index 0 from list with 0 value(s)” 而失败。
新功能：
在
info命令输出中添加恢复进度信息。（由 Denis Garsh、Maxim Michkov 贡献，David Steele 审核。）restore命令现在会记录进度，由info命令与备份进度一起报告。stop命令也不再终止恢复。为
info命令输出添加仅显示进度的详细级别。（由 Denis Garsh 贡献，David Steele、Stefan Fercot 审核。）设置
--detail-level=progress可仅报告进度；由于无需读取仓库，速度更快。默认值为full。
改进：
在对象存储上重试失败的读取操作。（由 David Christensen 审核。）
从对象存储读取开始后发生错误，此前会视为致命错误，可能导致恢复等代价较高的任务重新开始。现在会从中断位置重试失败的读取。
修复命令行帮助中默认值的显示问题。（由 David Christensen、Chris Bandy 审核。）
如果选项有多个默认值，例如同时配置 S3 和 Azure 仓库时的
repo-storage-upload-chunk-size，选项列表会显示<multi>，该选项的帮助则会列出每个默认值。对于在当前配置中无效的选项，不显示默认值。
文档改进：
在适当情况下，以列表形式描述离散选项值。（由 Anton Kurochkin 贡献，David Steele 审核。）
verify和version命令的output等选项值，现在与其他选项一样以列表形式说明。修复
archive-mode选项帮助输出中"小于"的描述。（由 Anton Kurochkin 贡献，David Steele 审核。）
v2.55.1 版本说明
漏洞修复
发布于 2025 年 5 月 5 日
漏洞修复：
回滚"仅在需要时才在 S3 上计算 content-md5"的变更。（由 David Christensen 审核，Frank Brendel 报告。）
启用对象锁定后，S3 要求上传请求包含
content-md5或x-amz-content-*校验和，而 Scality 不接受替代校验和，导致上传失败。现在重新为所有带有内容的请求计算content-md5。修复选项键的下界检查。（由 David Christensen、Wolfgang Walther 审核，Wolfgang Walther 报告。）
索引为 0 的选项（例如
pg0-path）此前会导致段错误，现在会报告错误。
v2.55.0 版本说明
验证功能改进与 PostgreSQL 18 支持
发布于 2025 年 4 月 21 日
漏洞修复：
修复在非默认仓库上进行块级增量恢复的问题。（审核：David Christensen. 测试：Aleksander Łukasz. 报告：Aleksander Łukasz.）
待恢复备份使用块级增量、且不在编号最小的仓库中时，恢复却会从编号最小的仓库读取部分块级增量数据。显式设置
repo可以绕过该问题。对于 PostgreSQL < 12，不再设置
recovery_target_timeline=current。（由 Stefan Fercot 审核。）在 PostgreSQL 12 之前，虽然
current是默认值，但显式将recovery_target_timeline设为current时，其行为却与latest相同。对于这些版本，设置为current时，现在不再将此设置写入recovery.conf。修复归档范围过期的日志记录问题。（由 Stefan Fercot 审核，Aleš Zelený 报告。）
此前将最后一个删除的归档路径记录为范围起点，因此日志显示的过期文件数量远少于实际数量。
修复无结果查询的错误报告。（由 Stefan Fercot 审核，Susantha Bathige 报告。）
预期不返回结果的查询发生错误时，此前会将它报告为意外结果，而非实际错误。
新功能：
支持验证恢复目标时间线。（由 Stefan Fercot 审核。）
如果备份无法沿目标时间线恢复（例如备份是在备库提升且新时间线已分叉之后创建的），此前只有在恢复启动时才会失败，并返回难以理解的 PostgreSQL 错误。现在在开始恢复之前，就会根据历史文件检查时间线。
允许对指定备份执行验证。（由 Maxim Michkov 贡献，David Steele 审核。）
verify的--set选项仅验证指定备份，以及使其保持一致所需的 WAL。新增对 S3/GCS 请求方付费（requester pays）的支持。（由 Timothée Peignier 贡献，David Steele 审核。）
设置
repo-s3-requester-pays或repo-gcs-user-project可由请求者承担费用，而非桶所有者，例如让托管服务向客户开放其备份的访问权限。支持 PostgreSQL 18。（由 Stefan Fercot 审核。）
本版本发布时，PostgreSQL 18 尚未推出 beta 版，因此最初的支持属于实验性质。直到 PostgreSQL 18.0，均未出现影响 pgBackRest 的变更。
允许通过抽象域套接字（abstract domain sockets）连接 PostgreSQL。（测试：Chris Bandy. 建议：Chris Bandy.）
pg-socket-path不再必须是绝对路径，因此可以指定抽象域套接字。无效路径由 libpq 报告。为
version命令添加数字格式输出。（由 Stefan Fercot 贡献，David Steele 审核。）设置
--output=num可将版本输出为数字，例如 2055000，便于比较。
改进：
允许
backup命令在远程仓库上运行。（由 Stefan Fercot 审核。）backup命令现在可以在仓库位于远程的主机上运行，使备份的执行位置更加灵活。4a94b6b重构协议辅助模块。使用 lz4 进行协议压缩。（由 Stefan Fercot 审核。）
在协议压缩所用的低压缩级别下，lz4 比 gz 快得多，压缩率却相近。设置
compress-level-network=0不再禁用协议压缩。0577b03使用 lz4 进行协议压缩。; 拉取请求 #24885c8296d移除文档中关于禁用网络压缩的说明。仅在需要时才在 S3 上计算
content-md5。（由 David Christensen 审核。）为减少上传文件时的 CPU 开销，
content-md5请求头改为仅对必须使用它的批量删除请求计算。此变更已在 v2.55.1 中回退。多键选项的值被覆盖时，发出警告。（由 David Christensen、Stefan Fercot 审核。）
对于键值对选项（例如
recovery-option），重复指定键时，此前会静默覆盖其值。现在会记录警告。为已过期归档路径添加详细日志记录。（由 Stefan Fercot 贡献，David Steele 审核。）
删除大量归档文件时，看起来可能像卡住。现在会以 detail 级别记录进度信息。
4dcfa9e为 expire 测试添加 detail 级别日志。移除对 PostgreSQL
9.4的支持。（由 Stefan Fercot 审核。）按照支持五个已结束生命周期的 PostgreSQL 版本的策略，不再支持 PostgreSQL 9.4。仍可对 9.4 集群的备份执行过期处理。
移除 autoconf/make 构建方式。（由 David Christensen 审核。）
v2.54.0 是最后一个支持 autoconf/make 构建的版本。请使用 meson 构建。
文档改进：
修复为多个 stanza 指定
tls-server-auth时的文档说明。（由 David Christensen、Stefan Fercot 审核，Terry MacAndrew 建议。）tls-server-auth的多个 stanza 应以逗号分隔列表指定。此前文档误写为重复指定该选项。阐明增量备份的过期机制。（由 Stefan Fercot 审核。）
此前文档让人误以为增量备份按数量过期。现在说明了增量备份的过期方式，以及在差异备份保留策略中，全量备份也计作差异备份。
阐明本地与远程 pgBackRest 版本须保持一致的要求。（由 Greg Clough 贡献，David Steele 审核。）
新增关于导出自包含集群的常见问题解答。（由 Stefan Fercot 贡献，David Steele 审核。）
FAQ 说明了如何使用
--archive-copy创建备份，再通过--type=none恢复，以导出可独立使用的集群。补充
--tablespace-map-all关于表空间创建的注意事项。（由 Stefan Fercot、Christophe Courtois 审核，Christophe Courtois 建议。）备份开始后新建的表空间不在清单中，因此
tablespace-map-all无法映射它。阐明
--repo-retention-full-type的行为。（由 Antoine Beaupré 审核，Antoine Beaupré 建议。）将对象存储的
--process-max建议改为使用--repo-bundle。（由 Stefan Fercot 审核。）在对象存储上，
repo-bundle通过减少创建的文件数量，大幅缩短创建文件的耗时，其效果远大于process-max。将
unix_socket_directory更新为unix_socket_directories。（由 hyunkyu han 贡献，David Steele 审核。）unix_socket_directory从 PostgreSQL 9.2 起已无效，因此文档仅保留unix_socket_directories。建议不要将
spool-path置于pg_xlog/pg_wal目录内。（由 Martín Marqués、Don Seiler 审核，Martín Marqués 建议。）将 spool 路径放在
pg_xlog或pg_wal内，可能给pg_rewind等 PostgreSQL 工具带来问题。
v2.54.2 版本说明
漏洞修复
发布于 2025 年 1 月 20 日
漏洞修复：
修复在启用块级增量的情况下禁用 bundling 后出现的问题。（由 David Christensen 审核。）
在启用文件打包和块级增量的情况下创建备份后，如果禁用了打包，就无法读取之前的备份。现在会保留读取它们所需的设置。
文档改进：
阐明多个配置文件的行为方式。（由 Paul Bierly 审核，Paul Bierly 建议。）
每个配置文件必须独立有效，因此在某个文件中设置选项时，必须在该文件中声明所属配置节。文档还说明：不支持引号，键和值两端的空白会被去除，重复的配置节会合并。
提交
5da2df4
v2.54.1 版本说明
漏洞修复
发布于 2024 年 12 月 16 日
漏洞修复：
修复
version/help命令尝试加载pgbackrest.conf的问题。（由 Stefan Fercot 审核，Bradford Boyle、Julian 报告。）在 v2.54.0 中，
version和help命令会加载pgbackrest.conf，无法读取或解析时就会失败。
测试套件改进：
稳定集成测试中的异步归档功能。（由 Viktor Kurilko 贡献，David Steele 审核。）
某个集成测试遗留运行的异步
archive-get，可能将错误写入下一个测试的队列，导致其恢复失败。
v2.54.0 版本说明
版本化存储的目标时间点
发布于 2024 年 10 月 21 日
打包者注意：这是最后一个支持 autoconf/make 构建方式的功能版本。如尚未迁移，请迁移到 meson。2.54.X 补丁版本（如有）将继续支持 autoconf/make。
漏洞修复：
修复大型数据集上的 PostgreSQL 查询性能问题。（修复：Thibault Vincent, David Steele. 审核：David Christensen. 测试：Antoine Millet. 报告：Antoine Millet.）
查询超时逻辑延迟了读取查询结果，导致返回大量结果的查询耗时可能达到
db-timeout。现在会在结果可用后立即读取。6ac4e8d将 fd 模块的测试替身移到 io 模块测试中。77ae753允许 fdReady() 测试替身仅执行一次，并返回指定值。33fa396重构 Wait 对象，通过 waitRemains() 暴露剩余等待时间。
新功能：
允许在版本化存储（versioned storage）上的仓库中按目标时间点读取数据。（由 Stefan Fercot、David Christensen 审核。）
archive-get、info、repo-get、repo-ls、restore和verify命令可以读取启用版本管理的 Azure、GCS 或 S3 存储中，仓库在repo-target-time时刻的状态。即使仓库被意外或恶意删除、损坏，也能据此恢复。允许在没有备库的情况下继续执行已请求的备库备份。（由 Stefan Fercot 审核。）
设置
backup-standby=prefer后，备库可用时从备库备份，否则从主库备份。如果备库能够响应，但备份开始后无法与主库同步，此设置无济于事。
改进：
在
info命令文本输出中汇总备份引用列表。（由 Stefan Fercot 贡献，David Steele 审核。）备份引用列表可能很长，因此
info命令的文本输出现在会对其进行汇总。指定--set时仍显示完整列表。每次 S3 认证时刷新 web-id 令牌。（由 Brent Graveland 贡献，David Steele 审核。）
AWS_WEB_IDENTITY_TOKEN_FILE指定的令牌文件此前仅在启动时读取一次，因此令牌可能在长时间操作期间过期。现在每次认证都会读取令牌。在帮助信息中正确显示索引选项的当前值。（由 David Christensen 审核。）
索引选项显示的当前值此前始终是第一个索引的值，例如
pg1-path。选项帮助现在会列出每个索引的值；如果有多个值，选项列表会显示<multi>。仅在内容发生变化时才保存
backup.info。（由 Stefan Fercot 审核。）即使
backup.info未发生变化，expire此前也会保存它。减少保存次数还使版本化存储上的目标时间更容易选择。移除恢复过程中并行读取文件的数量限制。（由 David Christensen 审核。）
此前协议一次只能在远端读写一个文件，因此恢复也只能逐个读取仓库文件。现在协议命令可以复用同一连接交错执行，使恢复能够同时读取多个文件，例如一个文件包及其中某个文件的块级增量数据。
改进 SFTP 错误信息。（由 Reid Thompson 贡献，David Steele 审核。）
SFTP 错误此前仅以数字报告，现在还会包含错误描述。
文档新功能：
文档改进：
阐明
data_directory的来源。（由 Stefan Fercot 贡献，David Steele 审核，Matthias 建议。）pg-path应与 PostgreSQL 报告的data_directory一致，该值可能不同于postgresql.conf中的设置。优化摘要（summary）是否使用小写的判断逻辑。（由 Daniel Westermann 建议。）
文档中以专有名称或缩写（例如 PostgreSQL）开头的摘要，不再被转换为小写。
v2.53.1 版本说明
PostgreSQL 17 支持
发布于 2024 年 8 月 19 日
漏洞修复：
修复以 root 用户运行
restore时的权限问题。（由 Stefan Fercot 审核，Will M. 报告。）以 root 运行
restore时，pg_control的所有者会被设为 root。如果基础路径不存在，以 root 执行恢复也会失败。修复延迟连接报错时的段错误。（由 David Christensen 审核，Anton Glushakov 报告。）
如果连接错误延迟到后续等待时才被报告，就可能导致段错误。
跳过 SFTP 的本地仓库重复检查。（由 Reid Thompson 修复，David Steele 审核，Anton Kurochkin 报告。）
检查本地仓库是否被重复配置的逻辑，此前也应用于 SFTP 仓库，而 SFTP 仓库始终是远程仓库。
改进：
支持 PostgreSQL 17。
PostgreSQL 17beta3 更改了控制文件和 WAL 格式，这在 beta 版中并不常见。
提交
189d15d
v2.53 版本说明
并发备份
发布于 2024 年 7 月 22 日
重要说明：log-level-stderr 选项的默认值已从 warn 改为 off，使仅重定向 stdout 时更容易捕获错误。若要保留此前的行为，请设置 log-level-stderr=warn。
打包维护者注意：meson 构建现在要求安装 lz4 库。
打包维护者注意：meson 构建现在要求编译器支持 __builtin_clzl() 和 __builtin_bswap64()。
漏洞修复：
修复文件已存在时 SFTP 重命名失败的问题。（由 Reid Thompson 修复，David Steele 审核，ahmed112212 报告。）
某些 SFTP 服务器使用此前未处理的错误来报告文件已存在，因此将文件重命名为已有文件名时会失败。
新功能：
允许在不同仓库上并发执行备份。（由 Reid Thompson、Stefan Fercot 审核。）
锁现在按 stanza 和仓库划分，不再仅按 stanza 划分，因此同一 stanza 的备份可以同时在不同仓库运行。PostgreSQL <= 9.5 不支持这种方式。
cfb8aa2为 31c7824a 遗漏的 stanza 命令添加远程锁。支持基于 IP 的 SAN（主题备用名称）用于 TLS 证书验证。（由 David Christensen 贡献，David Steele 审核。）
现在支持验证主题备用名称为 IP 地址的证书，例如
IP:1.2.3.4。IPv4 和 IPv6 地址都必须精确匹配。
改进：
将
log-level-stderr选项默认值设为off。（由 Greg Sabino Mullane、Stefan Fercot 审核。）收集日志时如果仅重定向 stdout，写入 stderr 的警告和错误往往会丢失。显式设置的
log-level-stderr不受影响。允许 PostgreSQL <= 10 使用非默认 WAL 段大小。（由 Viktor Kurilko 贡献，David Steele 审核。）
PostgreSQL <= 10 可以在构建时使用不同的 WAL 段大小，Greenplum 等分支则通过
initdb设置。新增检查 SFTP 授权日志的提示信息。（由 Vitalii Zurian 贡献，Reid Thompson、David Steele 审核。）
SFTP 认证失败时，错误现在会提示服务器上的授权日志可能包含更多详情。
使用合适的单位显示时间选项的默认值和允许值。
时间选项的默认值和允许值此前以秒显示，较大的值难以阅读。现在不再允许小数秒，因此
archive-timeout=0.5这样的值必须改写为archive-timeout=500ms。提交
3a2266f要求 OpenSSL >= 1.1.1。
提交
cf8625d
文档改进：
阐明
archive-push多仓库模式的行为。（由 Stefan Fercot 审核。）某个仓库发生故障时，除非启用
archive-async，否则archive-push无法继续向其他仓库推送。
v2.52.1 版本说明
漏洞修复
发布于 2024 年 6 月 25 日
漏洞修复：
修复副本上的文件大于主库对应文件时出现的问题。（由 Stefan Fercot 审核，Nicolas Lassimonne 报告。）
使用块级增量从备库备份时，如果某个文件在主库和备库上的大小不同，下一次差异或增量备份会存储主库上的大小。再下一次备份就会因 “repo size must be > 0” 而失败。
83aaa86添加使用块级增量从备库备份的单元测试。
v2.52 版本说明
PostgreSQL 17beta1 支持
发布于 2024 年 5 月 27 日
打包者注意：pgBackRest 的构建系统现已切换为 meson。autoconf/make 构建将不再接收新功能，并将在后续版本中移除。
新功能：
新增 GCS 批量删除支持。（由 Reid Thompson 审核。）
文件改为通过批量请求删除，不再为每个文件单独发出请求，可加快
expire等从仓库删除文件的命令。支持 S3
SSE-C加密。（由 Tim Jones 审核，Tim Jones 建议。）设置
repo-s3-sse-customer-key可让 S3 在数据传输完成后，用提供的密钥加密数据。这不如通过repo-cipher-type在传输前加密安全。支持 PostgreSQL 17beta1。（由 Stefan Fercot 审核。）
添加 PostgreSQL 17 的目录版本和 WAL 魔数。
改进：
允许在 meson 构建中显式禁用可选依赖项。（由 Michael Schout 贡献，David Steele 审核。）
即使相应库已安装，meson 构建也可以禁用可选功能，以满足 FreeBSD 等平台的要求。默认情况下，找到库便启用相应功能。
在 meson 构建中动态查找 python。（由 Michael Schout 贡献，David Steele 审核。）
meson 构建现在会查找 Python 安装，而非要求 PATH 中必须存在
python3可执行文件，例如只安装了python3.9时也能构建。meson 最低版本现在为 0.47。55e9969将 meson 最低版本提高到 0.47。在 meson 中将
pgbackrest构建目标标记为可安装。（由 Bradford Boyle 贡献，David Steele 审核。）
文档改进：
v2.51 版本说明
Meson 构建系统
发布于 2024 年 3 月 25 日
漏洞修复：
跳过块级增量 delta 恢复中的零长度文件。（由 Sebastian Krause、René Højbjerg Larsen 审核，Sebastian Krause 报告。）
已存在的零长度文件会使块级增量 delta 恢复在块校验和过滤器中失败。由于这些文件没有可复用的内容，现在会跳过它们。
修复存储列表中的性能回归问题。（由 Stephen Frost 审核，Maksym Boguk 报告。）
列出路径时，此前会请求每个文件的详细信息，在对象存储等场景下可能很慢。现在只请求列表所需的信息。
修复备份期间文件大小发生变化时的进度日志记录问题。（由 Stephen Frost 审核，samkingno 报告。）
改进：
改进双栈连接（dual stack）支持。（由 Stephen Frost 审核，Timothée Peignier 建议。）
主机名解析出多个地址（例如 IPv4 和 IPv6）时，会遵循 RFC 8305 的“Happy Eyeballs”方式：给前一个地址合理的连接时间后，就尝试下一个地址。不失败也未连接成功的尝试，不再耗尽全部可用时间。
将 meson 作为主要构建系统。（由 Stephen Frost 审核。）
测试和文档构建现在使用 meson 构建系统。模块外不使用的函数现在会隐藏，可减小二进制文件体积。
在非 delta 增量备份期间检测未发生变化的文件。（由 Stephen Frost 审核。）
执行不启用 delta 的差异或增量备份时，如果文件可容纳于单个缓冲区，或它是块级增量文件，就会与前一次备份中的文件比较；若未改变，则仅引用它，不再重新存储。
防止因移除
backup_label而导致无效恢复。（由 Stephen Frost 审核。）如果从已恢复的集群中删除
backup_label，PostgreSQL 会使用pg_control中的检查点执行崩溃恢复，几乎总会导致集群损坏。恢复现在会将pg_control中的检查点设为无效，使后续恢复报错，而非造成损坏。pg_controldata会将该检查点显示为0/DEAD。改进
archive-push的 WAL 段队列处理。（由 Stephen Frost 审核。）此前会读取队列中每个 WAL 段的大小来计算队列大小。现在统一使用第一个段的大小。
将恢复继续（resume）功能限制为全量备份。（由 Stephen Frost、Stefan Fercot 审核。）
启用 delta 的差异和增量备份无法正确续传，且自前一次备份后发生变化的文件，在续传前很可能再次改变。现在仅允许全量备份续传。
更新块级增量备份的恢复继续功能。（由 Stephen Frost 审核。）
续传此前会移除块级增量文件，因此虽然能够工作，却会重新复制所有这些文件。现在续传时会保留块级增量文件。
支持使用
--version和--help查看版本和帮助信息。（由 Greg Sabino Mullane 审核，Greg Sabino Mullane 建议。）--version和--help现在与大多数程序的行为一致。查看特定命令或选项的帮助时，请使用help。为 autoconf/make 构建添加详细的回溯（backtrace）信息。（由 Stephen Frost 审核。）
autoconf/make 构建中的错误堆栈跟踪现在包含 libbacktrace 提供的详情；性能测试表明，这不会产生明显开销。
文档改进：
更新对
recovery.conf的引用说明。（由 Stefan Fercot 审核，Stephen Frost 建议。）提到
recovery.conf的地方现在也包含新版 PostgreSQL 使用的postgresql.auto.conf。
v2.50 版本说明
性能改进与漏洞修复
发布于 2024 年 1 月 22 日
漏洞修复：
修复块级增量恢复中的短读（short read）问题。（审核：Stephen Frost. 测试：Brent Graveland. 报告：Adol Rodriguez, Brent Graveland.）
压缩超级块的末尾可能带有标记数据结束的字节，虽然解压本身不需要这些字节。根据缓冲区与数据的对齐方式，这些字节可能未被读取，导致恢复失败。
修复
info输出中因备份进度溢出导致的显示错误。（由 Robert Donovan 修复，Joe Wildish 审核。）锁文件中的大小此前按 32 位值读取，因此
info命令无法报告超过 4GiB 的备份进度。
改进：
在块级增量 delta 恢复期间保留部分文件。（由 Stephen Frost 审核。）
小于预期的文件此前不会在块级增量 delta 恢复中保留，尽管其数据块可以复用，例如重试失败的恢复，或覆盖较小文件进行恢复时。
新增对备用编译时页面大小的支持。（由 Viktor Kurilko 贡献，David Steele 审核。）
PostgreSQL 可以使用不同的页面大小构建，例如 4096，Greenplum 等分支便采用这种方式。
使用 bundling 时，跳过备份期间被截断的文件。（由 Georgy Shelkovy 贡献，David Steele 审核。）
文件分配到文件包后，如果被截断为零长度，此前仍会存入包中，在调试构建中触发断言失败。现在会跳过这些文件。
02eea55文件打包时跳过备份期间被截断的文件。; 拉取请求 #2227c879509允许 backupFile() 返回 const 校验和缓冲区。9049fec重构文件打包时跳过备份期间被截断文件的逻辑。v2.49 中的开发变更：
337da35添加测试，展示打包文件在备份期间被截断时的行为。改进 SFTP 存储错误信息。（由 Reid Thompson 贡献，David Steele 审核。）
v2.49 版本说明
移除 PostgreSQL 9.3 支持
发布于 2023 年 11 月 27 日
漏洞修复：
修复重试机制的回归问题。（由 Stephen Frost 审核，Norman Adkins、Tanel Suurhans、Jordan English、Timothée Peignier 报告。）
v2.48 移除了操作耗尽整个超时时间后的一次重试，导致超时直接变成错误，例如等待对象存储套接字可写时。现在即使超时已到，也会再重试两次。
3c116e1移除未使用的头文件。修复 SFTP 存储驱动中递归路径删除的问题。（由 Reid Thompson 修复，Stephen Frost 审核，Luc 报告。）
某些 SFTP 服务器在试图把目录当作文件解除链接时，会报告权限不足而非一般失败，导致在这些服务器上递归删除路径失败。
改进：
移除对 PostgreSQL
9.3的支持。（由 Stephen Frost 审核。）按照支持五个已结束生命周期的 PostgreSQL 版本的策略，不再支持 PostgreSQL 9.3。
文档新功能：
记录维护者选项。（由 Stefan Fercot 审核。）
维护者选项现在有独立的文档章节，说明使用注意事项，
pg-version-force也不再是内部选项。更新 PostgreSQL >= 13 的时间点恢复（PITR）文档。
从 PostgreSQL 13 起，未到达恢复目标时会报错。时间点恢复章节现在既适用于 PostgreSQL 13 及后续版本，也适用于更早版本。
提交
eb69e2e
测试套件改进：
允许在未安装
libssh2的情况下运行config/load单元测试。（由 Reid Thompson 贡献，David Steele 审核，Wu Ning 建议。）
v2.48 版本说明
仓库存储标签
发布于 2023 年 9 月 25 日
漏洞修复：
修复在没有块列表的情况下恢复块级增量备份的问题。（审核：Stephen Frost. 测试：Burak Yurdakul. 报告：Burak Yurdakul.）
文件时间戳改变但内容未变时，会写入一个没有数据块的块映射。在一次文件包读取中，如果该映射位于一个未使用块级增量存储的文件之后，就不会被解密。受影响的文件足够多时，会耗尽重试次数，导致恢复失败。
新功能：
新增
--repo-storage-tag选项，用于创建对象标签。（由 Stephen Frost、Stefan Fercot、Timothée Peignier 审核。）设置
repo-storage-tag可为写入 S3、GCS 或 Azure 仓库的对象添加标签。标签按仓库分别设置。为 SFTP 存储驱动添加已知主机（known hosts）检查。（由 Reid Thompson 贡献，Stephen Frost、David Steele 审核。）
现在默认根据 known hosts 文件检查 SFTP 主机密钥，即
repo-sftp-host-key-check-type=strict。设置repo-sftp-host-key-check-type=accept-new可自动添加新主机，设置repo-sftp-host-key-check-type=none则像以前一样跳过检查。支持双栈（dual stack）连接。（由 Stephen Frost 审核。）
现在会依次尝试主机名解析出的每个地址，例如先尝试没有到主机路由的 IPv6 地址，再尝试 IPv4 地址，直到连接成功或超时。重复的重试错误也会在错误信息中汇总。
5314dbf调整 Wait 对象，提高嵌套使用时的准确性。c180513在 ErrorRetry 输出中汇总重试错误。在
info命令的 JSON 输出中新增已完成/总计备份大小字段。（由 Stefan Fercot 贡献，David Steele 审核。）info命令的 JSON 输出现在包含进行中备份的已完成大小和总大小，使其他程序可以监控进度。
改进：
check命令支持多 stanza。（由 Stephen Frost 审核。）未指定
stanza时，check命令现在会检查配置中的所有 stanza。重试读取
pg_control，直到校验和有效。（由 Stefan Fercot、Stephen Frost 审核。）在 ext4 等某些文件系统上，并发写入期间读取
pg_control可能得到部分新、部分旧的撕裂数据。现在会重试读取，直到校验和有效。优化成功备份后的 WAL 段检查。（由 Stephen Frost 审核。）
备份后检查 WAL 段时，此前每个段都会列举一次存储内容。现在每个 WAL 目录只列举一次，并复用列表。
改进 GCS 多部分上传性能。（由 Reid Thompson 审核。）
分段上传中的每个分段现在会在数据就绪后立即上传。
允许在 stanza 停止时运行
archive-get命令。（由 Tom Swartz、David Christensen、Reid Thompson 审核。）archive-get命令不会写入仓库，因此现在可像restore一样，在 stanza 已停止时运行。提交
fbd992a支持 SFTP 公钥/私钥路径中的前导波浪号（
~）。（由 Reid Thompson 贡献，David Steele 审核。）repo-sftp-private-key-file和repo-sftp-public-key-file的路径现在可按文档所述以~开头。在续期认证令牌前重新加载 GCS 凭据。（由 Stephen Frost 审核，Daniel Farina 建议。）
现在会在更新认证令牌之前重新读取服务密钥文件，因此可以在命令运行期间更换密钥。
文档漏洞修复：
修复配置参考中
tls-server-address选项的示例。（由 Hartmut Goebel 修复，David Steele 审核。）示例中的
::*无效。IPv4 应使用*，IPv6 应使用::。修复命令参考中
filter选项的示例。提交
cb3ff6e
测试套件改进：
允许在未安装
libssh2的情况下运行storage/sftp单元测试。（由 Reid Thompson 贡献，David Steele 审核，Wu Ning 建议。）
v2.47 版本说明
性能改进与漏洞修复
发布于 2023 年 7 月 24 日
漏洞修复：
在 delta 备份期间，在 manifest 中保留块级增量信息。（由 Stephen Frost 审核，Francisco Miguel Biete Banon 报告。）
如果文件发生变化，以其当前状态作为新文件时不会使用块级增量（例如缩小到块级增量阈值以下，或时间戳前移足够久），它的块级增量信息此前会从 delta 备份的清单中丢失，即使该文件仍可引用前一次备份。
1d42aed改进 command/backup 单元测试中对引用文件的验证。修复
verify命令中的块级增量文件名问题。（由 Reid Thompson 审核，Francisco Miguel Biete Banon 报告。）对于存储在文件包之外的块级增量文件，
verify命令此前使用压缩扩展名而非.pgbi，导致无法找到文件。修复从备库备份时错误触发自动 delta 备份的问题。（由 Stephen Frost 审核，krmozejko、Don Seiler 报告。）
备库上的文件大小可能不同于主库，例如空闲空间映射文件。下一次增量备份可能因此检测到主库文件大小改变，转为按校验和进行 delta 比较，耗时可能大幅增加。现在会在清单中保留原始大小，用于后续比较。
恢复类型为
type=none时，跳过 PostgreSQL >= 12 的recovery.signal文件。（由 Stefan Fercot 审核，T.Anastacio 报告。）对于 PostgreSQL >= 12，设置
type=none时不再写入recovery.signal，与更早版本的行为保持一致。修复差异/增量备份的唯一标签生成问题。（由 Andrey Sokolov 修复，David Steele 审核。）
如果至少有两个全量备份，而最新的备份已过期，差异或增量备份此前会因与该过期全量备份的标签比较而失败，表现得像系统时钟回拨。
修复无备份过期时基于时间的归档过期问题。（由 Stefan Fercot 审核。）
基于时间的保留条件已满足、但没有备份过期时，此前不会清理归档，而是记录 “time-based archive retention not met”。必须再创建一个备份，较早的 WAL 才会过期。
改进：
提升 SFTP 存储驱动的性能。（由 Stephen Frost、Reid Thompson 贡献，David Steele 审核。）
libssh2 无法继续时，SFTP 存储驱动此前会等待固定时长。现在改为等待套接字可读或可写。
e280ed9使 storage/sftp 中的结果码处理更加一致。125676a清理 storageSftpNew() 中的初始化和握手逻辑。在
info命令的日期/时间输出中添加时区偏移量。（由 Stefan Fercot、Philip Hurst 审核，Philip Hurst 建议。）info命令输出的时间戳现在包含时区偏移量，可直接作为恢复目标，例如用于--target。9efd5cd为 info 命令的日期时间输出添加时区偏移量。; 议题 #2093; 拉取请求 #2095aa229a1根据 Coverity 的报告修改 time_t 类型转换。集中处理不支持功能的错误。（由 Stefan Fercot 审核。）
对于编译时未包含的功能（如 lz4），错误信息现在更加详细且一致。指定编译时未包含的 SFTP 存储时，不再触发断言失败。
de46276重构 config/parse 模块中的允许列表处理。
文档改进：
v2.46 版本说明
块级增量备份与 SFTP 存储
发布于 2023 年 5 月 22 日
新功能：
支持块级备份（block incremental backup）。（由 John Morris、Stephen Frost、Stefan Fercot 审核。）
块级增量仅存储文件自前一次备份后变化的部分，可在对大文件进行差异和增量备份时节省空间与时间。通过
repo-block启用，且必须同时启用repo-bundle。支持 SFTP 作为仓库存储。（由 Reid Thompson 贡献，Stephen Frost、David Steele 审核。）
设置
repo-type=sftp和repo-sftp-host，即可将仓库存储在 SFTP 服务器上。v2.42 中的开发变更：
支持 PostgreSQL 16。（由 Stefan Fercot 审核。）
添加 PostgreSQL 16 的目录版本和 WAL 魔数。
改进：
允许跳过页头检查。（由 David Christensen 审核，David Christensen 建议。）
验证页面校验和时进行的页头检查，可能对加密页面误报错误。设置
page-header-check=n可跳过这些检查；它们默认启用。恢复期间避免对恢复文件调用
chown()。（由 Stefan Fercot、Marcelo Henrique Neppel 审核，Marcelo Henrique Neppel 建议。）恢复时，对所有者已经正确的已恢复文件会跳过
chown()，但对写出的恢复配置文件却不会。现在，如果所有者已经正确，Posix 驱动也会跳过chown()。为 HTTP 重试添加错误重试详情。
HTTP 重试后仍发生错误时，现在会报告重试次数和持续时间。
801e396将错误模块移到 common/error 目录。df419b3改进重试错误信息。f33e1cf为 HTTP 重试添加错误重试详情。
文档改进：
添加关于使用恢复类型
type=none的警告说明。（由 Stefan Fercot 审核。）type=none恢复在结束时不会递增时间线，这可能使 PostgreSQL 归档重复的 WAL；重复 WAL 被拒绝后可能导致磁盘占满，还可能使pg_rewind等工具失败或损坏集群。文档现在对此发出警告。添加关于在已创建仓库上运行
stanza-create的注意事项。已存在的 stanza 会被跳过，因此可以安全地重复运行
stanza-create，例如配置新仓库后。提交
0c1f823
v2.45 版本说明
块级增量备份（测试版）
发布于 2023 年 3 月 20 日
漏洞修复：
默认跳过为离线备份恢复时写入
recovery.signal的操作。（由 Stefan Fercot 审核，Marcel Borger 报告。）在 PostgreSQL >= 12 上，如果备份是在
wal_level=minimal下离线创建的，recovery.signal会导致 PostgreSQL 无法启动。恢复离线备份时，现在默认不写入该文件，除非显式设置了type，例如对以更高wal_level创建的离线备份执行时间点恢复。0818601在 command/restore 单元测试中设置清单的 online 标志。2fa7e53恢复离线备份时，默认跳过写入 recovery.signal。; 议题 #2018; 拉取请求 #2019
新功能：
支持块级增量备份（BETA 测试版）。（由 John Morris、Stephen Frost、Stefan Fercot 审核。）
块级增量仅存储文件自前一次备份后变化的部分，而非整个文件。通过
repo-block启用，且必须同时启用repo-bundle。该功能处于 beta 阶段，还需设置beta选项。请勿用于生产环境：正式发布前，磁盘格式还会改变。089fae0在 real/all 测试输出中添加块级增量。3feed38改进 IoChunkedRead 的文件结束处理。d520816从 deltaMapNew() 中移除参数列表。779efe0统一将块级增量大小声明为 size_t。dffc933将 DeltaMap 重命名为 BlockHash。a9867cb添加 repo-block-age-map 和 repo-block-size-map 选项。16ac5ee重命名清单中的块级增量键。da91858为压缩类型添加可选的原始格式。7e5adc0对文件打包和块级增量备份使用原始压缩和加密格式。8b5153a块级增量备份超级块。; 拉取请求 #1996210bed4块级增量校验和改用 xxHash，而非 SHA-1。6252c0e在块级增量备份的 info 信息中排除备份集大小。1119a53将 BlockHash 重命名为 BlockChecksum。6b409d0根据测试更新默认块大小和超级块值。1281a6e确保块大小等于超级块大小时不会产生续接块。5c1f78d修复 blockIncrProcess() 中的笔误。c30d3e4块级增量映射修复与改进。; 拉取请求 #202624f7252添加 beta 功能基础设施。04d224b添加块级增量备份的 beta 功能标记及文档。v2.44 中的开发变更：
912eec6块级增量备份。; 议题 #959; 议题 #1806; 议题 #1913; 拉取请求 #1916v2.42 中的开发变更：
c647bcb为备份期间的文件处理添加清单标志。; 拉取请求 #1889102ce5d为清单添加持久化引用列表。; 拉取请求 #1890ac99201为 cvtUInt64FromVarInt128() 添加 bufferSize，以进一步限制读取范围。5602f17为 IoRead/IoWrite 添加 varint-128 编解码。; 拉取请求 #1891352cbf1将 ManifestFile 的布尔值改为位字段。e7e106f在 restoreFile() 中使用只读存储计算校验和。909be41调换 command/backup 和 command/restore 单元测试。1730ef4为 storageNewWriteP() 添加 noTruncate 标志。; 拉取请求 #1898fee38c2以处理器数组的形式向远程存储传递过滤器。5fceee8添加 backupFileRepoPathP()。221db61缩短 real/all 集成测试矩阵中的名称。c9db7bc更新 cipherBlockNew()，允许可选参数。58b3c91为 CipherBlock 添加原始模式以节省空间。
改进：
仅保留一个全为默认值的组索引。（由 Stefan Fercot 审核。）
不适用的选项（例如
repo2-type不是s3时的repo2-s3-key）可能创建一个只有默认值的虚假仓库。现在会移除只有默认值的仓库和 PostgreSQL 索引，除非已没有其他索引。
文档改进：
添加在
2.x版本之间升级的明确说明。（由 Christophe Courtois 贡献，David Steele 审核。）用户指南新增章节说明：在
2.x版本之间升级，只需安装新的二进制文件。如果没有使用旧版本不支持的功能，也可以降级。移除引入 TLS 后已过时的 SSH 相关说明。
repo-host、pg-host及其端口选项的帮助不再将 SSH 作为唯一远程协议，SSH 压缩相关的详细说明也已移除。提交
c5907a2
v2.44 版本说明
移除 PostgreSQL 9.0/9.1/9.2 支持
发布于 2023 年 1 月 30 日
改进：
移除对 PostgreSQL
9.0/9.1/9.2的支持。（由 Stefan Fercot 审核。）pgBackRest 现在支持十个 PostgreSQL 版本：五个仍受支持的版本，以及最近五个已结束生命周期的版本。以 PostgreSQL 15 为准，这意味着不再支持
9.0、9.1和9.2。当没有备份与当前 PostgreSQL 版本匹配时，
restore操作报错退出。（由 Stefan Fercot 贡献，David Steele 审核，Soulou 建议。）执行
stanza-upgrade后若未创建新备份，恢复此前会使用最新备份，而该备份来自旧 PostgreSQL 版本。以此方式创建的副本可能失败。现在这种情况会报错，除非指定了set或type=time/type=lsn。为每种
compress-type添加compress-level的范围检查。（由 Stefan Fercot 审核，gkleen、ViperRu 建议。）此前所有
compress-type的compress-level范围都是0-9。这是gz的范围，却只是lz4和zst支持范围的一部分。现在每种类型使用各自的范围，例如zst为-7至22。
文档改进：
添加关于在 Azure 存储上启用"分层命名空间"的警告。（由 Stefan Fercot 审核，Vojtech Galda、Pluggi、asjonos 建议。）
启用“分层命名空间”后，Azure 要求单独删除目录，导致
expire失败。用户指南现在明确提醒不要启用它。在监控示例中添加换行符替换处理。（由 Stefan Fercot 审核，rudonx、gmustdie、Ivan Shelestov 建议。）
当
info输出包含换行符（例如某些错误信息中）时，监控示例会失败，因为COPY会将\n转换为jsonb不接受的实际换行符。示例现在会在转换为jsonb之前替换换行符。阐明
target-action在各 PostgreSQL 版本上的行为。（由 Chris Bandy 贡献，David Steele、Anton Kurochkin、Stefan Fercot 审核，Anton Kurochkin、Chris Bandy 建议。）pause的效果取决于hot_standby和 PostgreSQL 版本。设置hot_standby=off时，在 PostgreSQL >= 12 上，pause等同于shutdown；在更早版本上则等同于promote。更新并完善索引页面内容。（由 Stefan Fercot 审核。）
关于其他备份方案不支持并行处理的章节已不再准确，现已改写。其他章节也更新了术语，并改进了表达。
为网站添加深色模式。（由 Stephen Frost 建议。）
浏览器偏好深色配色时，网站会使用深色配色。
提交
ed818b3
v2.43 版本说明
漏洞修复
发布于 2022 年 11 月 28 日
漏洞修复：
修复差异/增量备份中缺少引用的问题。（由 Stefan Fercot 审核，Marcel Borger、ulfedf、jaymefSO 报告。）
在 v2.42 中，如果前一次备份由更早版本创建，差异或增量备份会因 “unable to find ‘…’ in string list” 而失败。现在为旧版本清单生成的引用列表会包含该备份自身的标签。
28f6604移动 info/manifest 单元中的 manifestBackupLabelSet() 测试。
改进：
当选项未指定索引时，添加相应提示信息。（由 Stefan Fercot 审核。）
对必须指定索引的选项（例如
repo-storage-ca-file），错误现在会提示带索引的名称，例如repo1-storage-ca-file。已弃用的选项也会提示其当前名称。
v2.42 版本说明
漏洞修复
发布于 2022 年 11 月 22 日
漏洞修复：
修复文件捆绑模式的
backup/restore中的内存泄漏问题。（审核：John Morris. 测试：Oscar. 报告：Oscar.）恢复此前只有在文件包中的所有文件都恢复后，才会释放某些 I/O 对象。包中包含大量小文件时，内存占用会不断增长，直至恢复因 “unable to allocate” 而失败。备份续传也存在类似但规模较小的泄漏。
修复远程文件短读时的协议错误。（由 Stephen Frost 审核。）
远程文件读取提前结束或中途失败后，会使协议处于错误状态。下一个命令因 “client state is ‘data-get’ but expected ‘idle’” 而失败，原始错误信息也会丢失。现在关闭文件时会读取剩余内容。
ea162e8移动 storage/remote/read 模块中的 storageReadRemoteOpen()。
改进：
使用 bundling 时，不为零长度文件存储引用。（由 Stefan Fercot 审核。）
使用文件打包的差异和增量备份，此前会为零长度文件存储指向前一次备份的引用，但这些文件实际上并不存储在任何备份中。恢复时会忽略该引用，但它仍占用清单空间。
对
pg_start_backup()/pg_stop_backup()使用更通用的描述文字。（由 Greg Sabino Mullane、David Christensen 审核，Greg Sabino Mullane 建议。）PostgreSQL 15 将这些函数重命名为
pg_backup_start()/pg_backup_stop()。日志和文档现在使用不依赖 PostgreSQL 版本的描述。
测试套件改进：
更新
test.pl的--psql-bin选项以匹配命令行帮助。（由 Koshi Shibagaki 贡献，David Steele 审核。）帮助中显示的是
--psql-bin，实际选项名却是--pgsql-bin。现在选项名称已与帮助一致。
v2.41 版本说明
备份注解
发布于 2022 年 9 月 19 日
漏洞修复：
修复非默认仓库使用了错误时间过期策略的问题。（由 Stefan Fercot 审核，Adam Brusselback 报告。）
未指定
repo运行expire时，所有仓库基于时间的repo-retention-full值此前都取自编号最小的仓库。现在每个仓库使用各自的值。修复使用过滤器递归列出目录时的问题。（由 Stephen Frost 审核，Efremov Egor 报告。）
repo-ls同时使用recurse和filter时，如果目录的最后一个条目是含有条目的子目录，可能因重复释放或段错误而失败。原因是在处理子目录条目前，父列表就已被释放。
新功能：
支持备份键值注解（key/value annotations）。（由 Stefan Fercot 贡献，David Steele 审核，Adam Berlin 建议。）
可通过
backup命令的annotation选项为备份添加键值注解，再使用新的annotate命令增添、修改或移除注解。指定set时，info会在文本输出中显示注解；JSON 输出始终包含注解。
改进：
在
info命令的 JSON 输出中支持--set参数。（由 Stefan Fercot 贡献，David Steele 审核，Anton Kurochkin 建议。）指定
set后，info的 JSON 输出现在包含此前仅文本输出显示的详情，例如错误列表和表空间列表。允许为对象存储配置上传分块大小。（由 Stefan Fercot 审核，Anton Glushakov 建议。）
设置
repo-storage-upload-chunk-size可调整 S3、GCS 或 Azure 每个上传分段的大小。更大的分段可能提高性能，但会占用更多内存。默认值保持不变。ff1188f允许在命令行帮助中使用 quote 标签。备份成功后更新
archive.info的时间戳。（由 Stefan Fercot 审核，Alex Richman 建议。）archive.info及其副本此前仅由stanza-create和stanza-upgrade写入，清理旧文件的对象存储生命周期策略可能将其删除。现在每次备份成功后都会更新它们的时间戳。将备库时间线检查移至检查点之后执行。（审核：Stefan Fercot. 测试：Keith Fiske. 建议：Keith Fiske.）
检查备库是否位于预期时间线时，此前使用的是备份开始前的
pg_control。刚完成提升后，备库可能尚未将新时间线写入pg_control，导致备份因 “standby is on timeline … but expected …” 而失败。现在在检查点之后执行检查。改进备份恢复 resume 时的警告信息。（由 Cynthia Shang 建议。）
此前警告的措辞让人以为需要用户采取行动。现在明确说明：无效文件会被移除，随后继续备份。
提交
cbbe93f
文档改进：
在
pgbackrest.service中为kill添加绝对路径。（由 Don Seiler 建议。）pgbackrest.service示例现在在ExecReload中使用/bin/kill。旧版 systemd 要求绝对路径。提交
e9ff524
v2.40 版本说明
OpenSSL 3 支持
发布于 2022 年 7 月 18 日
打包者注意：已添加实验性的 meson 构建，但在可预见的未来，打包者应继续使用 autoconf/make 构建。
改进：
支持 OpenSSL 3。（由 Stephen Frost 审核。）
pgBackRest 现在可使用 OpenSSL 3 构建。弃用警告已被抑制，并会根据 OpenSSL 3 返回的错误码检测意外 EOF。
列出路径内容时创建快照。（由 John Morris、Stephen Frost 审核。）
不排序列出路径时，此前会边读取边处理条目。列举期间如果删除文件，某些文件系统可能跳过仍然存在的文件，导致路径无法删除。现在始终根据路径快照列举条目。
61ca9b5在测试中用 TEST_STORAGE_LIST() 替代 hrnStorageInfoListCallback()。1c0bf0b调整远程协议中空用户和组检查的顺序，并添加测试。72960bb将 strTrunc() 重命名为 strTruncIdx()，并添加新的 strTrunc()。当恢复
type=immediate时，强制设置target-timeline=current。（由 Stephen Frost 审核。）在 PostgreSQL >= 12 上，默认目标时间线为
latest；如果无法从备份到达仓库中的最新时间线，恢复就可能失败。type=immediate恢复不会切换时间线，因此现在将目标时间线设为current。在 delta
restore期间，当文件大于预期时进行截断。（由 Stephen Frost 审核。）delta 恢复此前在文件大小与清单不同时，总会从仓库复制文件。现在先将较大的文件截断为清单中的大小，仅在校验和不匹配时才复制。只追加了内容的文件（如日志）不再需要复制。
当
resume=n时，禁用增量 manifest 文件保存。（由 Reid Thompson 贡献，David Steele 审核。）备份期间会定期保存清单，以供续传使用。现在设置
resume=n时会跳过这些保存操作。在复制开始前将备份完成百分比置为零。（由 Reid Thompson 贡献，David Steele 审核。）
运行中的备份此前只有在复制完第一个文件后才会报告进度。现在开始复制时就将进度设为零。
使用 S3 的
IsTruncated标志判断列表是否需要继续。（审核：John Morris. 测试：Soulou. 建议：Christian Montagne.）新版 Scality 在列表未截断时会发送空的
NextContinuationToken，此前会导致无限循环。现在根据IsTruncated标志判断是否继续列举；如果列表已截断，但令牌缺失或为空，则报告错误。
文档漏洞修复：
在配置参考中跳过内部选项。（由 Francisco Miguel Biete Banon 报告。）
某些仅对部分命令属于内部选项的参数，此前会出现在配置参考中。命令行帮助不受影响。
提交
2643050
文档改进：
测试套件改进：
添加实验性 Meson 构建。（由 Eli Schwartz、Sam Bassaly 审核。）
Meson 的语法比 autoconf/make 简单，性能也更好。它用于代码生成和测试构建，非调试构建会报错。打包维护者应继续使用 autoconf/make。
2feaaea为被其他 C 文件包含的 C 文件添加 .inc 扩展名。b8fc20d添加实验性的 Meson 构建。; 拉取请求 #1765665da12更新 meson.build 中的 include 注释，使其更通用。9fd85a1除调试构建外，禁用 meson 构建。59f148b生成 -fmacro-prefix-map，以从 FILE 中剥离相对路径。0eccbc8Meson 构建可在 0.45 版本上运行。允许向
--test-path选项传递任意路径。（由 Andrey Sokolov 贡献，David Steele 审核。）修复在定义
DEBUG_EXEC_TIME但未定义DEBUG时的编译错误。（由 Andrey Sokolov 贡献，David Steele 审核。）未定义
DEBUG时，使用开始时间的ASSERT()会展开为空，未使用的变量因此导致编译错误。该检查现在使用CHECK()。
v2.39 版本说明
Verify 命令与文件 Bundling
发布于 2022 年 5 月 16 日
漏洞修复：
修复
FINALLY()中抛出的错误导致无限循环的问题。（由 Stephen Frost 审核。）在
FINALLY()块内抛出错误后，此前会返回同一代码块，很可能再次抛出错误并陷入无限循环。现在FINALLY()只执行一次。除其他进程持有锁之外，对所有锁定失败情况报错。（审核：Reid Thompson. 测试：Geir Råness. 报告：Geir Råness.）
archive-get/archive-push因权限等其他原因无法获取锁时，此前不会报错，也不会启动异步进程。用户只会收到笼统的失败信息，且没有异步日志。现在这些失败都会报错。
新功能：
备份文件 bundling，改善对小文件的处理效果。（由 Reid Thompson、Stefan Fercot、Chris Bandy 审核。）
文件打包将仓库中的小文件集中存储，可节省备份时间和空间，尤其适用于创建每个文件开销都较高的对象存储。通过
repo-bundle启用，并用repo-bundle-size和repo-bundle-limit调整。恢复时会用一次读取获取包内相邻的文件。4d2fef1移除重复的 restoreFile() 测试并改进覆盖率。5141370为 ioCopyP() 添加 limit 参数。dca6da8针对文件打包优化 restore 命令。; 议题 #1149; 拉取请求 #16830054677为 backup 命令添加文件包日志。3f66f42将 bundle-* 选项重命名为 repo-bundle-*。; 拉取请求 #1694fe9fd2f启用 repo-bundle 选项时禁用 repo-hardlink 选项。424008d允许处理在备份清单构建后变为零长度的文件。v2.38 中的开发变更：
a79034a为所有存储驱动添加读取范围。; 拉取请求 #1619b791f1c实现恢复文件所有权，无需更新清单内部数据。f84909f修复出错后 Posix 读取偏移量的处理问题。4ca0590重构 backupProcessQueue()，使用 BackupJobData 结构体。16559d9在适当位置使用 PG_FILE_POSTMTRPID 常量。8c062e1从清单中移除 primary 标志。; 拉取请求 #1630b0db4b8简化 mock/all 集成测试中的基础路径权限。575ae77在清单中尽可能将 varNewUInt64() 转为 VARUINT64()。61ce586紧凑存储清单文件结构体以节省内存。; 拉取请求 #1626ca13f11优化 jsonFromStrInternal()。e4df5b7简化清单文件默认值。; 拉取请求 #16327dd657b简化 command/verify 模块中的文件名构造。34d6495备份期间在仓库中打包文件。; 议题 #1149; 拉取请求 #1655efc09db限制可打包的文件。; 议题 #1149; 拉取请求 #1662e6e1122在 manifestFileAdd() 中按引用传递文件。新增
verify命令，用于验证仓库内容的有效性。（由 Cynthia Shang、Reid Thompson 贡献，David Steele、Stefan Fercot 审核。）verify命令检查仓库中的备份和 WAL 是否有效。设置output=text可输出结果，设置verbose可在错误之外，同时列出验证成功的内容。支持 PostgreSQL 15。（由 Stefan Fercot 审核。）
PostgreSQL 15 移除了排他备份，重命名了备份开始和结束函数，并删除了 pgBackRest 已不再使用的
pg_database.datlastsysoid。在
info输出中显示备份完成百分比。（由 Reid Thompson 贡献，David Steele 审核。）在备份运行的主机上，
info会显示运行中备份的完成百分比。JSON 输出将其表示为整数，即百分比乘以 100。d9088b2在 info 输出中显示备份完成百分比。; 议题 #1490; 拉取请求 #1621a6b1adb移除写入锁文件时多余的换行。v2.38 中的开发变更：
22734eb添加 ioBufferReadNewOpen() 和 ioBufferWriteNewOpen()。为
restore命令的--type=lsn自动选择备份。（由 Reid Thompson 贡献，Stefan Fercot、David Steele 审核。）使用
type=lsn时，恢复现在会选择结束 LSN 不晚于targetLSN 的最新备份。08d9e26重构 restore 模块中的目标类型检查，使逻辑更清晰。d8d4132为 restore 命令的 –type=lsn 自动选择备份。; 拉取请求 #1706ea4d73f修正 command/restore 单元测试中 backup-lsn-stop 字段的顺序。当
archive-mode-check被禁用时，抑制现有 WAL 的警告信息。（由 Reid Thompson 贡献，David Steele 审核。）设置
archive-mode-check=n并从多台主机推送 WAL 时，归档中已存在校验和相同的 WAL 文件属于预期情况，不再记录警告。校验和不同时仍会报错。新增 AWS IMDSv2 支持。（由 Nuno Pires 贡献，David Steele 审核。）
IMDSv2 保护为
repo-s3-key-type=auto提供凭据的实例元数据。当 IMDSv2 令牌请求失败时，pgBackRest 会回退到 IMDSv1。
改进：
允许在全量备份（full backup）后更改
repo-hardlink选项。（由 Reid Thompson 审核。）更改
repo-hardlink此前要求重新创建全量备份。现在可随时更改，例如为了使用文件打包而禁用它。提高
backup和restore完成百分比日志的精度。（由 Reid Thompson 贡献，David Steele 审核。）日志中的完成百分比现在精确到小数点后两位，可更频繁地报告大规模备份和恢复的进度。
改进
repo-*命令的路径验证。（由 Reid Thompson 贡献，David Steele 审核。）路径不得包含
//，末尾的/会被移除，绝对路径必须位于仓库路径之内。改进
stop命令以遵循stanza选项。（由 Reid Thompson 贡献，David Steele 审核，ragaoua 建议。）同时使用
force和stanza的stop命令，现在仅终止持有该 stanza 锁的进程。此前会终止所有 stanza 的进程。改进
repo-azure-key无效时的错误信息。（由 Reid Thompson 贡献，David Steele 审核，Seth Daniel 建议。）设置
repo-azure-key-type=shared时，现在会检查repo-azure-key是否为有效的 base64。在
archive-get/archive-push异步出错时，添加检查日志的提示信息。（由 Reid Thompson 审核。）异步进程无法写入状态文件时，
archive-get/archive-push会超时并返回笼统的错误。现在错误会附带异步日志路径提示，该日志中包含实际错误。新增
ClockError，用于处理意外的时钟偏差和时区变更。（由 Greg Sabino Mullane、Stefan Fercot 审核，Greg Sabino Mullane 建议。）在错误信息中显示历史 manifest 文件前，去除其扩展名。（由 Stefan Fercot 审核。）
新备份标签不晚于备份历史中的最新标签时，此前错误信息显示的是历史清单文件名，例如
20220504-222042F_20220504-222141I.manifest.gz。现在仅显示标签。在锁权限错误信息中添加用户：组信息。（由 Reid Thompson 审核。）
无法找到主库集群时添加提示。
“unable to find primary cluster” 错误现在会提示检查：所有可用集群是否都处于恢复状态。
提交
46b7b72
文档漏洞修复：
修复用户指南中对
stanza-update的错误引用。（由 Abubakar Mohammed 修复，David Steele 审核。）提交
3dd7960修复配置参考中
repo-gcs-key-type选项的示例。（由 Reid Thompson 审核。）示例此前为无效值
none，现在改为auto。提交
166039c修复
tls-server-auth示例并添加说明。（由 Reid Thompson 审核。）示例此前缺少客户端 CN，现在改为
client-cn=stanza1。帮助还说明，客户端 CN 不允许使用通配符。提交
c222ce1
文档改进：
简化文档中关于支持版本的描述。（由 Stefan Fercot、Reid Thompson、Greg Sabino Mullane 审核。）
用户指南此前列出了 PostgreSQL 版本范围，使人误以为其他版本不受支持，例如 RHEL 上的 PostgreSQL 12。现在已移除这些范围，并在引言中说明指南覆盖哪些版本。
添加选项类型描述。（由 Reid Thompson 贡献，David Steele 审核。）
配置参考现在统一说明各选项类型，例如大小选项的单位，不再在每个选项下重复描述。
添加备份类型与恢复速度的常见问题解答。（由 David Christensen 贡献，Reid Thompson 审核。）
新增 FAQ 说明：备份类型只影响备份过程，不决定恢复速度。
记录 Pull Request 所需的基础分支。（由 David Christensen 贡献，Reid Thompson 审核。）
贡献指南现在明确说明，拉取请求必须基于
integration分支。
v2.38 版本说明
小型漏洞修复与改进
发布于 2022 年 3 月 6 日
重要提示：info 命令报告的仓库大小现在完全基于 pgBackRest 写入存储的数据量。此前，在某些情况下，pgBackRest 可以检测到存储是否应用了额外的压缩，但此功能已不再支持。
漏洞修复：
对 S3 批量文件删除中的错误进行重试。（由 Reid Thompson 审核，Alex Richman 报告。）
批量删除失败会重试，但批次内单个文件的错误此前不会重试，可能导致 pgBackRest 在过期处理或删除无法续传的备份时终止。现在批次中失败的文件会单独删除，并使用常规 HTTP 重试机制。
允许对 HTTP
connection头部值进行大小写不敏感的匹配。（由 Reid Thompson 审核，Rémi Vidier 报告。）HTTP 规范允许
connection请求头或响应头的值使用任意大小写，例如Close。
新功能：
新增使用 KMS 的 AWS S3 服务端加密支持。（贡献：Christoph Berg. 审核：David Steele. 测试：Tharindu Amila.）
设置
repo-s3-kms-key-id可使用 AWS KMS 管理的密钥加密对象。新增
archive-missing-retry选项。（由 Stefan Fercot 审核。）默认情况下，
archive-get会重试此前已报告缺失的 WAL 段，从而忽略上一次恢复留在 spool 路径中的缺失通知。设置archive-missing-retry=n后，即使仍在归档 WAL，PostgreSQL 也能检测归档结束并转为流复制。此时必须确保恢复开始时 spool 路径为空。为
info命令添加备份类型过滤功能。（由 Stefan Fercot 贡献，David Steele 审核。）设置
type可仅显示该类型的备份，例如type=full。
改进：
在
backup期间页面验证失败时进行重试。（由 Stephen Frost、David Christensen 审核。）页面校验和验证失败后，现在会重新读取该页；只有页面未改变时才报告错误。发生变化说明 PostgreSQL 正在写入，WAL 中会包含完整页面镜像。对零页面的检查也改为验证全部内容为零，不再只检查
pd_upper字段。b489707移动 command/backup 模块中的 command/backup-common 测试。处理未能优雅关闭连接的 TLS 服务端。（审核：David Christensen, Stephen Frost. 测试：Rémi Vidier.）
某些服务器会直接关闭套接字，而非关闭 TLS 连接。如果响应没有内容长度或分块编码，且其内容能够解析，现在会将套接字关闭视为 EOF。这些服务器从 v2.35 起曾无法正常使用。
在
info命令输出中添加备份的 LSN 信息。（由 Stefan Fercot 贡献，David Steele 审核。）指定
set时以及 JSON 输出中，会显示备份的开始和结束 LSN，可用于基于 LSN 的时间点恢复。自动去除
repo-ls路径末尾的斜杠。（由 David Christensen 贡献，David Steele 审核。）对某些仓库存储类型，路径末尾带斜杠会使
repo-ls不显示任何内容。不重试致命错误。（由 Reid Thompson 审核。）
重试致命错误，尤其是内存不足错误，可能导致卡死。现在会直接报告断言和内存错误，不再重试。
8573a2d改进 protocolClientFree() 的协议模块错误测试。8d0cce6协议模块的错误重试测试改用普通错误。移除对 PostgreSQL
8.3/8.4的支持。（由 Reid Thompson、Stefan Fercot 审核。）没有证据表明这些版本仍在使用，而继续支持会占用开发和测试时间。若要备份这些版本或从中迁移，请使用旧版 pgBackRest。
移除尝试检测额外文件系统压缩的逻辑。（由 Reid Thompson、Stefan Fercot 审核。）
复制文件后，pgBackRest 此前会检查其磁盘占用，以检测 ZFS 等文件系统的压缩效果。这部分没有测试，在有大量小文件时很慢，并且妨碍文件打包。
info中的仓库大小现在表示 pgBackRest 实际写入的大小。
文档漏洞修复：
将 TLS 文档中的
repo选项移至global部分。（由 Anton Kurochkin 报告。）用户指南此前在 stanza 配置节中设置这些选项，虽然在某些情况下可行，却不是最佳实践。
提交
53de3e3从 stanza 命令中移除未使用的
backup-standby选项。（由 Stefan Fercot 报告。）stanza-create和stanza-upgrade的命令参考及帮助此前列出了backup-standby，但实际并未使用它。提交
5cbb4a3修复帮助文档和版本说明中的错别字。（由 Daniel Gustafsson 修复，David Steele 审核。）
cacfdd9修复帮助和发行说明中的笔误。; 拉取请求 #16715c332a0修正 cacfdd94 和 f798458e 中的发行说明归因。
文档改进：
在 systemd 服务配置中添加存活检查。（由 Yogesh Sharma 建议。）
pgbackrest.service示例现在会在服务器启动后不久检查它是否仍在运行。此前即使服务器启动失败，也不会报告错误，而 systemd 只是在后台重试。提交
f1bdf3e添加解释 WAL 归档后缀的常见问题解答。（由 Stefan Fercot 贡献，David Steele 审核。）
仓库中 WAL 文件的后缀是其 SHA1 校验和，用于验证文件，不能省略。
说明复制槽不会在恢复时被还原。（由 Reid Thompson 贡献，David Steele、Stefan Fercot 审核，Christophe Courtois 建议。）
v2.37 版本说明
TLS 服务端
发布于 2022 年 1 月 3 日
重要提示：如果 restore 命令找不到与指定时间目标匹配的备份，现在将抛出错误，而之前仅记录一条警告。
漏洞修复：
修复
restoredelta 链接映射中路径/文件已存在时的问题。（由 Reid Thompson 审核，Younes Alhroub 报告。）使用
link-map或link-all将已存在的路径或文件映射为链接时，delta 恢复此前会保留原有路径或文件。现在会将其替换为链接。修复连接重试时的套接字泄漏问题。（由 Reid Thompson 审核，James Coleman 报告。）
在优化构建中，失败连接尝试的套接字此前未关闭，每次重试都会泄漏一个套接字。
新功能：
新增 TLS 服务端。（审核：Stephen Frost, Reid Thompson. 测试：Andrew L’Ecuyer.）
server命令启动 TLS 服务器，可代替 SSH 访问仓库主机和 PostgreSQL 主机。在客户端设置repo-host-type=tls或pg-host-type=tls，并通过tls-server-*选项配置证书和客户端授权。SIGHUP重新加载配置，SIGTERM停止服务器。2d963ce将 server-start 命令重命名为 server。7b3ea88为 TLS 服务器添加 SIGTERM 和 SIGHUP 处理。; 拉取请求 #1572f06101d添加 TLS 服务器文档。; 拉取请求 #1597v2.36 中的开发变更：
ccc255d添加 TLS 服务器。; 拉取请求 #150413d4559检查 getsockopt() 的返回值。v2.35 中的开发变更：
947c7a8重构 cmdLocal()/cmdRemote()，使其接受 ProtocolServer 对象。0999de0将 noop 从 protocolClientNew() 移到本地和远程初始化流程。新增
--cmd选项。（由 Reid Thompson 贡献，Stefan Fercot、David Steele 审核，Virgile CREVON 建议。）将
cmd设为 pgBackRest 写出的命令所应使用的 pgBackRest 可执行文件，例如recovery.conf中的restore_command。
改进：
在备份开始后立即检查归档。（由 Reid Thompson、David Christensen 审核。）
此前 WAL 归档不工作时，只有在复制完所有文件后，备份才会失败。现在在备份开始后立即检查归档。在空闲系统上，会创建恢复点以切换 WAL 段。
为备份添加时间线和检查点检查。（由 Stefan Fercot、Reid Thompson 审核。）
备份现在会检查
pg_control中的检查点和时间线是否对应备份开始时的状态，并确认备库正在跟随主库，即处于同一时间线且其检查点不晚于备份检查点。在备份期间检查集群是否存活且配置正确。（由 Stefan Fercot 审核。）
集群停止或备库提升时，备份现在会立即失败。此前只有到备份结束时才会检测到主库停止，也不会检测备库提升。
当
restore无法找到匹配时间目标的备份时，报错退出。（由 Reid Thompson、Douglas J Hunley 审核，Douglas J Hunley 建议。）此前这只是一条容易被忽略的警告，用户可能花费大量时间恢复一个无法到达目标的备份。
解析 S3/Azure 端点中的协议/端口。（由 Reid Thompson 贡献，David Steele 审核。）
repo-s3-endpoint、repo-azure-endpoint和repo-storage-host现在可以包含协议和端口，例如https://host:9000。当
checkpoint_timeout超过db-timeout时发出警告。（贡献：Stefan Fercot. 审核：David Steele.）设置
start-fast=n时，如果checkpoint_timeout大于db-timeout，备份可能在等待检查点时超时。现在会对这种情况发出警告。在 HTTP 错误输出中添加请求方法（verb）。（由 Christoph Berg 贡献，David Steele 审核。）
允许布尔命令行选项使用 y/n 作为参数。（由 Reid Thompson 贡献，David Steele 审核。）
使备份大小日志与
info命令输出完全一致。（由 Reid Thompson 贡献，David Steele 审核，Mahomed Hussein 建议。）日志中的备份大小现在只包含实际复制的文件，以及
backup_label和tablespace_map。此前，例如主备切换后的增量备份，会记录每个已检查文件的大小。6e63576使备份日志中的大小与 info 命令报告的大小一致。; 议题 #766; 拉取请求 #1562afe77e7更新 6e635764 的贡献者。1e77fc3在日志输出中计入 backup_label 和 tablespace_map 的文件大小。; 拉取请求 #1568a3d7a23使用 infoBackupDataByLabel() 记录备份大小。; 拉取请求 #1573dcb4f09回退 1e77fc3d 对 backupFilePut() 的更改。
文档改进：
以合适的单位显示大小选项的默认值和允许范围。（由 Reid Thompson 审核。）
cff961e集中处理配置呈现期间构建值列表的逻辑。修复
tablespace-map-all选项的错别字并改进文档。（由 Reid Thompson 审核，Reid Thompson 建议。）提交
df89eff移除关于未来多仓库支持的过时说明。（由 David Christensen 建议。）
文档此前声称仅允许一个仓库，但从 v2.33 起就已支持多仓库。
提交
dea7524
v2.36 版本说明
小型漏洞修复与改进
发布于 2021 年 11 月 1 日
漏洞修复：
允许将
global用作 stanza 名称前缀。（由 Stefan Fercot 审核，Younes Alhroub 报告。）以
global开头的 stanza 名称（例如global_stanza）此前会被拒绝，因为配置解析器将其误认为全局配置节。修复 GCS 密钥文件无效时的段错误。（由 Stephen Frost 审核，Henrik Feldt 报告。）
GCS 密钥文件缺少客户端邮箱、私钥或令牌 URI 时，此前会导致段错误。现在会报告错误。
改进：
允许
link-map选项创建新链接。（由 Don Seiler、Stefan Fercot、Chris Bandy 审核，Don Seiler 建议。）link-map此前只能重新映射备份中已有的链接。现在可以为备份中的任意路径或文件创建新链接。d89a677重构 command/restore 单元中的 restoreManifestMap() 测试。cf1a575重构 restoreManifestMap()，改由 link-map 驱动。将
pg/repo选项允许的最大索引值提升至 256。（由 Cynthia Shang 审核。）pg选项的最大索引此前为 8，repo选项为 4。现在均为 256，例如pg256-path。02b06aa将 pg/repo 选项允许的最大索引提高到 256。; 拉取请求 #148171047a9使用 strncpy() 限制复制到 optionName 的字符数。为 AWS S3 添加
WebIdentity认证支持。（审核：James Callahan, Reid Thompson, Andrew L’Ecuyer. 测试：Benjamin Blattberg.）设置
repo-s3-key-type=web-id可在 EKS 环境中自动获取凭据。cfd8233重构 S3 存储驱动，以支持更多认证方式。3879bc6为 AWS S3 添加 WebIdentity 认证。; 议题 #1203; 拉取请求 #15271152f7a修复 tlsClientNew() 调用中参数不匹配的问题。添加
repo-azure-uri-style选项。将
repo-azure-uri-style设为host（默认）或path，可选择 Azure 的 URI 风格。当端点看起来像由多个部分组成的主机名时，Azurite 会使用主机式 URI。提交
096829b在
backup.info中报告备份文件验证错误。（由 Stefan Fercot 贡献，David Steele 审核。）备份中发现的错误（例如无效页面校验和）此前仅在
info指定set时显示。现在通过backup.info中的标志，在文本和 JSON 输出中表明备份包含错误。查看详情仍需指定set。在在线备份恢复日志中添加恢复开始时间。（由 Tom Swartz、Stefan Fercot 审核，Tom Swartz 建议。）
恢复现在会记录后续恢复重放的起始时间，便于判断需要重放多少 WAL。
本地任务失败时，同时报告原始错误和重试信息。（由 Stefan Fercot 审核。）
本地任务重试后仍失败时，现在会先报告原始错误及其堆栈跟踪，再列出重试错误。此前仅报告最后一个错误，而它往往只是协议失步等连锁失败。
136d309允许为 errorInternalThrow() 指定堆栈跟踪。ae40ed6为 HRN_CFG_LOAD() 添加 jobRetry 参数。在
info文本输出中，将页面校验和错误重命名为错误列表。（由 Stefan Fercot 审核。）info文本输出中的标签现在为 “error list”，不再是 “page checksum error”。文件也可能存在对齐错误，而非页面校验和错误。在备库重放超时信息中添加提示。（由 Cynthia Shang、Stefan Fercot 审核，Leigh Downs 建议。）
等待备库重放超时时，现在会提示检查复制是否运行，或禁用
backup-standby改为从主库备份。
文档漏洞修复：
修复用户指南中的错误主机名。（修复：Reid Thompson. 审核：David Steele.）
复制配置此前在
pg_hba.conf中使用了 pg-primary 的 IP 地址，而非 pg-standby 的 IP 地址。
文档改进：
改进选项文档。
buffer-size的帮助现在说明了使用该选项的所有操作；cmd-ssh、repo-host-cmd和pg-host-cmd的描述已统一；archive-header-check则移到了配置参考的归档章节。3763624将 archive-header-check 选项移到归档参考章节。e1f6c06改进 buffer-size 选项文档。fa564ee改进 cmd-ssh、repo-host-cmd 和 pg-host-cmd 选项文档。
v2.35 版本说明
二进制协议
发布于 2021 年 8 月 23 日
重要提示：backup/restore 命令中已复制文件的日志级别已更改为 detail。这使 info 日志级别的输出不再冗杂，如需查看这些信息，请将 backup/restore 命令的日志级别设置为 detail。
漏洞修复：
检测 S3 多部分上传完成阶段的错误。（审核：Cynthia Shang. 测试：Marco Montagna. 报告：Marco Montagna, Lev Kokotov, Anderson A. Mallmann.）
即使 S3 返回 HTTP 成功状态，完成分段上传仍可能失败。现在将不含
ETag的响应视为失败，并重试任务。8e1807c检测 S3 分段上传完成阶段的错误。; 议题 #1116; 议题 #1290; 议题 #1433; 拉取请求 #143825508a4补充 8e187cdb 遗漏的贡献者。修复循环符号链接的检测问题。（由 Stefan Fercot 审核，Rohit Raveendran 报告。）
此前会先跟随链接，再进行检查，循环链接因此可能使清单构建陷入无限递归并崩溃。
仅将选定的
repo选项传递给远端。（由 David Christensen、Cynthia Shang 审核，Greg Sabino Mullane、David Christensen 报告。）远端仅使用一个仓库，其他仓库的选项可能在远端造成冲突。
改进：
新增二进制协议。（由 Cynthia Shang 审核。）
本地和远程进程现在使用二进制 pack 格式通信，不再使用 JSON。pack 更紧凑，生成和解析更快，且具有严格的类型。每条消息集中写入，降低了错误使协议处于异常状态的可能性，消息也不再有大小限制。
2d5cbfc修复 6a1c0337 中二进制协议引入的内存泄漏。f716cb6修复 6a1c0337 中二进制协议引入的释放后使用问题。4fb6384修复 6a1c0337 中二进制协议引入的其他内存泄漏。在
restore时自动创建数据目录。（由 Stefan Fercot 贡献，David Steele 审核，Chris Bandy 建议。）从 Perl 迁移过来的一项检查，阻止了恢复过程创建数据目录。
允许
restore使用--type=lsn。（由 Stefan Fercot 贡献，Cynthia Shang 审核，James Coleman 建议。）在 PostgreSQL >= 10 上，设置
type=lsn并在target中指定 LSN，即可恢复至该 LSN。将
backup/restore已复制文件的日志级别更改为detail。（由 Stefan Fercot 审核，Jens Wilke 建议。）此变更减少了
info日志级别的输出噪声。将日志级别设为detail，可查看每个已复制文件。等待检查点 LSN 赶上重放 LSN 时改为循环等待。（由 Stefan Fercot 贡献，David Steele 审核，Fatih Mencutekin 建议。）
在备库上，检查点 LSN 在
pg_control更新前可能略落后于重放 LSN。现在备份会持续检查，而非立即失败。记录
backup文件总数与restore大小/文件总数。（由 Cynthia Shang 审核。）备份大小现在在备份结束时记录，包含主要复制阶段后加入清单的文件，例如
backup_label和 WAL。恢复现在也会记录总大小和文件总数。
文档漏洞修复：
修复用户指南中错误的主机名。（由 Stefan Fercot 审核，Greg Sabino Mullane 报告。）
某些示例此前显示
pg1而非主机名，安装代码块也无论指定哪个主机，都在构建主机上安装软件包。
文档改进：
更新贡献文档并添加 Pull Request 模板。（由 Cynthia Shang 贡献，David Steele 审核。）
贡献指南现在有目录，并增加了解读测试输出和提交拉取请求的章节。GitHub 现在会为新拉取请求显示模板。
在用户指南中重新整理备份文档。（由 Cynthia Shang 审核。）
“快速启动选项”和“归档超时”章节移至“快速入门 - 执行备份”。仅适用于 PostgreSQL <= 9.6 的“自动停止选项”章节已移除。
在命令参考中阐明
restore的--type行为。（由 Cynthia Shang 贡献，David Steele 审核。）参考文档现在明确说明：目标早于最新备份且
type不是time时，必须指定set。提交
a6691c6修复文档和注释中的错别字。（由 Eric Radman 贡献，David Steele 审核。）
测试套件改进：
添加测试路径在仓库路径内的检查。（由 Greg Sabino Mullane 审核，Greg Sabino Mullane 建议。）
测试路径位于仓库路径内时，由于仓库会被复制到测试路径，会导致奇怪的失败。
test.pl现在会对此报错。添加 CodeQL 静态代码分析。（由 Cynthia Shang 审核。）
CodeQL 现在在 CI 中运行。它发现的问题已修复，例如将
gmtime()/localtime()替换为gmtime_r()/localtime_r()。更新测试以使用标准模式。（由 Cynthia Shang 贡献，David Steele 审核。）
3f9fbc3更新 command/expire 测试，使用标准模式。; 拉取请求 #142003021c6更新 command/stanza 测试，使用标准模式。; 拉取请求 #14268dd882b更新 info/infoArchive 测试，使用标准模式。; 拉取请求 #1436ff95edd更新 command/verify 测试，使用标准模式。; 拉取请求 #143517c9ed0更新 command/info 测试，使用标准模式。; 拉取请求 #1432bffb43e更新 command/check 测试，使用标准模式。; 拉取请求 #1431fb2d111更新 info/infoBackup 测试，使用标准模式。; 拉取请求 #1437065a8c8在单元测试中以字符串常量替代宏定义。; 拉取请求 #1440c620811为 HRN_STORAGE_PUT() 宏添加 timeModified 参数。6a90d46更新 info/manifest 测试，使用标准模式。; 拉取请求 #144462e8d97更新 command/archive 测试，使用标准模式。; 拉取请求 #14498bb0b28更新 command/control 和 command/command 测试，使用标准模式。; 拉取请求 #1456f2ec4e0为 TEST_STORAGE_GET() 宏添加加密参数。4ad0bbd更新 command/backup 测试，使用标准模式。; 拉取请求 #1463117ffe8更新 command/help 测试，使用标准模式。; 拉取请求 #1464ebe5848更新 command/local 和 command/remote 测试，使用标准模式。; 拉取请求 #1466a6cdf5b更新 command/repo 测试，使用标准模式。; 拉取请求 #14674992508更新 command/restore 测试，使用标准模式。; 拉取请求 #14684c9ddf5更新 storage 测试，使用标准模式。; 拉取请求 #1470eeaab6a更新 config 测试（parse 除外），使用标准模式。; 拉取请求 #1473f653b59更新 db/db 测试，使用标准模式。; 拉取请求 #1486
v2.34 版本说明
PostgreSQL 14 支持
发布于 2021 年 6 月 7 日
漏洞修复：
修复先前
restore遗留的缓冲区文件问题。（审核：Cynthia Shang, Stefan Fercot. 测试：Floris van Nee. 报告：Floris van Nee.）前一次恢复留在 spool 路径中的通知，可能使
archive-get将 WAL 段报告为缺失。现在如果在首次检查时发现该通知，会将其移除并再次运行异步进程。如果异步进程没有响应，会报告错误，而非报告 WAL 段缺失。修复检查大量表空间链接时的问题。（审核：Cynthia Shang. 测试：Avinash Vallarapu. 报告：Avinash Vallarapu.）
表空间较多时，链接检查会消耗大量内存并可能崩溃。新的检查速度快得多，内存占用大幅降低，还能检测重复的文件链接。
及时释放不再需要的远程连接，避免其在
restore期间超时。（由 Cynthia Shang 审核，Francisco Miguel Biete Banon 报告。）此前远程连接会在整个恢复期间保持，可能超时，从而在长时间恢复结束时记录一条无害却令人困惑的警告。现在加载完清单后就会关闭这些连接。
修复当有效选项对指定命令无效时的
help显示问题。（由 Stefan Fercot 审核，Cynthia Shang 报告。）查询对该命令无效的选项时，
help此前会发生段错误。
新功能：
新增 PostgreSQL 14 支持。（由 Cynthia Shang 审核。）
相较于 PostgreSQL 13，支持 PostgreSQL 14 不需要修改代码。现在 PostgreSQL 在 beta/rc 阶段更改目录版本时，也无需发布新版 pgBackRest。
为 GCE 实例添加自动 GCS 认证。（审核：Jan Wieck. 测试：Daniel Farina.）
设置
repo-gcs-key-type=auto可在 GCE 实例上从实例元数据获取认证令牌。7b71604使用现有变量设置 GCS 测试服务器端口。26fefa6将 GCS 令牌响应解析重构为独立函数。新增
repo-retention-history选项，用于过期备份历史记录。（由 Stefan Fercot 贡献，Cynthia Shang、David Steele 审核。）设置备份历史的保留天数。默认保留全部历史，仍在仓库中的备份历史永不过期。全量备份清单过期时，其差异和增量备份的清单也会过期。
新增
db-exclude选项。（由 Stefan Fercot 贡献，Cynthia Shang 审核。）恢复通过将指定数据库写为全零稀疏文件来排除它们。PostgreSQL 仍可完成恢复，之后可删除这些数据库。使用
db-include时，db-exclude仅适用于系统数据库template0、template1和postgres。
改进：
将归档过期日志从
detail级别提升至info级别。（由 Cynthia Shang 贡献，David Steele 审核。）在
restore时删除 stanza 归档缓冲（spool）路径。（由 Cynthia Shang、Stefan Fercot 审核。）spool 路径中的文件可能干扰新集群，例如旧的
archive-push确认文件可能使新集群跳过 WAL 归档。在
backup复制期间，不以原子方式写入文件，也不同步路径。（由 Stephen Frost、Stefan Fercot、Cynthia Shang 审核。）由于续传失败备份时会验证校验和，且备份结束时会同步所有路径，因此不需要原子写入。
文档改进：
更新贡献文档。（由 Cynthia Shang 贡献，David Steele、Stefan Fercot 审核。）
贡献指南补充了更多关于编写代码、添加配置选项和测试的示例。
将 RHEL/CentOS 用户指南合并为单一文档。（由 Cynthia Shang 审核。）
第二套指南主要用于说明 PostgreSQL <= 9.5 的
stop-auto，而这些版本现已结束生命周期。参考文档仍保留该选项的说明。阐明
repo-s3-role不是 ARN。（由 Isaac Yuen 贡献，David Steele 审核。）
v2.33 版本说明
多仓库与 GCS 支持
发布于 2021 年 4 月 5 日
漏洞修复：
修复选项警告破坏异步
archive-get/archive-push的问题。（由 Cynthia Shang 审核，Lev Kokotov 报告。）异步进程的选项警告此前会写入已关闭的 stdout，导致进程中止。异步角色现在可能具有与默认角色不同的有效选项，因此更容易触发此问题。现在仅为默认角色记录选项警告。
修复备份期间归档复制中的内存泄漏。（由 Cynthia Shang 审核，Christian ROUX、Efremov Egor 报告。）
使用
archive-copy将 WAL 复制到备份中时会泄漏内存，尤其是在 WAL 需要重新压缩时。修复加密密码生成中的栈溢出问题。（由 Cynthia Shang 审核，bsiara 报告。）
生成密码的缓冲区没有为末尾的零字符预留空间。此问题在使用 musl libc 的 arm64 上被发现。
修复 S3 仓库上
repo-ls/的问题。（由 Cynthia Shang 审核，Lesovsky Alexey 报告。）S3 将
/报告为文件，却不返回预期的响应头，导致错误。现在对于不支持路径的存储，会将/报告为不存在。
新功能：
支持多仓库。（由 Cynthia Shang、David Steele 贡献，Stefan Fercot、Stephen Frost 审核。）
最多可配置四个仓库，例如用于快速恢复的本地仓库，以及用于冗余的远程仓库。
archive-push向所有仓库推送 WAL，各仓库分别安排备份。某些命令可操作所有仓库，其他命令则要求指定repo。仅配置repo1时，无需指定repo。3408f1e增强 expire 命令的多仓库支持。; 拉取请求 #1289e28f6f1处理某个仓库出错时，expire 继续处理其他仓库。; 拉取请求 #1308bec3e20为 archive-get 命令添加多仓库支持。; 拉取请求 #1292118d9e6增强 restore 命令的多仓库支持。; 拉取请求 #1300065b2ff重构 info 命令的 repoMin/Max。0ddc038从集成测试中移除 restore 的默认仓库。13dc8e6将 backup 命令的 –repo 改为可选。; 拉取请求 #1316a1280c4重构 archive-push 命令的警告，使其行为与 archive-get 一致。3b8f0ef为 archive-push 命令添加写入容错。; 拉取请求 #131695063f6将除 stanza-delete 外其他剩余命令的 –repo 改为可选。31c7824允许远程运行 stanza-* 命令。; 拉取请求 #1326支持 GCS 作为仓库存储。（审核：Cynthia Shang. 测试：Daniel Farina.）
设置
repo-type=gcs可将仓库存储在 GCS 或兼容 GCS 的对象存储上。dcb79ab解码 JSON 的 \u 转义字符。1b4b353在 HTTP 和存储模块的适当位置，将 uri 重命名为 path。66a4ff4将路径传给 HttpRequest 之前进行编码。d485609添加 strNewEncode()、strCatEncode() 和 bufNewDecode()。abcbe0f将 encode 模块的多个文件合并为一个文件。edab2a0编码类型判断改用 switch，而非 if-else。f6c3262不再对外暴露 encode 模块的 valid/validate 函数。a1f4fd3添加 ASSERT_MSG()。00b60e5添加 base64url 编码。54c4eb0使远程存储对象可写。新增
archive-header-check选项。（由 Stephen Frost、Cynthia Shang 审核，Hans-Jürgen Schönig 建议。）会根据 PostgreSQL 版本和系统标识符检查 WAL 头，确保 WAL 被推送到正确的 stanza。此检查默认启用，必要时可禁用，例如处理加密 WAL 时。
改进：
选择性恢复时包含重建的系统数据库。（由 Stefan Fercot 贡献，Cynthia Shang 审核。）
被重新创建的系统数据库（
template0、template1或postgres）的 OID，可能使其看起来像用户数据库。现在无论 OID 为何，都会恢复这些系统数据库。从 S3 签名头部中排除
content-length。（由 Cynthia Shang 审核，Brian P Bockelman 建议。）某些代理会修改
content-length头，如果签名包含该头，就会导致认证失败。合并较少使用的仓库存储选项。（由 Cynthia Shang 审核。）
S3 和 Azure 的 CA、主机、端口和 TLS 验证选项重命名为
repo-storage-*，例如repo1-s3-host现在为repo1-storage-host。旧名称仍可使用。允许通过
./configure --with-configdir自定义config-path的默认值。（由 Michael Schout 贡献，David Steele 审核。）打包维护者可在构建时为
config-path设置不同的默认值。不使用此选项时，默认值仍为/etc/pgbackrest。6a717e0在 configure 脚本中设置配置路径。9243962允许通过 ./configure –with-configdir 自定义 config-path 默认值。; 议题 #1251; 议题 #1293; 拉取请求 #1255在
backup期间记录归档复制日志。（由 Cynthia Shang、Stefan Fercot 审核。）
文档改进：
更新参考文档，添加指向用户指南示例的链接。（由 Cynthia Shang 贡献，David Steele 审核。）
命令参考现在链接到包含示例的用户指南章节，部分描述也更加明确，例如
expire的set选项。更新选择性恢复文档，添加注意事项。（由 Cynthia Shang、Stefan Fercot 审核。）
除非指定
type=immediate，否则恢复可能失败，因为 PostgreSQL 在达到一致状态后会将全零页面报告为错误。在 PostgreSQL >= 13 上可以使用ignore_invalid_pages，但应检查日志，确认所选数据库中是否存在无效页面。为
archive-copy文档添加compress-type说明。（由 Cynthia Shang、Stefan Fercot 审核。）archive-push与backup使用不同的compress-type时，WAL 必须重新压缩，开销可能很高。添加每种
compress-type值对应的compress-level默认值。（由 Cynthia Shang 贡献，David Steele 审核。）默认压缩级别分别为：
bz2为 9，gz为 6，lz4为 1，zst为 3。添加关于 NFS 所需设置与 PostgreSQL 相同的注意事项。（由 Cynthia Shang 贡献，David Steele 审核。）
v2.32 版本说明
仓库命令
发布于 2021 年 2 月 8 日
漏洞修复：
- 修复因先前恢复操作部分删除备份后，再次
resume时失败的问题。（由 Cynthia Shang 审核，Tom Swartz 报告。）
新功能：
- 新增
repo-ls命令。（审核：Cynthia Shang. 测试：Stefan Fercot.） - 新增
repo-get命令。（由 Stefan Fercot、David Steele 贡献，Cynthia Shang 审核。） - 新增
archive-mode-check选项。（贡献：Stefan Fercot. 审核：David Steele. 测试：Michael Banck.）
改进：
- 提升
archive-get性能。（由 Cynthia Shang 审核。）
文档改进：
- 完善
expire命令的文档说明。（由 Cynthia Shang 贡献，David Steele 审核。）
v2.31 版本说明
小型漏洞修复与改进
发布于 2020 年 12 月 7 日
漏洞修复：
- 允许使用
[、#和空格作为数据库名称的首字符。（由 Stefan Fercot、Cynthia Shang 审核，Jefferson Alexandre 报告。） - 仅在 PostgreSQL 12 且
restore类型为standby时才创建standby.signal。（由 Stefan Fercot 修复，David Steele 审核，Keith Fiske 报告。）
新功能：
- 支持历史文件的过期清理。（由 Stefan Fercot 贡献，David Steele 审核。）
- 在
info命令的text输出中报告页面校验和错误。（由 Stefan Fercot 贡献，Cynthia Shang 审核。） - 新增
repo-azure-endpoint选项。（审核：Cynthia Shang. 测试：Brian Peterson. 建议：Brian Peterson.） - 新增
pg-database选项。（由 Cynthia Shang 审核。）
改进：
- 改进
info命令在指定 stanza 不存在时的输出提示。（由 Stefan Fercot 贡献，Cynthia Shang、David Steele 审核，uspen 建议。） - 提升
backup/restore命令处理大量文件列表时的性能。（审核：Cynthia Shang. 测试：Oscar.） - 启动备份时为 PostgreSQL 连接等待添加重试机制。（由 Cynthia Shang 审核，Vitaliy Kukharik 建议。）
文档改进：
- 将 RHEL/CentOS 6 的文档替换为 RHEL/CentOS 8。
v2.30 版本说明
PostgreSQL 13 支持
发布于 2020 年 10 月 5 日
漏洞修复：
- 当备份用户无法读取
pg_settings时，输出带有提示信息的错误报告。（由 Stefan Fercot、Cynthia Shang 审核，Mohamed Insaf K 报告。）
新功能：
- 支持 PostgreSQL 13。（由 Cynthia Shang 审核。）
改进：
- 改进 PostgreSQL 版本识别机制。（由 Cynthia Shang、Stephen Frost 审核。）
- 改进工作目录相关的错误提示信息。（由 Stefan Fercot 审核。）
- 当找不到 WAL 段时，添加启动 stanza 的提示信息。（由 David Christensen 贡献，David Steele 审核。）
- 新增协议版本不匹配时的提示信息。（由 Cynthia Shang 审核，loop-evgeny 建议。）
文档改进：
- 添加远程运行时 pgBackRest 版本必须一致的说明。（由 Cynthia Shang 审核，loop-evgeny 建议。）
- 将
info命令的文本内容移至参考手册，并在用户指南中添加对应链接。（由 Cynthia Shang 审核，Christophe Courtois 建议。） - 更新用户指南中 CentOS/RHEL 的 yum 仓库路径。（由 Heath Lord 贡献，David Steele 审核。）
v2.29 版本说明
AWS 自动获取 S3 凭据
发布于 2020 年 8 月 31 日
漏洞修复：
- 抑制关闭
local/remote进程时的错误输出。命令已执行完毕，此时抛出错误适得其反；但仍会以warn级别记录警告，以说明发生了异常情况。（由 Cynthia Shang 审核，argdenis 报告。） - 修复文件名或数据库名中包含
=字符时的处理问题。（由 Bastian Wegge、Cynthia Shang 审核，Brad Nicholson、Bastian Wegge 报告。）
新功能：
- 在 AWS 实例上自动获取临时 S3 凭据。（贡献：David Steele, Stephen Frost. 审核：Cynthia Shang, Aleš Zelený, Jeanette Bromage. 测试：David Youatt.）
- 新增
archive-mode选项，用于在restore时禁用归档。（由 Stephen Frost 审核，Stephen Frost 建议。）
改进：
- 支持 PostgreSQL 13 beta3。后续 beta 版本中控制/目录/WAL 版本如有变更可能导致兼容性问题，pgBackRest 将随每个版本发布同步更新。
- S3/Azure 存储的异步
list/remove操作。（由 Cynthia Shang、Stephen Frost 审核。） - 优化 manifest 构建过程中未记录关系检测的内存使用效率。（审核：Cynthia Shang, Stephen Frost, Oscar. 测试：Brad Nicholson. 建议：Oscar, Brad Nicholson.）
- 派生异步进程后主动关闭文件描述符。（由 Stephen Frost、Cynthia Shang 审核。）
- 将备份远程连接的关闭延迟至归档检查完成之后。（由 Floris van Nee 贡献，David Steele 审核。）
- 改进详细错误输出。（由 Cynthia Shang 审核。）
- 改进 TLS 错误报告。（由 Cynthia Shang、Stephen Frost 审核。）
文档漏洞修复：
- 在
compress-type选项参考中补充none并修正示例。（由 Ugo Bellavance、Don Seiler 报告。） - 在
repo-type选项参考中补充缺失的azure类型。（由 Don Seiler 修复，David Steele 审核。） - 修正
repo-cipher-type选项参考中的拼写错误。（由 Don Seiler 修复，David Steele 审核。）
文档改进：
- 明确说明当
expire-auto禁用时，必须定期手动运行expire。（由 Douglas J Hunley 审核，Douglas J Hunley 建议。）
v2.28 版本说明
Azure 仓库存储
发布于 2020 年 7 月 20 日
漏洞修复：
- 修复
restore --force行为等同于--force --delta的问题。该问题导致restore根据时间戳和文件大小判断是否替换文件，而非直接覆盖，造成部分应被更新的文件保持不变。普通restore和restore --delta不受此问题影响。（由 Cynthia Shang 审核。）
新功能：
- 支持 Azure 作为仓库存储后端。（审核：Cynthia Shang. 测试：Don Seiler.）
- 新增
expire-auto选项，用于禁止在成功备份后自动执行过期清理。（由 Stefan Fercot 贡献，Cynthia Shang、David Steele 审核。）
改进：
- 支持 S3 分段上传的异步处理。（由 Stephen Frost 审核。）
- 为
backup、restore、archive-get和archive-push添加自动重试机制。（由 Cynthia Shang 审核。） - 在用于备份控制的 PostgreSQL 会话中禁用查询并行化。（由 Stefan Fercot 审核。）
- 支持 PostgreSQL 13 beta2。后续 beta 版本中控制/目录/WAL 版本如有变更可能导致兼容性问题，pgBackRest 将随每个版本发布同步更新。
- 改进对无效 HTTP 响应状态码的处理。（由 Cynthia Shang 审核。）
- 改进
archive-get命令缺少pg1-path选项时的错误提示。（由 Cynthia Shang 审核。） - 在时间线切换后启用校验和 delta 时，添加相应提示信息。（由 Matt Bunter、Cynthia Shang 审核。）
- 在适当场合以 PostgreSQL 替代
postmaster。（由 Cynthia Shang 审核。）
文档漏洞修复：
- 修正
repo-retention-full-type选项的错误示例。（由 Höseyin Sönmez 报告。） - 从 HTML 和 man 页面的命令参考中移除内部命令。（由 Cynthia Shang 报告。）
文档改进：
- 更新用户指南使用的 PostgreSQL 版本，并添加版本范围说明，以表明用户指南适用于一定范围内的 PostgreSQL 版本，即使其针对特定版本构建。（由 Stephen Frost 审核。）
- 更新关于过期特定备份集的 FAQ。（由 Cynthia Shang 贡献，David Steele 审核。）
- 更新 FAQ 以明确默认 PITR 行为。（由 Cynthia Shang 贡献，David Steele 审核。）
v2.27 版本说明
过期改进与压缩驱动
发布于 2020 年 5 月 26 日
漏洞修复：
- 修复检测文件链接是否包含在路径链接中的逻辑问题。（由 Cynthia Shang 审核，Christophe Cavallié 报告。）
- 允许
pg-path1在同步archive-push中为可选项。（由 Cynthia Shang 审核，Jerome Peng 报告。） expire命令现在会检查停止文件是否存在。（由 Cynthia Shang 修复，David Steele 审核。）- 处理 HTTP 响应中缺少原因短语的情况。（由 Cynthia Shang 审核，Tenuun 报告。）
- 增大 lz4 压缩刷新的缓冲区大小。（由 Cynthia Shang 审核，Eric Radman 报告。）
- 在
remote命令中忽略pg-host*和repo-host*选项。（由 Cynthia Shang 审核，Pavel Suderevsky 报告。） - 修复
remote命令中可能缺少pg1-*选项的问题。（由 Cynthia Shang 审核，Andrew L’Ecuyer 报告。）
新功能：
- 全量备份的基于时间的保留策略。
--repo-retention-full-type选项支持按天数指定全量备份的保留周期。（由 Cynthia Shang、Pierre Ducroquet 贡献，David Steele 审核。） - 临时备份过期清理。允许用户无视保留策略设置，直接删除指定备份。（由 Cynthia Shang 贡献，David Steele 审核。）
- 支持 Zstandard 压缩。注意：设置
compress-type=zst将使新备份和归档与旧版本的 pgBackRest 不兼容（无法恢复）。（由 Cynthia Shang 审核。） - 支持 bzip2 压缩。注意：设置
compress-type=bz2将使新备份和归档与旧版本的 pgBackRest 不兼容（无法恢复）。（由 Stephen Frost 贡献，David Steele、Cynthia Shang 审核。） - 在
info命令中显示backup/expire的运行状态。（由 Stefan Fercot 贡献，David Steele 审核。）
改进：
- 仅当满足
repo-retention-archive阈值时才过期 WAL 归档。此前，首次全量备份之前的 WAL 会在第一次全量备份后被清理；现在将按保留策略进行保留。（由 Cynthia Shang 贡献，David Steele 审核。） - 添加本地 MD5 实现，使 S3 在启用 FIPS 时仍可正常工作。（由 Cynthia Shang、Stephen Frost 审核，Brian Almeida、John Kelly 建议。）
- 支持 PostgreSQL 13 beta1。后续 beta 版本中控制/目录/WAL 版本如有变更可能导致兼容性问题，pgBackRest 将随每个版本发布同步更新。（由 Cynthia Shang 审核。）
- 将
buffer-size默认值降低至1MiB。（由 Stephen Frost 审核。） - 若
expire未在仓库主机上运行，则输出用户友好的错误信息。（由 Cynthia Shang 贡献，David Steele 审核。）
v2.26 版本说明
非阻塞 TLS
发布于 2020 年 4 月 20 日
漏洞修复：
- 从 manifest 正则表达式中移除空子表达式。MacOS 对此不兼容，其他平台似乎可以正常运行。（由 David Raftis 修复，David Steele 审核。）
改进：
- 实现非阻塞 TLS。（审核：Cynthia Shang, Stephen Frost. 测试：Slava Moudry.）
- 仅对 WAL 记录的文件限制备份复制大小。此前的行为可能导致
postgresql.conf或postgresql.auto.conf在备份中被截断。（由 Cynthia Shang 审核。） - TCP keep-alive 选项现在支持配置。（由 Marc Cousin 建议。）
- 新增
io-timeout选项。（由 Cynthia Shang 审核。）
v2.25 版本说明
lz4 压缩支持
发布于 2020 年 3 月 26 日
新功能：
- 新增 lz4 压缩支持。注意：设置
compress-type=lz4将使新备份和归档与旧版本的 pgBackRest 不兼容（无法恢复）。（由 Cynthia Shang 审核。） - 为
expire命令新增--dry-run选项。使用 dry-run 可以预览expire命令将删除哪些备份/归档，而不会实际执行删除操作。（由 Cynthia Shang、Luca Ferrari 贡献，David Steele 审核，Marc Cousin 建议。）
改进：
- 提升远程 manifest 构建的性能。（由 Jens Wilke 建议。）
- 修复 Linux 上 keepalive 选项的检测问题。（由 Marc Cousin 贡献，David Steele 审核。）
- 添加 configure 主机检测，以正确设置标准编译标志。（由 Marc Cousin 贡献，David Steele 审核。）
- 从不使用压缩选项的命令中移除
compress/compress-level选项。这些命令（如restore、archive-get）从未使用过压缩选项，但此前允许在命令行中传入；现在若传入这些选项将报错。如果遇到此类错误，请移除无效选项。（由 Cynthia Shang 审核。） - 将备份文件复制大小限制为备份开始时报告的大小。若文件在备份过程中增大，恢复期间会通过 WAL 回放重建，无需复制额外数据。（由 Cynthia Shang 审核。）
v2.24 版本说明
时间目标的备份集自动选择
发布于 2020 年 2 月 25 日
漏洞修复：
- 修复异步归档命令产生僵尸进程的问题。（由 Stephen Frost 审核，Adam Brusselback、ejberdecia 报告。）
- 当
archive-get/archive-push/restore未在 PostgreSQL 主机上运行时报错。（由 Stephen Frost 审核，Jesper St John 报告。） - 当未指定大小/编码时，读取 HTTP 内容直至 EOF。（由 Cynthia Shang 审核，Christian ROUX 报告。）
- 修复由 Perl 创建的可续传备份在恢复时的处理问题。此情况下应忽略该可续传备份，但 C 代码无法加载 Perl 写入的部分 manifest（格式略有差异）。已添加相关校验以正常处理此情况。（由 Kacey Holston 报告。）
新功能：
- 指定时间目标时自动选择备份集进行恢复。仅在未指定
--set时执行自动选择；若找不到适合目标时间的备份集，则使用最新（默认）备份集。（由 Cynthia Shang 贡献，David Steele 审核。）
改进：
- 备份期间跳过
pg_internal.init临时文件。（由 Cynthia Shang 审核，Michael Paquier 建议。） backup时对 manifest 添加更多校验。（由 Cynthia Shang 审核。）
文档改进：
- 阻止 lock-bot 向已锁定的 issue 添加评论。（由 Christoph Berg 建议。）
v2.23 版本说明
漏洞修复
发布于 2020 年 1 月 27 日
漏洞修复：
- 修复文件缺失导致 manifest 损坏的问题。若 PostgreSQL 在备份过程中删除了某个文件（或该文件在备库上缺失），则下一个文件可能不会被复制并更新到 manifest 中；发生此情况时，恢复该备份将报错。（由 Cynthia Shang 审核，Vitaliy Kukharik 报告。）
改进：
- 使用
pkg-config替代xml2-config获取 libxml2 构建选项。（由 David Steele、Adrian Vondendriesch 贡献。） - 在
backup/restore时校验 manifest 中的校验和是否已设置。（由 Cynthia Shang 审核。）
v2.22 版本说明
漏洞修复
发布于 2020 年 1 月 21 日
漏洞修复：
- 修复时间线转换中的错误。时间线用于备份后验证归档中的 WAL 段。转换使用了十进制（base
10）而非十六进制（base16），导致时间线 ≥0xA时出现错误。（由 Lukas Ertl、Eric Veldhuyzen 报告。）
v2.21 版本说明
C 语言迁移完成
发布于 2020 年 1 月 15 日
漏洞修复：
- 修复异步命令忽略选项的问题。异步
archive-get/archive-push进程未加载命令配置节（如[global:archive-get]）中配置的选项。（由 Cynthia Shang 审核，Urs Kramer 报告。） - 修复文件名中包含
\的处理问题。计算 manifest 校验和时\未被正确转义，导致 manifest 无法加载。由于集群文件名中出现\的情况极为罕见，此问题在实际使用中影响应该不大。
新功能：
- pgBackRest 现已完全用 C 语言实现。
- 新增
pg-user选项，用于指定连接 PostgreSQL 时使用的数据库用户名。若未指定，pgBackRest 将使用本地操作系统用户或PGUSER，与先前行为一致。（由 Mike Palmiotto 贡献，David Steele 审核。） - 允许在 S3 驱动中使用路径风格的 URI。
改进：
backup命令已完全用 C 实现。（由 Cynthia Shang 审核。）
v2.20 版本说明
漏洞修复
发布于 2019 年 12 月 12 日
漏洞修复：
- 修复
PGDATA为符号链接时archive-push/archive-get失败的问题。这些命令尝试使用cwd()作为PGDATA，但若PGDATA是符号链接，其结果与 pgBackRest 配置的路径可能不一致。修复方案：若cwd()与 pgBackRest 路径不匹配，则chdir()到该路径，并确保后续cwd()的结果与首次调用一致。（由 Stephen Frost、Milosz Suchy 报告。） - 修复
expire命令重建backup.info时的引用列表问题。由于backup命令仍使用 Perl 版本的重建逻辑，此问题仅在以下两个条件同时满足时才会触发：1）backup.info中存在缺失的备份；2） 直接运行expire命令而非在backup后自动运行。两个条件同时成立的概率极低，在实际使用中应该不是问题。 - 修复 gzip 解压时意外遇到 EOF 导致的段错误。（由 Stephen Frost 报告。）
v2.19 版本说明
C 语言迁移与漏洞修复
发布于 2019 年 11 月 12 日
漏洞修复：
- 修复 delta restore 中的远程超时问题。对基本未变化的集群执行 delta restore 时，若在
protocol-timeout时间内未从仓库获取任何文件，远程端可能超时。已添加 keep-alive 机制以防止远程超时。（由 James Sewell、Jens Wilke 报告。） - 修复重复 HTTP 响应头的处理问题。HTTP 响应头重复出现时，应视为等同于单个逗号分隔的响应头，而非报错（此前的行为）。（由 donicrosby 报告。）
改进：
info命令的 JSON 输出不再格式化（pretty-print）。不含换行符的 JSON 更便于监控系统解析；如需格式化输出，可使用jq等外部工具。（由 Cynthia Shang 贡献，David Steele 审核。）check命令已完全用 C 实现。（由 Cynthia Shang 贡献，David Steele 审核。）
文档改进：
- 说明如何为 pgBackRest 做出贡献。（由 Cynthia Shang、David Steele 贡献。）
- 说明
auto-stop选项的最大支持版本。（由 Brad Nicholson 贡献，David Steele 审核。）
测试套件改进：
- 修复使用
--vm=none时容器测试路径的问题。（由 Stephen Frost 建议。） - 修复期望测试中时区不匹配的问题。（由 Stephen Frost 建议。）
- 默认不自动生成嵌入式 libc 代码。（由 Stephen Frost 建议。）
v2.18 版本说明
PostgreSQL 12 支持
发布于 2019 年 10 月 1 日
新功能：
- 支持 PostgreSQL 12。
- 为
info命令新增set选项以显示详细文本输出。额外信息包括：可用于选择性恢复的数据库列表，以及表空间、符号链接及其默认目标的列表。（由 Cynthia Shang 贡献，David Steele 审核，Stephen Frost、ejberdecia 建议。） - 新增
standby恢复类型。在 PostgreSQL < 12 时自动向recovery.conf添加standby_mode=on，在 PostgreSQL ≥ 12 时创建standby.signal，为不同 PostgreSQL 版本提供统一接口。（由 Cynthia Shang 审核。）
改进：
restore命令已完全用 C 实现。（由 Cynthia Shang 审核。）
文档改进：
- 说明
db-timeout与protocol-timeout之间的关系。（由 Cynthia Shang 贡献，David Steele 审核，James Chanco Jr 建议。） - 添加关于备库仓库的文档说明。（由 Cynthia Shang 贡献，David Steele 审核。）
- 添加基于时间的 PITR FAQ。（由 Cynthia Shang 贡献，David Steele 审核。）
v2.17 版本说明
C 语言迁移与漏洞修复
发布于 2019 年 9 月 3 日
漏洞修复：
- 改进超大量表/段文件时 manifest 构建速度过慢的问题。（由 Jens Wilke 报告。）
- 修复特殊文件的排除处理问题。（由 CluelessTechnologist、Janis Puris、Rachid Broum 报告。）
改进：
stanza-create/stanza-update/stanza-delete命令已完全用 C 实现。（由 Cynthia Shang 贡献，David Steele 审核。）start/stop命令已完全用 C 实现。（由 Cynthia Shang 贡献，David Steele 审核。）- 以
0750/0640模式创建日志目录/文件。（由 Damiano Albani 建议。）
文档漏洞修复：
- 修复指定自定义包时仍安装
yum.p.o包的问题。（由 Joe Ayers、John Harvey 报告。）
文档改进：
- 说明以非特权用户构建 pgBackRest 的方式。（由 Laurenz Albe 建议。）
v2.16 版本说明
C 语言迁移与漏洞修复
发布于 2019 年 8 月 5 日
漏洞修复：
- 对 S3
RequestTimeTooSkewed错误执行重试而非立即终止。（由 sean0101n、Tim Garton、Jesper St John、Aleš Zelený 报告。） - 修复对
HEAD请求响应中transfer-encoding的错误处理。（由 Pavel Suderevsky 报告。） - 修复 gcc 9 优化暴露的作用域违规问题。（由 Christian Lange、Ned T. Crigler 报告。）
新功能：
- 新增
repo-s3-port选项，用于设置非标准 S3 服务端口。
改进：
backup的local命令已完全用 C 实现。（由 David Steele、Cynthia Shang 贡献。）check命令已部分用 C 实现。（由 Cynthia Shang 审核。）
v2.15 版本说明
expire 命令的 C 语言实现
发布于 2019 年 6 月 25 日
漏洞修复：
- 修复归档保留过期清理过于激进的问题。（由 Cynthia Shang 修复，David Steele 审核，Mohamad El-Rifai 报告。）
改进：
expire命令已完全用 C 实现。（由 Cynthia Shang 贡献，David Steele 审核。）restore的local命令已完全用 C 实现。- 移除硬编码的 PostgreSQL 用户，使
$PGUSER生效。（由 Julian Zhang、Janis Puris 建议。） - 支持
configure的--prefix选项。（由 Daniel Westermann 建议。） - 将
repo-s3-verify-ssl选项重命名为repo-s3-verify-tls。新名称更为准确，因为 pgBackRest 不支持任何 SSL 协议版本（均视为不安全）。旧选项名称仍可继续使用。
文档改进：
- 在文档中添加 FAQ。（由 Cynthia Shang 贡献，David Steele 审核。）
- 在 PostgreSQL ≥ 9.6 的文档中使用
wal_level=replica。（由 Patrick McLaughlin 建议。）
v2.14 版本说明
漏洞修复与改进
发布于 2019 年 5 月 20 日
漏洞修复：
- 修复当
process-max> 8 时archive-push/archive-get发生段错误的问题。（由 Jens Wilke 报告。）
改进：
- 使用
force执行stanza-delete时绕过数据库检查。（由 Cynthia Shang 贡献，David Steele 审核，hatifnatt 建议。） - 添加
configure脚本以改善多平台支持。
文档新功能：
- 添加 CentOS/RHEL 6/7 的用户指南。
v2.13 版本说明
漏洞修复
发布于 2019 年 4 月 18 日
漏洞修复：
- 修复零长度读取导致不期望接收零长度数据的 IO 过滤器出现异常的问题。（由 brunre01、Jens Wilke、Tomasz Kontusz、guruguruguru 报告。）
- 修复
local/remote进程错误报告的可靠性问题。 - 修复 Posix/CIFS 在写入/同步/关闭时报告错误文件名的问题。
v2.12 版本说明
archive-push 命令的 C 语言实现
发布于 2019 年 4 月 11 日
重要提示：新的 TLS/SSL 实现根据 RFC-2818 禁止 S3 存储桶名称中包含点号（.）。这是合规主机名验证所必需的安全修复。
漏洞修复：
- 修复路径选项以
/结尾时的处理问题。（由 Marc Cousin 报告。） - 修复
archive-get命令中设置log-level-file=off时的问题。（由 Brad Nicholson 报告。） - 修复 C 代码无法识别
host:port选项格式（Perl 可以识别）的问题。（由 Kyle Nevins 报告。） - 修复
remote/local命令日志选项的问题。
改进：
archive-push命令已完全用 C 实现。- 将
process-max上限提升至999。（由 Rakshitha-BR 建议。） - 改进 S3 存储桶名称包含点号时的错误提示信息。
文档改进：
- 明确说明支持兼容 S3 协议的对象存储。（由 Magnus Hagander 建议。）
v2.11 版本说明
archive-get 命令的 C 语言实现
发布于 2019 年 3 月 11 日
漏洞修复：
- 修复写入过程中出错可能导致 WAL 段被截断的问题。（由 blogh 报告。）
- 修复
info命令在指定 stanza 时缺少 WAL 最小/最大值的问题。（由 Stefan Fercot 修复，David Steele 审核。） - 修复从 C 传递给 Perl 的选项中不符合规范的 JSON 格式。（由 Leo Khomenko 报告。）
改进：
archive-get命令已完全用 C 实现。- 在较旧的 Perl 版本上启用 socket keep-alive。（由 Marc Cousin 贡献，David Steele 审核。）
- 当参数传递给不接受参数的命令时报错。（由 Jason O’Donnell 建议。）
- 在归档中找不到 WAL 段时添加提示信息。（由 Hans-Jürgen Schönig 建议。）
- 改进证书中找不到主机名时的错误提示。（由 James Badger 建议。）
- 为
backup.manifest添加额外的调试选项。（由 blogh 贡献，David Steele 审核。）
文档改进：
- 将默认文档版本更新为 PostgreSQL 10。
v2.10 版本说明
漏洞修复
发布于 2019 年 2 月 9 日
漏洞修复：
- 补充
archive-get所需但尚未实现的 S3 驱动方法。（由 mibiio 报告。） - 修复对
pg-path配置错误的检查逻辑。（由 James Chanco Jr 报告。）
v2.09 版本说明
小型改进与缺陷修复
发布于 2019 年 1 月 30 日
漏洞修复：
- 修复多个异步状态文件引发硬错误的问题。（由 Vidhya Gurumoorthi、Joe Ayers、Douglas J Hunley 报告。）
改进：
info命令已完全用 C 重新实现。（由 Cynthia Shang 贡献，David Steele 审核。）- 简化
info命令在无 stanza 时的文本提示，将仓库路径替换为"the repository"。 - 为 macOS 构建在 Makefile 中添加
_DARWIN_C_SOURCE标志。（由 Douglas J Hunley 贡献，David Steele 审核。） - 将 C TLS 客户端的地址查找更新为使用现代接口。（由 Bruno Friedmann 建议。）
- 包含符合 POSIX 规范的
strcasecmp()和fd_set头文件。（由 ucando 建议。）
文档漏洞修复：
- 修复硬编码的仓库路径。（由 Heath Lord 报告。）
文档改进：
- 明确说明加密始终在客户端执行。（由 Bruce Burdick 建议。）
- 添加构建文档主机的示例。
- 在 manifest 变量、列表及列表项中允许使用
if。
v2.08 版本说明
小型改进与缺陷修复
发布于 2019 年 1 月 2 日
漏洞修复：
- 移除在 PUT S3 对象后立即请求其元数据的操作。（由 Matt Kunkel 报告。）
- 将
archive-get-queue-max类型修正为size。（由 Ronan Dunklau 报告。） - 添加当前用户的
uid/gid无法映射到用户名时的错误提示。（由 Camilo Aguilar 报告。） - 在 PostgreSQL < 9.5 时指定
--target-action=shutdown时报错。
改进：
- 在 S3 连接上启用 TCP keepalive。（由 Ronan Dunklau 建议。）
- 调整
info命令文本输出顺序，使最新备份排在最后。（由 Cynthia Shang 贡献，David Steele 审核，Ryan Lambert 建议。） - 仅在必要时变更文件所有权。
- 在抛出 S3 错误时对
authentication头进行脱敏处理。（由 Brad Nicholson 建议。）
文档改进：
- 明确说明
target-action的生效条件及 PostgreSQL 版本支持情况。（由 Keith Fiske 建议。） - 明确说明 region/endpoint 必须与存储桶正确匹配。（由 Pritam Barhate 建议。）
- 添加构建文档的说明。
v2.07 版本说明
备份校验和 Delta 自动启用
发布于 2018 年 11 月 16 日
漏洞修复：
- 修复
archive-push-queue-max在连接错误时未被遵守的问题。（由 Lardière Sébastien 报告。） - 修复用于判断是否超过
archive-push-queue-max阈值时使用静态 WAL 段大小的问题。 - 修复日志文件打开失败后处理应继续却仍报错的问题。（由 vthriller 报告。）
新功能：
- 检测到异常情况（如时间线切换）时自动启用备份校验和 delta。（由 Cynthia Shang 贡献，David Steele 审核。）
改进：
- 对所有 S3
5xx错误执行重试，而非仅对500内部错误重试。（由 Craig A. James 建议。）
v2.06 版本说明
校验和 Delta 备份与 PostgreSQL 11 支持
发布于 2018 年 10 月 15 日
漏洞修复：
- 修复 S3 驱动中缺失 URI 编码的问题。（由 Dan Farrell 报告。）
- 修复配置文件中出现重复选项时错误提示不正确的问题。（由 Jesper St John 报告。）
- 修复
info日志中错误报告的返回码问题。archive-get返回码 1 被以info级别记录为错误消息，但实际运行正常。
新功能：
- 为增量备份添加校验和 delta 支持。校验和 delta 备份使用文件校验和而非时间戳来判断文件是否发生变更。（由 Cynthia Shang 贡献，David Steele 审核。）
- 支持 PostgreSQL 11，包括可配置的 WAL 段大小。
改进：
- 忽略链接表空间目录中当前 PostgreSQL 版本子目录以外的所有文件。此前若表空间目录中存在非 PostgreSQL 用户所有的其他文件，会产生报错。
- 改进
info命令，使其显示 stanza 的加密类型。（由 Cynthia Shang 贡献，David Steele 审核，Douglas J Hunley 建议。） - 改进对文件名中特殊字符的支持。
- 允许在 pgBackRest 配置文件中指定
delta选项。（由 Cynthia Shang 贡献，David Steele 审核。）
文档改进：
- 在
authorized_hosts中使用command以提升 SSH 安全性。（由 Stephen Frost、Magnus Hagander 建议。） - 在配置参考中列出
buffer-size选项的允许值。（由 Cynthia Shang 贡献，David Steele 审核，Stéphane Schildknecht 建议。）
v2.05 版本说明
环境变量选项与临时/未记录关系的排除
发布于 2018 年 8 月 31 日
漏洞修复：
- 修复
$PGDATA中 相对 链接可能以错误路径存入备份的问题。此问题不影响绝对链接，相对表空间链接已由其他检查捕获。（由 Cynthia Shang 报告。） - 从
check命令中移除未完全实现的online选项。离线操作与该命令的目的（检查归档和备份是否正常工作）相悖。（由 Jason O’Donnell 报告。） - 修复 C 中抛出的错误在由 Perl 调用时未被记录的问题。pgBackRest 以正确的错误码退出，但缺少有助于调试的错误消息。（由 Douglas J Hunley 报告。）
- 修复布尔型选项（如
delta）被多次指定时的错误。（由 Yogesh Sharma 报告。）
新功能：
- 允许通过环境变量设置任意选项，包括之前只能在命令行指定的选项（如
stanza），以及不能在命令行指定的加密选项（如repo1-s3-key-secret）。 - 从备份中排除临时和未记录的关系（表/索引）文件。实现逻辑与 PostgreSQL 中引入此功能的补丁一致，参见 8694cc96 和 920a5e50。临时关系排除在 PostgreSQL ≥
9.0时启用，未记录关系排除在 PostgreSQL ≥9.1（该功能引入版本）时启用。（由 Cynthia Shang 贡献，David Steele 审核。） - 允许从备份中排除任意目录和/或文件。滥用此功能可能导致备份不一致，使用前请仔细阅读
--exclude文档。（由 Cynthia Shang 审核。） - 添加
log-subprocess选项，允许为local和remote子进程启用文件日志。 - 支持 PostgreSQL 11 Beta 3。
改进：
- 允许备份 manifest 中零大小文件引用之前的 manifest，不受时间戳 delta 的限制。（由 Cynthia Shang 贡献，David Steele 审核。）
- 通过直接检查状态文件改善异步
archive-get/archive-push性能。（由 Stephen Frost 贡献，David Steele 审核。） - 改进命令缺少
stanza选项时的错误提示。（由 Sarah Conway 建议。）
文档漏洞修复：
- 修复
log-path选项参考中无效的日志级别。（由 Camilo Aguilar 报告。）
文档改进：
- 停止尝试在
release.xml中按姓/名排列贡献者。贡献者名称始终按原样呈现在发布说明中，但我们曾尝试基于姓/名分配内部 ID，这既难以判断又毫无意义。受 Christophe 在 PostgresOpen 2017 演讲"Human Beings Do Not Have a Primary Key"的启发。（由 Christophe Pettus 建议。）
测试套件改进：
- 若在测试环境之外执行 LibC 构建则报错。LibC 不再是生产构建所必需的。
v2.04 版本说明
备份恢复关键缺陷修复
发布于 2018 年 7 月 5 日
重要提示：本版本修复了备份 resume 功能中的一个关键缺陷。此版本之前所有已 resume 的备份均应视为不一致。当先前的备份失败时，若未指定 resume=n，则会触发备份 resume。可通过检查备份日志中是否存在"aborted backup of same type exists, will be cleaned to remove invalid files and resumed"消息来判断备份是否已被 resume。若存在该消息，请勿使用该备份或同一备份集中的任何备份进行恢复，并检查恢复日志确认是否用到了 resume 备份。若已使用，集群中可能存在不一致数据。
漏洞修复：
- 修复 resume 中导致备份不一致的关键缺陷。
v0.82中的一次回归移除了在决定恢复哪些已中止备份文件时的时间戳比较逻辑，详情参见上方说明。（由 David Youatt、Yogesh Sharma、Stephen Frost 报告。） - 修复集群中只存在一个用户数据库时选择性恢复报错的问题。（由 Cynthia Shang 修复，David Steele 审核，Nj Baliyan 报告。）
- 修复 S3 授权头中不符合 ISO-8601 规范的时间戳格式。AWS 和部分网关对空格与零填充小时均可容忍，但其他实现则不然。（由 Andrew Schwartz 修复，David Steele 审核。）
新功能：
- 支持 PostgreSQL 11 Beta 2。
改进：
- 改进 HTTP 客户端，在服务端未指定时将
content-length设为 0。S3（及其网关）始终设置content-length或transfer-encoding，但HTTP 1.1并不强制要求，部分代理（如 HAProxy）可能不包含任一字段。（由 Adam K. Sumner 建议。） - 在 PostgreSQL 连接上设置
search_path = 'pg_catalog'。（由 Stephen Frost 建议。）
文档改进：
- 新增章节，说明如何在独立主机上构建 pgBackRest。
- 添加 S3 策略示例以限制存储桶权限。（由 Douglas J Hunley、Jason O’Donnell 建议。）
v2.03 版本说明
单一可执行文件部署
发布于 2018 年 5 月 22 日
漏洞修复：
- 修复错误消息处理中潜在的缓冲区溢出问题。（由 Lætitia 报告。）
- 修复同步
archive-get命令错误获取归档写锁的问题。（由 uspen 报告。）
改进：
- 将导出的 C 函数和 Perl 模块直接嵌入 pgBackRest 可执行文件中。
- 使用
time_t替代__time_t以提升可移植性。（由 Nick Floersch 建议。） - 在命令结束时以毫秒为单位打印总运行时长。
v2.02 版本说明
并行异步 archive-get 与配置文件包含
发布于 2018 年 5 月 6 日
漏洞修复：
- 修复目录同步在仅应同步指定目录时递归执行的问题。（由 Craig A. James 报告。）
- 修复增量/差异备份中
archive-copy抛出"path not found"错误的问题。（由 yummyliu、Vitaliy Kukharik 报告。） - 修复
PGDATA中两个或多个文件链接到同一目录时 manifest 构建失败的问题。（由 Vitaliy Kukharik 报告。） - 修复链接文件缺失时 delta restore 失败的问题。
- 修复帮助信息中键值和列表选项的渲染问题。（由 Clinton Adams 报告。）
新功能：
- 添加异步并行
archive-get。该特性维护一个 WAL 段预取队列，在 PostgreSQL 通过restore_command请求 WAL 段时降低等待延迟。 - 支持附加的 pgBackRest 配置文件。配置文件目录由
--config-include-path选项指定；新增--config-path选项用于覆盖--config和--config-include-path的默认基础路径。（由 Cynthia Shang 贡献，David Steele 审核。） - 添加
repo-s3-token选项，支持配置临时凭据令牌。pgBackRest 目前不具备主动刷新凭据的能力，因此整个命令（如backup、restore）必须在凭据过期前完成。（由 Yogesh Sharma 贡献，David Steele 审核。）
改进：
- 更新
archive-push-queue-max、manifest-save-threshold和buffer-size选项，支持接受KB、MB、GB、TB或PB为单位的值（乘数以 1024 的幂计算）。（由 Cynthia Shang 贡献，David Steele 审核。） - 提升备份/恢复路径同步效率。扫描整个目录在小表数量众多时代价高昂；备份 manifest 中已包含路径列表，现改为使用该列表执行同步，而非扫描备份/恢复路径。
- 在初始 info 日志消息中同时显示命令参数和选项。
- 将
archive-queue-max选项重命名为archive-push-queue-max，与新增的archive-get-queue-max选项保持命名一致。旧选项名称仍可继续使用。
文档漏洞修复：
- 更新文档，添加 32 位支持说明及注意事项。32 位支持已于 v1.26 添加。（由 Viorel Tabara 报告。）
文档改进：
- 添加使用 PostgreSQL 和 jq 的监控示例。（由 Stephen Frost、Brian Faherty 建议。）
- 添加归档配置中命令节使用示例。（由 Christophe Courtois 建议。）
- 移除将
info --output=json描述为实验性功能的说明。 - 更新
spool-path选项的过时描述。
测试套件新功能：
- 使用 lcov 进行 C 单元测试覆盖率报告，从 Devel::Cover 切换，原因是后者无法报告从 gcov 转换的报告中的分支覆盖率。模块的不完整分支覆盖率现在会产生错误。单元测试覆盖率仅在语句或分支覆盖不完整时才会出现在报告中。
v2.01 版本说明
小型缺陷修复与改进
发布于 2018 年 3 月 19 日
漏洞修复：
- 修复使用
--type=immediate恢复时--target-action和--recovery-option选项被报告为无效的问题。（由 Brad Nicholson 报告。） - 在命令行传入加密选项（如
repo1-s3-key）时立即报错。由于 pgBackRest 不会将加密选项传递给子进程，之前会抛出晦涩的错误；新错误更加清晰并提示了解决方法。同时更新命令文档，省略不能在命令行指定的加密选项。（由 Brad Nicholson 报告。） - 修复向嵌入式 Perl 传递
--no-config时的问题。（由 Ibrahim Edib Kokdemir 报告。） - 修复将
log-level-stderr设置高于warn时local/remote进程因 stderr 出现意外输出而报错退出的问题。local/remote进程的日志级别上限现调整为error，因为这些进程本不应输出警告。（由 Clinton Adams 报告。） - 修复存在表空间时
check命令中 manifest 测试的问题。（由 Cynthia Shang 修复，David Steele 审核，Thomas Flatley 报告。）
改进：
- 在配置文件中为不接受多个参数的选项设置多个值时报错。（由 Cynthia Shang 贡献，David Steele 审核。）
- 从
src/Makefile中移除多余的 sudo 命令。（由 Adrian Vondendriesch 贡献，David Steele 审核。）
文档改进：
- 在示例中为带索引的选项（如
repo-*、pg-*）显示索引。（由 Stephen Frost 建议。） - 简化命令页面目录，仅列出命令。（由 Stephen Frost 建议。）
- 移除关于 C 库为可选项的说明。
测试套件新功能：
- 添加 CentOS/RHEL 软件包构建。
- 使用 clang 进行静态代码分析。初始分析未发现问题，仅发现部分函数应标记为
__noreturn__。
v2.00 版本说明
archive-push 性能改进
发布于 2018 年 2 月 23 日
新功能：
archive-push命令现已部分用 C 实现，使 PostgreSQL 的archive_command在处理来自异步归档进程的状态消息时运行速度显著提升。（由 Cynthia Shang 审核。）
改进：
- 改进
check命令，增加对备份 manifest 是否可构建的验证。（由 Cynthia Shang 贡献，David Steele 审核。） - 提升 HTTPS 客户端性能。缓冲现在会在 socket 上有
pending字节时将其计入，而非完全依赖select()。在某些情况下，最后几个字节直到连接关闭才会被刷出。 - 提升 S3 删除性能。常量
S3_BATCH_MAX曾被替换为硬编码值 2（可能是测试时遗留）。 - 允许在命令行将任意非命令行选项重置为默认值，从而无需为特定需求另写配置文件即可覆盖
pgbackrest.conf中的设置。 - C 库现为必需项，取消了条件加载，简化了新库特性的开发。
pgbackrest可执行文件现在是 C 二进制文件而非 Perl，使对时间敏感的命令（如异步archive-push）运行更快。- 将
db-*选项重命名为pg-*，将backup-*选项重命名为repo-*，以提高一致性。repo-*选项现已带索引，但目前仅允许使用一个。
文档新功能：
- 文档中所有集群均使用校验和初始化。
文档改进：
- 在文档和命令行帮助中列出已弃用的选项名称。
- 明确说明 S3 存储桶必须由用户自行创建。（由 David Youatt 建议。）
v1.29 版本说明
备份恢复关键缺陷修复
发布于 2018 年 7 月 5 日
重要提示：本版本修复了备份 resume 功能中的一个关键缺陷。此版本之前所有已 resume 的备份均应视为不一致。当先前的备份失败时，若未指定 resume=n，则会触发备份 resume。可通过检查备份日志中是否存在"aborted backup of same type exists, will be cleaned to remove invalid files and resumed"消息来判断备份是否已被 resume。若存在该消息，请勿使用该备份或同一备份集中的任何备份进行恢复，并检查恢复日志确认是否用到了 resume 备份。若已使用，集群中可能存在不一致数据。
漏洞修复：
- 修复 resume 中导致备份不一致的关键缺陷。
v0.82中的一次回归移除了在决定恢复哪些已中止备份文件时的时间戳比较逻辑，详情参见上方说明。（由 David Youatt、Yogesh Sharma、Stephen Frost 报告。） - 修复 S3 授权头中不符合 ISO-8601 规范的时间戳格式。AWS 和部分网关对空格与零填充小时均可容忍，但其他实现则不然。（由 Andrew Schwartz 修复，David Steele 审核。）
- 修复目录同步在仅应同步指定目录时递归执行的问题。（由 Craig A. James 报告。）
- 修复使用
--type=immediate恢复时--target-action和--recovery-option选项被报告为无效的问题。（由 Brad Nicholson 报告。） - 修复增量/差异备份中
archive-copy抛出"path not found"错误的问题。（由 yummyliu、Vitaliy Kukharik 报告。） - 修复
PGDATA中两个或多个文件链接到同一目录时 manifest 构建失败的问题。（由 Vitaliy Kukharik 报告。） - 修复链接文件缺失时 delta restore 失败的问题。
- 修复集群中只存在一个用户数据库时选择性恢复报错的问题。（由 Cynthia Shang 修复，David Steele 审核，Nj Baliyan 报告。）
改进：
- 改进 HTTP 客户端，在服务端未指定时将
content-length设为 0。S3（及其网关）始终设置content-length或transfer-encoding，但HTTP 1.1并不强制要求，部分代理（如 HAProxy）可能不包含任一字段。（由 Adam K. Sumner 建议。） - 提升 HTTPS 客户端性能。缓冲现在会在 socket 上有
pending字节时将其计入，而非完全依赖select()。在某些情况下，最后几个字节直到连接关闭才会被刷出。 - 提升 S3 删除性能。常量
S3_BATCH_MAX曾被替换为硬编码值 2（可能是测试时遗留）。 - 提升备份/恢复路径同步效率。扫描整个目录在小表数量众多时代价高昂；备份 manifest 中已包含路径列表，现改为使用该列表执行同步，并移除不再使用的递归路径同步功能。
文档漏洞修复：
- 更新文档，添加 32 位支持说明及注意事项。32 位支持已于 v1.26 添加。（由 Viorel Tabara 报告。）
文档改进：
- 明确说明 S3 存储桶必须由用户自行创建。（由 David Youatt 建议。）
- 更新
spool-path选项的过时描述。
v1.28 版本说明
Stanza 删除
发布于 2018 年 2 月 1 日
漏洞修复：
- 修复使用
--db-include恢复表空间中单个数据库时失败的问题。（由 Cynthia Shang 修复，David Steele 审核，Chiranjeevi Ravilla 报告。） - 确保在将
archive.info匹配到backup.info时选择最新的db-id。在存在system-id和db-version重复项时（例如回滚pg_upgrade后），此改动可提供正确匹配。（由 Cynthia Shang 修复，David Steele 审核，Adam K. Sumner 报告。） - 修复报告无效命令时过于冗长的错误消息。（由 Jason O’Donnell 报告。）
新功能：
- 添加
stanza-delete命令，用于清理不再使用的 stanza。（由 Cynthia Shang 贡献，David Steele 审核，Magnus Hagander 建议。）
改进：
- 改进
stanza-create命令，使其在 stanza 已存在时不再报错。（由 Cynthia Shang 贡献，David Steele 审核。）
文档改进：
- 更新
stanza-create --force文档，提示使用时需谨慎。（由 Jason O’Donnell 建议。）
v1.27 版本说明
缺陷修复与文档
发布于 2017 年 12 月 19 日
漏洞修复：
- 修复
backup和restore的本地性检查错误被抑制的问题。存在备份主机时，备份应仅允许在备份主机上执行，恢复应仅允许在数据库主机上执行，除非创建了忽略远程主机的备用配置。（由 Lardière Sébastien 报告。） - 修复 PostgreSQL 10 上 WAL 未过期的问题。原因是正则表达式存在缺陷，期望所有 PostgreSQL 主版本号均为 X.X 格式。（由 Adam Brusselback 报告。）
- 修复
--no-config选项未传递给子进程的问题。这会导致子进程仍读取本地配置文件，可能引发意外行为。 - 修复
info命令在先前版本集群没有备份或归档时仍显示"db (prior)"输出的问题。（由 Cynthia Shang 修复，David Steele 审核，Stephen Frost 报告。）
文档新功能：
- 说明
archive-copy和archive-check选项之间的关系。（由 Markus Nullmeier 建议。） - 改进
archive-copy参考文档。
v1.26 版本说明
仓库加密
发布于 2017 年 11 月 21 日
漏洞修复：
- 修复恢复时复制大型 manifest 可能失败的问题。（由 Craig A. James 报告。）
- 修复 32 位架构下不正确的 WAL 偏移量。（由 Javier Wilson 修复，David Steele 审核。）
- 修复获取旧数据库版本 WAL 时的问题。执行
stanza-upgrade后，应仍能恢复之前版本的备份并通过archive-get进行恢复。但archive-get仅检查最新的 db 版本/id 而失败。同时清理了同一 db 版本/id 多次出现时的相关问题。（由 Cynthia Shang 修复，David Steele 审核，Clinton Adams 报告。） - 修复恢复时无效备份组未被正确设置的问题。若备份无法将某个组映射到名称，则将该组以
false存入 manifest，恢复时使用$PGDATA所有者或当前用户的组来设置。该逻辑存在缺陷，导致所选的组覆盖了用户，组未定义而用户被错误设置为组。（由 Jeff McCormick 报告。） - 修复向远程传递参数时的问题。指定多个 db 时，无论实际处理的是哪个 db，都会传递 db1 的路径、端口和 socket 路径。（由 uspen 报告。）
新功能：
- 支持仓库加密。（由 Cynthia Shang、David Steele 贡献。）
改进：
- 当
--compress-level-network=0时禁用 gzip 过滤器。该过滤器曾以压缩级别 0 运行，带来额外开销却毫无收益。 - 改进 gzip 过滤器的解压性能。
文档新功能：
- 添加用于改善 issue 提交时初始信息收集的模板。（由 Cynthia Shang 贡献，David Steele 审核。）
文档改进：
- 明确说明
archive-timeout选项的用法及其与 PostgreSQLarchive_timeout设置的区别。（由 Cynthia Shang 贡献，David Steele 审核，Keith Fiske 建议。）
测试套件新功能：
- 支持 32 位 i386/i686 架构的自动化测试。
v1.25 版本说明
S3 性能改进
发布于 2017 年 10 月 24 日
漏洞修复：
- 修复
compress-level选项自定义设置被忽略的问题。（由 Jens Wilke 报告。） - 移除检测到重叠时间线时的报错。重叠时间线在许多时间点恢复（PITR）场景中是有效的。（由 blogh 报告。）
- 修复 JSON info 输出中
database-id未渲染为整数的问题。（由 Cynthia Shang 修复，David Steele 审核，Jason O’Donnell 报告。）
新功能：
- 提升 S3 列表请求的性能。过滤表达式中任何起始字面量部分均用于生成搜索前缀，通常可将请求范围控制在足够小，从而避免触发限流。（由 Mihail Shvein 建议。）
测试套件新功能：
- 添加 I/O 性能测试。
v1.24 版本说明
新增备份排除项
发布于 2017 年 9 月 28 日
漏洞修复：
- 修复从备库初始化备份期间警告消息覆盖低优先级日志消息输出的问题。（由 uspen 报告。）
- 修复部分
db-*选项（如db-port）未传递给远程的问题。（由 uspen 报告。）
新功能：
- 从备份中排除
pg_snapshots、pg_serial、pg_notify和pg_dynshmem目录的内容，因为这些内容在启动时会重建。 - 从备份中排除
pg_internal.init文件，因为这些文件在启动时会重建。
改进：
- 在异步进程完全从主进程分离后才打开日志文件，以防止主进程向该文件写入日志。（由 Jens Wilke 建议。）
文档新功能：
- 添加无密码 SSH 配置说明。
文档改进：
- 在文档中将
master重命名为primary，与 PostgreSQL 惯例保持一致。
v1.23 版本说明
多备库与 PostgreSQL 10 支持
发布于 2017 年 9 月 3 日
漏洞修复：
- 修复文件持续增大时压缩可能中止的问题。（由 Jesper St John、Aleksandr Rogozin 报告。）
- 修复本地进程未向远程发送 keep-alive 的问题。（由 William Cox 报告。）
新功能：
- 支持配置最多七个备库用于从备库备份。（由 Cynthia Shang 贡献，David Steele 审核。）
- 支持 PostgreSQL 10。
- 在读取 XML 数据时允许使用
content-length（除分块编码外），以提升与第三方 S3 网关的兼容性。（由 Victor Gdalevich 建议。）
改进：
- 增加 S3 的 HTTP 超时时间。
- 添加 HTTP 重试，增强对 S3 瞬时网络错误的容错能力。
文档漏洞修复：
- 修复文档生成，在配置页面中包含章节摘要。（由 Cynthia Shang 修复，David Steele 审核。）
v1.22 版本说明
修复 S3 重试
发布于 2017 年 8 月 9 日
漏洞修复：
- 修复 S3 重试中的身份验证问题。
v1.21 版本说明
改进 info 输出及 SSH 端口选项
发布于 2017 年 8 月 8 日
漏洞修复：
- 恢复时现在会重新创建
archive_status目录，以支持 PostgreSQL 8.3——该版本与较新版本不同，不会自动重建此目录。（由 Stephen Frost 报告。） - 修复了执行
stanza-upgrade后，旧版 PostgreSQL 的空归档目录可能残留的问题。（由 Cynthia Shang 修复，David Steele 审核。）
新功能：
- 改进了
info命令的文本与 JSON 输出，新增归档 ID 字段，以及当前与历史数据库集群版本（如有）在归档中的最小/最大 WAL 信息。（由 Cynthia Shang 贡献，David Steele 审核。） - 新增
--backup-ssh-port和--db-ssh-port选项，支持非默认 SSH 端口。（由 Cynthia Shang 贡献，David Steele 审核。）
改进：
- 当 S3 返回内部错误（500）时自动重试。
文档漏洞修复：
- 根据命令上下文修正了
--online选项的描述。
文档新功能：
- 在手动安装说明中新增了创建
/etc/pgbackrest.conf的步骤。
文档改进：
- 将仓库选项移入命令行帮助的独立章节。（由 Stephen Frost 建议。）
v1.20 版本说明
关键 8.3/8.4 漏洞修复
发布于 2017 年 6 月 27 日
重要提示：使用了表空间的 PostgreSQL 8.3 和 8.4 环境，应立即从任意 v1 版本升级并执行一次全量备份。本版本修复了一个仅影响上述两个版本的漏洞——该漏洞会导致表空间无法被备份。PostgreSQL >= 9.0 不受影响。
漏洞修复：
- 修复了 PostgreSQL <= 8.4 上表空间无法备份的问题。
- 修复了 C 库构建时缺少编译标志的问题，该问题会导致在 32 位系统上生成不匹配的二进制文件。（由 Adrian Vondendriesch 报告。）
新功能：
- 新增
s3-repo-ca-path和s3-repo-ca-file选项，支持IO::Socket::SSL无法自动定位 CA 的系统（如 RHEL7），或加载自定义 CA。（由 Scott Frazer 建议。）
测试套件新功能：
- 将文档构建纳入 CI 流程。
v1.19 版本说明
S3 支持
发布于 2017 年 6 月 12 日
漏洞修复：
- 修复了
info命令，确保显示的 WAL 归档最小/最大值对应当前数据库版本。（由 Cynthia Shang 修复，David Steele 审核。） - 修复了
backup命令：当备库未配置或不可达时，backup-standby选项现在会被重置，并继续在主库上执行备份。（由 Cynthia Shang 修复，David Steele 审核。） - 修复了远程进程产生的配置警告导致主进程报错的问题。（由 Cynthia Shang 修复，David Steele 审核。）
新功能：
- 支持将 Amazon S3 作为备份仓库。（由 Cynthia Shang 审核。）
文档漏洞修复：
- 将配置参考中无效的
max-archive-mb选项更正为archive-queue-max。 - 修复了安装章节中缺少
sudo的问题。（由 Lætitia 修复，David Steele 审核。）
v1.18 版本说明
stanza 升级、代码重构与锁机制改进
发布于 2017 年 4 月 12 日
漏洞修复：
- 修复了一个问题：使用本地工作进程的只读操作（如
restore）会创建写锁，干扰并行archive-push。（由 Jens Wilke 报告。）
新功能：
- 新增
stanza-upgrade命令，为 PostgreSQL 主版本升级后的 stanza 升级提供了正式机制。（由 Cynthia Shang 贡献，David Steele 审核。） - 新增对
pgbackrest.conf的验证功能，当选项无效或所在章节不正确时输出警告。（由 Cynthia Shang 贡献，David Steele 审核。）
改进：
- 简化了锁机制。现在仅主进程持有写锁（用于
archive-push和backup命令），不再要求所有本地和远程工作进程都持锁。 - 不再将备份目录中文件的时间戳同步为与集群目录一致。此做法原本为支持备份续传而设计，该功能现已改由校验和机制实现。
- 改进了
restore命令检测到postmaster.pid时的错误提示信息。（由 Yogesh Sharma 建议。） - 将返回码范围从 25~125 重新编号，以避免 PostgreSQL 将某些返回码解释为致命信号异常。（由 Yogesh Sharma 建议。）
v1.17 版本说明
页面校验和漏洞修复
发布于 2017 年 3 月 13 日
漏洞修复：
- 修复了新初始化但未使用的页面触发页面校验和警告的问题。（由 Stephen Frost 报告。）
v1.16 版本说明
页面校验和改进、CI 与包测试
发布于 2017 年 3 月 2 日
漏洞修复：
- 修复了超过 1GB 的表在第一个段之后报告页面校验和警告的问题。（由 Stephen Frost 报告。）
- 修复了使用非默认表空间创建的数据库，对
pg_filenode.map和pg_internal.init产生虚假页面未对齐警告的问题。（由 blogh 报告。）
测试套件新功能：
- 集成
travis-ci进行持续集成。 - 为所有受支持发行版自动构建 Debian 软件包。
v1.15 版本说明
代码重构与漏洞修复
发布于 2017 年 2 月 13 日
漏洞修复：
- 修复了 v1.13 引入的回归问题：构建 manifest 期间若有文件被删除（如表被删除），备份可能失败。（由 Navid Golpayegani 报告。）
v1.14 版本说明
代码重构与漏洞修复
发布于 2017 年 2 月 13 日
漏洞修复：
- 修复了
archive-push报错后不重试、而是无限期向 PostgreSQL 返回错误（除非手动删除.error文件）的问题。（由 Jens Wilke 报告。） - 修复了并行归档中的竞争条件：多个进程同时尝试创建新路径时会产生错误。（由 Jens Wilke 报告。）
改进：
- 提升了
info命令中wal archive min/max的查询性能。（由 Jens Wilke 建议。）
文档新功能：
- 更新了异步归档文档，更准确地描述了新方法的工作原理及其与旧方法的差异。（由 Jens Wilke 建议。）
v1.13 版本说明
并行归档、stanza 创建、改进的 info 与 check
发布于 2017 年 2 月 5 日
重要提示：异步归档的新实现不再将 WAL 复制到独立队列。升级到 1.13 后，旧队列中残留的 WAL 将被放弃，不会 推送到仓库。为避免数据丢失，请在升级前通过设置 archive_command = false 停止归档，然后执行 pgbackrest --stanza=[stanza-name] archive-push 清空异步队列并等待进程结束，确认 [spool-path]/archive/[stanza-name]/out 中的队列已清空，最后再安装 1.13 并恢复原始 archive_command。重要说明：stanza-create 命令不再是可选步骤，在 新 stanza 上执行备份或归档前必须先执行该命令。已有 stanza 无需重新执行。
漏洞修复：
- 修复了 C 库中 const 赋值导致编译器警告的问题。（由 Adrian Vondendriesch 修复，David Steele 审核。）
- 修复了
--repo-sync选项遗漏的若干目录同步操作。 - 修复了恢复时因用户/组缺失导致
File->owner()出现"未初始化值"错误的问题。（由 Leonardo GG Avellar 报告。） - 修复了协议不匹配错误未输出预期值的问题。
- 修复了
archive-get的一条虚假日志消息，该消息错误地将退出码 1 标记为异常终止。
新功能：
- 改进了异步归档的多进程实现。
- 改进了
stanza-create命令，使其能在大多数情况下修复损坏的仓库，并具备足够的健壮性以成为强制执行步骤。（由 Cynthia Shang 贡献，David Steele 审核。） - 改进了
check命令，使其可在备库上运行；由于副本无法执行pg_switch_xlog()，仅执行基本检查。（由 Cynthia Shang 贡献，David Steele 审核。） - 在
info命令中新增了归档和备份的 WAL 范围信息。 - 在 PostgreSQL < 9.2 中重映射表空间时，新增更新
pg_tablespace.spclocation的警告提示。（由 blogh 贡献，David Steele 审核。） - 移除了
archive-get、restore、info和check命令的远程锁需求，因为上述均为只读操作。（由 Michael Vitale 建议。）
改进：
- 日志文件头信息现在等到第一条日志条目写入时才输出。（由 Jens Wilke 建议。）
- 通过以备份起始 LSN 过滤，降低了撕裂页面导致页面校验和误报的概率。
- 从 C 库构建标志中移除了 Intel 专用优化。（由 Adrian Vondendriesch 贡献，David Steele 审核。）
- 移除了
--lock选项。该选项在锁目录可以位于仓库之外前引入，现已废弃。 - 新增
--log-timestamp选项，允许在日志中抑制时间戳输出，主要用于自动化文档场景以避免过滤器干扰。 - 修复了无法将相对路径转换为绝对路径时未返回正确错误码的问题。（由 Yogesh Sharma 建议。）
文档新功能：
- 在用户指南中新增了
process-max选项的说明文档。（由 Cynthia Shang 贡献，David Steele 审核。）
v1.12 版本说明
页面校验和、配置改进与漏洞修复
发布于 2016 年 12 月 12 日
重要提示：在此前版本中，命令行上指定对当前命令无效的选项不会报错。现在无效选项将产生错误，请仔细检查环境中的命令行参数以避免升级中断。
漏洞修复：
- 修复了命令行上提供对指定命令无效的选项时不报错的问题。这些选项虽被忽略且不影响行为，但容易造成混淆。无效选项现在将产生错误。（由 Nikhilchandra Kulkarni 报告。）
- 修复了仓库中表空间内部符号链接未被创建的问题。此问题仅在尝试通过文件系统快照在原地手动启动集群时才会出现，不影响正常的备份与恢复。
- 修复了日志系统初始化之前（即解析选项期间）错误信息无法输出到控制台的问题。错误码仍会准确返回，进程不会在实际失败时显示为成功。（由 Adrian Vondendriesch 报告。）
- 修复了备份服务器上指定的
db-port选项，若不来自第一个已配置的数据库则无法正确传递给远程的问题。（由 Michael Vitale 报告。）
新功能：
- 新增
--checksum-page选项，允许 pgBackRest 在 PostgreSQL >= 9.3 且启用了页面校验和的情况下，验证数据文件中的页面校验和。注意：此功能依赖 C 库，操作系统软件包中可能暂不提供。当 C 库存在且集群启用了校验和时，该选项将自动启用。（由 Stephen Frost 建议。） - 新增
--repo-link选项，允许在仓库位于不支持符号链接的文件系统时抑制内部符号链接的创建。这不影响 pgBackRest 的任何核心功能，但不会创建latest便捷链接及内部表空间符号链接，从而影响通过文件系统快照在原地手动启动集群的能力。 - 新增
--repo-sync选项，允许在不支持目录同步的文件系统（如 NTFS）上禁用仓库目录同步。 - 新增可预测的日志条目，用于标识命令已成功完成。例如，备份成功结束时将输出：
INFO: backup command end: completed successfully。（由 Jens Wilke 建议。）
改进：
- 为简化处理，
pg_control文件现在与其他文件一同复制，不再单独在流程末尾复制。backup命令不依赖此行为，restore命令则将文件复制到临时文件，在恢复结束时重命名。
文档漏洞修复：
- 修复了 PDF 构建中异常抑制的问题。
- 修复了 v1.10 引入的章节链接回归问题。
文档新功能：
- 在快速入门章节中新增了保留策略相关内容。
v1.11 版本说明
异步归档效率漏洞修复
发布于 2016 年 11 月 17 日
漏洞修复：
- 修复了异步归档每次执行只传输一个文件而非批量传输的问题。此回归问题自 v1.09 引入，仅影响效率——异步模式下所有 WAL 段均被正确归档。（由 Stephen Frost 报告。）
v1.10 版本说明
stanza 创建与小型漏洞修复
发布于 2016 年 11 月 8 日
漏洞修复：
- 修复了两次备份之间数据库没有任何变更、仅
pg_control发生变化时备份可能报错的问题。 - 修复了前缀相同的表空间路径触发无效链接错误的问题。（由 Nikhilchandra Kulkarni 报告。）
新功能：
- 新增
stanza-create命令，正式化了在仓库中创建 stanza 的流程。（由 Cynthia Shang 贡献，David Steele 审核。）
改进：
- 从 Perl 模块中移除了多余的
use lib指令。（由 Devrim Gündüz 建议。）
v1.09 版本说明
9.6 支持、可配置性改进与漏洞修复
发布于 2016 年 10 月 10 日
漏洞修复：
- 修复了
check命令在备份目录不存在时仍记录错误日志消息的问题。（由 Cynthia Shang 修复，David Steele 审核。） - 修复了检测到无效归档命令时错误消息未正确显示该命令的问题。（由 Jason O’Donnell 报告。）
- 修复了一个问题：当
archive-push没有足够空间排队新 WAL 段时，异步归档进程不会被启动，导致队列永远无法清空（除非手动干预，例如直接调用archive-push）。现在，当空间不足时 PostgreSQL 会收到错误，但异步进程仍会被启动，以便最终释放空间。（由 Jens Wilke 报告。） - 修复了一个远程超时问题：本地进程在生成校验和（续传或恢复期间）而未复制文件时，远程进程可能进入空闲状态。（由 Jens Wilke 报告。）
新功能：
- 在 PostgreSQL 9.6 上将自动使用非独占备份。
- 新增
cmd-ssh选项，允许指定 SSH 客户端。（由 Jens Wilke 建议。） - 新增
log-level-stderr选项，控制台日志消息输出到stderr还是stdout。默认值为warn，与旧版本行为略有不同，但更符合直觉。设置log-level-stderr=off可恢复旧行为。（由 Sascha Biberhofer 建议。） - 将数据库连接的
application_name设置为"pgBackRest [command]"。（由 Jens Wilke 建议。） - 当
archive-check选项启用时，检查archive_mode是否已开启。
改进：
- 优化了无法获取 pgBackRest 顾问锁时的错误提示，明确说明这不是 PostgreSQL 备份锁。（由 Jens Wilke 建议。）
- 命令启动的 INFO 日志中包含 pgBackRest 版本号。
- 本地进程启动/停止的 INFO 日志中记录进程 ID。
文档新功能：
- 在用户指南中新增了
archive-timeout选项的说明文档。（由 Cynthia Shang 贡献，David Steele 审核。）
v1.08 版本说明
漏洞修复与日志改进
发布于 2016 年 9 月 14 日
漏洞修复：
- 修复了本地进程完成后未断开连接、可能导致稍后超时的问题。（由 Todd Vernick 报告。）
- 修复了协议层在等待 WAL 段到达归档时可能超时的问题。（由 Todd Vernick 报告。）
改进：
- 缓存文件日志输出，直到文件创建完成，以生成更完整的日志记录。
v1.07 版本说明
线程转进程及漏洞修复
发布于 2016 年 9 月 7 日
漏洞修复：
- 修复了备库备份期间表空间从主库复制的问题。
- 修复了
check命令：备份信息现在同时在远程和本地进行检查，而不仅仅在本地。（由 Cynthia Shang 修复，David Steele 审核。） - 修复了
retention-archive-type=diff时retention-archive未被自动设置、导致归档过期不积极的问题。（由 Cynthia Shang 修复，David Steele 审核。）
新功能：
- 将 Perl 线程转换为进程，提高兼容性与性能。
- 排除
$PGDATA/pg_replslot目录内容，防止主库上的复制槽被纳入备份。 - 即使
archive-check=n，archive-start和archive-stop设置也会写入backup.manifest。（由 Jens Wilke 建议。） - 当归档保留策略设置可能未达到预期效果或会导致无限期保留时，新增额外警告。（由 Cynthia Shang 贡献，David Steele 审核。）
- 对 PostgreSQL 9.6 rc1 的非独占备份提供实验性支持。后续候选版本中控制/目录/WAL 版本的变更可能破坏兼容性，但 pgBackRest 将跟随每个版本更新。
文档漏洞修复：
- 修复了与二进制路径相关的文档可复现性问题。
文档新功能：
- 新增归档保留策略文档。（由 Cynthia Shang 贡献，David Steele 审核。）
v1.06 版本说明
从备库备份与漏洞修复
发布于 2016 年 8 月 25 日
漏洞修复：
- 修复了引用另一个链接的表空间链接不报错、而是直接跳过该表空间的问题。（由 Michael Vitale 报告。）
- 修复了
pgbackrest.conf中不允许多值的选项可被多次指定而不报错的问题。（由 Michael Vitale 报告。） - 修复了增大
db-timeout选项时protocol-timeout未自动同步增大的问题。（由 Todd Vernick 报告。）
新功能：
- 支持从备库集群执行备份。仍需连接主库以启动/停止备份并复制未被复制的文件，但绝大多数文件从备库复制，从而降低主库负载。
- 更灵活的数据库配置。主库和备库均可在备份服务器上配置，pgBackRest 将自动判断哪个是主库。使用独立备份服务器时，主备切换后无需修改备份配置。
- 备份时排除 PostgreSQL 启动时会清理、重建或清零的目录，包括
pgsql_tmp和pg_stat_tmp。postgresql.auto.conf.tmp文件现在也被排除，此外还有之前已排除的文件：backup_label.old、postmaster.opts、postmaster.pid、recovery.conf、recovery.done。 - 对 PostgreSQL 9.6 beta4 的非独占备份提供实验性支持。后续 Beta 版本中控制/目录/WAL 版本的变更可能破坏兼容性，但 pgBackRest 将跟随每个版本更新。
改进：
- 改进了 manifest 构建中链接指向另一链接时的错误消息。
- 在
archive-push或archive-get中检测到相对路径时，在错误消息中添加了提示信息。 - 改进了备份日志消息，明确指出文件正在从哪台主机复制。
v1.05 版本说明
表空间链接检查漏洞修复
发布于 2016 年 8 月 9 日
漏洞修复：
- 修复了一个问题：以
$PGDATA为子字符串的表空间路径，即使实际上不是$PGDATA的子目录，也会被误识别为子目录。同时对相对路径检查进行了加固。（由 Chris Fort 报告。）
文档新功能：
- 新增了使用 cron 调度备份的文档。（由 Cynthia Shang 贡献，David Steele 审核。）
文档改进：
- 将积压事项从 pgBackRest 网站迁移到 GitHub 仓库 Wiki。（由 Cynthia Shang 贡献，David Steele 审核。）
v1.04 版本说明
各类漏洞修复
发布于 2016 年 7 月 30 日
漏洞修复：
- 修复了多余远程连接导致多线程备份/恢复可能超时或产生锁冲突的问题。（由 Michael Vitale 报告。）
- 修复了
check命令未强制要求db-path、缺失时触发断言而非友好错误消息的问题。（由 Michael Vitale 报告。） - 修复了
check命令在数据库版本/ID 与归档不匹配时未抛出错误的问题。（由 Cynthia Shang 修复，David Steele 审核。） - 修复了数据库服务器的
pgbackrest.conf中没有backup-host选项时，远程进程可能尝试启动自身远程进程的问题。（由 Lardière Sébastien 报告。） - 修复了
pg_xlog目录为符号链接时其内容被纳入备份的问题。这不会影响恢复，但会浪费存储空间。 - 修复了锁操作中一个无效的
log()调用。
新功能：
- 对 PostgreSQL 9.6 beta3 的非独占备份提供实验性支持。后续 Beta 版本中控制/目录/WAL 版本的变更可能破坏兼容性，但 pgBackRest 将跟随每个版本更新。
改进：
- 抑制 SSH 协议连接上的横幅信息。
- 改进了远程错误消息，标识出发生错误的主机。
- 所有远程类型现在都会获取锁。此前的例外情况源于测试框架和 pgBackRest 运行在同一虚拟机中的历史原因，现已不再适用。
文档新功能：
- 新增了关于
backrest-user选项默认值为backrest的说明。（由 Michael Vitale 建议。） - 更新了受支持平台上软件包可用性的相关信息。（由 Michael Vitale 建议。）
v1.03 版本说明
check 命令与漏洞修复
发布于 2016 年 7 月 2 日
漏洞修复：
- 修复了多线程
backup期间大量小文件导致keep-alives被抢占，以及单/多线程backup续传和restore校验和计算中完全缺少 keep-alive 的问题。（由 Janice Parkinson、Chris Barber 报告。） - 修复了设置
db-host选项后从命令行显式调用expire命令被拒绝执行的问题。backup后自动运行expire时不受此问题影响。（由 Chris Barber 报告。） - 修复了即使禁用
archive-check选项，仍会验证archive_command的问题。
新功能：
- 新增
check命令，用于验证 pgBackRest 的归档和备份配置是否正确。（由 Cynthia Shang 贡献，David Steele 审核。） - 新增
protocol-timeout选项。此前该值固定为db-timeout+ 30 秒。 - 备份结束时远程关闭失败不再抛出异常，改为生成建议提高
protocol-timeout的警告。 - 对 PostgreSQL 9.6 beta2 的非独占备份提供实验性支持。后续 Beta 版本中控制/目录/WAL 版本的变更可能破坏兼容性，但 pgBackRest 将跟随每个版本更新。
改进：
- 改进了备份时捕获的用户/组在恢复主机上不存在的处理方式，同时明确处理了用户/组未映射到名称的情况。
- 选项处理现在更加严格。此前命令可能使用未明确分配给它的选项，
backup-host和db-host选项尤为如此，这两个选项用于判断操作是否为本地执行。
文档改进：
- 允许在文档中使用静态日期，以生成可复现的构建结果。（由 Adrian Vondendriesch 建议。）
- 在用户指南中新增了异步归档的文档。（由 Cynthia Shang 贡献，David Steele 审核。）
- pgBackRest 模块的推荐安装位置更改为
/usr/share/perl5，因为/usr/lib/perl5在较新版本的 Perl 中已从搜索路径中移除。 - 新增了删除旧版本 pgBackRest 的操作说明。
v1.02 版本说明
修复 Perl 5.22 兼容性
发布于 2016 年 6 月 2 日
漏洞修复：
- 修复了
sprintf()的使用方式，使其符合 Perl 5.22 的新限制——格式字符串中不再允许未引用的参数。（由 Adrian Vondendriesch 修复，David Steele 审核。）
文档漏洞修复：
- 修复了与 Perl 5.2X 不兼容的语法。（由 Christoph Berg、Adrian Vondendriesch 修复，David Steele 审核。）
- 修复了 PDF 徽标中使用绝对路径的问题。（由 Adrian Vondendriesch 报告。）
文档新功能：
- 发布说明现在按章节划分，明确区分漏洞修复、新功能和代码重构。新增"附加说明"章节，用于记录不影响核心代码的文档和测试套件变更。
- 新增 man 页面生成功能。（由 Adrian Vondendriesch、David Steele 贡献。）
- 变更日志是最后一个仅以 Markdown 格式渲染的文档。现编写了转换器使其可由标准渲染器输出。变更日志现已发布在网站上，并更名为"发布说明（Releases）"。（由 Cynthia Shang 贡献，David Steele 审核。）
v1.01 版本说明
增强的 info、选择性恢复与 9.6 支持
发布于 2016 年 5 月 17 日
新功能：
- 增强了
info命令的文本输出，包含所有备份的时间戳、大小和参考列表。（由 Cynthia Shang 贡献，David Steele 审核。） - 支持从集群备份中选择性恢复指定数据库。当只需恢复特定数据库时，此功能可大幅节省空间和时间。未恢复的数据库将不可访问，在从共享目录中删除前须手动处理。（由 Cynthia Shang、Greg Smith、Stephen Frost 审核，Stephen Frost 建议。）
- 对 PostgreSQL 9.6 beta1 的非独占备份提供实验性支持。后续 Beta 版本中控制/目录/WAL 版本的变更可能破坏兼容性，但 pgBackRest 将跟随每个版本更新。（由 Cynthia Shang 审核。）
v1.00 版本说明
新仓库格式与配置方案、链接支持
发布于 2016 年 4 月 14 日
重要提示：此次重大版本变更与旧版本 pgBackRest 不兼容。manifest 格式、磁盘目录结构、配置方案以及可执行文件/路径名称均已变更。您必须为此版本的 pgBackRest 创建新仓库以存储备份，并暂时保留旧仓库以备恢复之需。从旧仓库恢复需使用旧版本的 pgBackRest，但由于名称变更，可同时安装 1.00 与旧版本。具体变更如下。
新功能：
- 实现了全新的配置方案，使用更为简便。详见用户指南和配置参考。对于简单配置，所有选项现在都可以放在
stanza章节中；多个 stanza 间共享的选项可以放在[global]章节；更复杂的配置仍可使用命令章节，但这应属于少见情况。（由 Michael Renner 建议。） repo-path选项现在始终指向存储备份和归档的仓库，无论本地还是远程，因此repo-remote-path选项已被移除。新增spool-path选项，可用于定义异步归档时排队 WAL 段的位置。本地仓库不再是必需的。- 默认配置文件名由
pg_backrest.conf改为pgbackrest.conf，以与其他命名变更保持一致，同时防止迁移到 1.00 时意外加载旧配置文件。（由 Michael Renner、Stephen Frost 建议。） - 默认仓库路径由
/var/lib/backup改为/var/lib/pgbackrest。（由 Michael Renner、Stephen Frost 建议。） - 锁文件现在默认存储在
/tmp/pgbackrest中。目前/run/pgbackrest是首选位置，但这需要初始化脚本，本版本暂不包含。可使用lock-path选项配置锁目录。 - 日志文件现在默认存储在
/var/log/pgbackrest中，文件名不再追加日期，便于使用logrotate管理。可使用log-path选项配置日志目录。（由 Stephen Frost 建议。） - 可执行文件名由
pg_backrest改为pgbackrest。（由 Michael Renner、Stephen Frost 建议。） PGDATA中所有链接的文件和目录现在均包含在备份中。默认情况下，链接在恢复时将直接作为文件或目录还原到PGDATA中。可使用--link-all选项将所有链接恢复到其原始位置，或使用--link-map选项将链接重新映射到新位置。- 移除了
--tablespace选项，以--tablespace-map-all选项替代，更清晰地表达其功能。 - 新增
detail日志级别，输出介于info和debug之间的详细信息。
预稳定版本
v0.92 版本说明
命令行仓库路径修复
发布于 2016 年 4 月 6 日
漏洞修复：
- 修复了主进程将
--repo-remote-path而非--repo-path传递给远程的问题，该问题导致锁文件被创建在默认仓库目录（/var/lib/backup）中，通常以失败告终。此问题仅在命令行（而非pg_backrest.conf）中定义了--repo-remote-path时才会出现。（由 Jan Wieck 报告。）
v0.91 版本说明
表空间漏洞修复与小型改进
发布于 2016 年 3 月 22 日
表空间重要漏洞修复：v0.90 意外引入了仓库格式变更，导致包含表空间的备份在磁盘上不再是有效的 PostgreSQL 集群。此问题仅影响直接复制备份来恢复 PostgreSQL 集群（而非使用 restore 命令）的用户。无论采用哪种恢复方式，此修复与包含表空间的旧备份均不兼容（pgBackRest 将抛出错误并拒绝恢复）。对于包含表空间的集群，安装 v0.91 后应立即执行新的全量备份。如需恢复旧备份，请使用与备份版本匹配的 pgBackRest 版本。
漏洞修复：
- 修复了 pgBackRest v0.90 引入的仓库不兼容问题。（由 Evan Benoit 报告。）
新功能：
- 备份时最后复制
global/pg_control。 - 将
.info和.manifest文件先写入临时文件，再移动到最终位置并执行fsync。 - 将
--no-start-stop选项重命名为--no-online。
测试套件新功能：
- 使用 Perl-Critic 进行静态源码分析，目前在
gentle（宽松）级别通过。
v0.90 版本说明
9.5 支持、各类改进与小型漏洞修复
发布于 2016 年 2 月 7 日
漏洞修复：
- 修复了指定
--no-archive-check时抛出配置错误的问题。（由 Jason O’Donnell 报告。） - 修复了系统在恰当时机崩溃后遗留的临时 WAL 文件导致下次
archive-push失败的问题。 retention-archive选项现在可以安全地设置为低于备份保留值（retention-full或retention-diff），而无需同时指定archive-copy=n。使超出归档保留范围的备份保持一致性所需的 WAL 将被保留在归档中。但在此情况下，超出归档保留范围的备份将无法进行 PITR。
新功能：
- 备份和恢复表空间时，pgBackRest 仅操作为当前运行的 PostgreSQL 版本创建的子目录。由于多个版本可以共用同一个表空间目录（尤其是在二进制升级期间），这可以防止备份时复制过多文件，以及恢复时可能清除其他版本数据。此特性仅适用于 PostgreSQL >= 9.0——更早版本不支持共享表空间目录。
- 当
archive-check=y但archive_command不执行pg_backrest时，生成错误。（由 Jason O’Donnell 贡献，David Steele 审核。） - 改进了
repo-path或repo-remote-path不存在时的错误消息。 - 为
--delta和--force恢复选项新增了检查，确保目标是有效的 $PGDATA 目录。pgBackRest 将检查PG_VERSION或backup.manifest（中止恢复的遗留文件）是否存在。如果两个文件均不存在，--delta和--force将被禁用，但恢复仍会继续——除非 $PGDATA 目录（或任何表空间目录）中有文件存在，此时操作将被中止。 - 当
restore --set=latest（默认值）时，实际恢复的备份将输出到日志中。 - 支持 PostgreSQL 9.5 的部分 WAL 段和
recovery_target_action设置。archive_mode = 'always'暂不支持。 - 支持 PostgreSQL 9.4 引入的
recovery_target = 'immediate'恢复设置。 - 新增以下表空间检查：
pg_tblspc中存在路径或普通文件、pg_tblspc中存在相对链接、$PGDATA 中存在表空间。以上三种情况均会产生错误。
v0.89 版本说明
超时漏洞修复与只读仓库恢复
发布于 2015 年 12 月 24 日
漏洞修复：
- 修复了使用远程和多线程时，长时间运行的备份/恢复会超时的问题。现在使用
keepalive确保主进程的远程连接在线程处理所有工作期间不会超时。同时改进了超时的错误消息，便于调试。（由 Stephen Frost 报告。）
新功能：
- 允许通过
--no-lock和--log-level-file=off在只读仓库上执行恢复。--no-lock选项仅用于恢复操作。
v0.88 版本说明
文档与小型漏洞修复
发布于 2015 年 11 月 22 日
漏洞修复：
- 修复了
start/stop命令要求提供--config选项的问题。（由 Dmitry Didovicher 报告。） - 修复了日志文件被覆盖而非追加写入的问题。（由 Stephen Frost、Dmitry Didovicher 报告。）
- 修复了
backup-user不是可选项的问题。
新功能：
- 备份仓库目录中不再创建符号链接。这些符号链接可能指向任意位置，存在安全风险。恢复时仍会重新创建符号链接。（由 Stephen Frost 建议。）
- 改进了备份过期的消息输出。全量和差异备份的过期信息现在合并为一行记录，并附带所有关联备份的列表。
- 如果归档保留策略未显式配置，则自动设置为与全量备份保留策略一致。
文档新功能：
- 在用户指南中新增了
delta恢复、过期策略、专用备份主机、启动和停止 pgBackRest 以及复制相关文档。
v0.87 版本说明
网站与用户指南
发布于 2015 年 10 月 28 日
新功能：
backup_label.old和recovery.done文件现在从备份中排除。
文档新功能：
- 新增用户指南，涵盖 pgBackRest 基础知识及部分高级主题（包括 PITR）。内容还会持续扩充，这是一个良好的开端。（由 David Steele、Stephen Frost 贡献，Michael Renner、Cynthia Shang、Eric Radman、Dmitry Didovicher 审核。）
v0.85 版本说明
start/stop 命令与小型漏洞修复
发布于 2015 年 10 月 8 日
漏洞修复：
- 修复了备份或恢复成功完成后仍可能返回错误的问题。
- 修复了备份失败时根备份目录中残留临时文件、导致续传失败的问题。备份进程在复制阶段被终止时很可能出现此情形。
新功能：
- 新增
stop和start命令，用于在 PostgreSQL 关闭或系统需要以其他原因静默时，阻止 pgBackRest 进程运行。 - 对 PostgreSQL 9.5 beta1 提供实验性支持。未来版本中控制版本或 WAL magic 变更时可能发生兼容性问题，但 pgBackRest 将跟随每个版本更新。除
--target-resume测试（此功能在 9.5 中已更改）外，所有回归测试均通过，.partialWAL 段暂未测试。
v0.82 版本说明
代码重构、命令行帮助与小型漏洞修复
发布于 2015 年 9 月 14 日
漏洞修复：
- 修复了续传的压缩备份未保留已有文件的问题。
- 修复了续传与增量/差异备份未检验前序备份是否具有相同压缩和硬链接设置的问题。
- 修复了未指定
--force时，使用--no-start-stop的冷备份可能在运行中的 PostgreSQL 集群上启动的问题。 - 修复了即使未请求线程也可能启动一个线程的问题。
- 修复了升级/降级后
backup.info和archive.info中 pgBackRest 版本号未被更新的问题。 - 修复了仓库中没有
stanza时info命令抛出异常的问题。（由 Stephen Frost 报告。） - 修复了 PostgreSQL 的
pg_stop_backup()NOTICE 信息被输出到stderr的问题。（由 Stephen Frost 报告。）
新功能：
- 对 PostgreSQL 9.5 alpha2 提供实验性支持。未来版本中控制版本或 WAL magic 变更时可能发生兼容性问题，但 pgBackRest 将跟随每个版本更新。除
--target-resume测试（此功能在 9.5 中已更改）外，所有回归测试均通过，.partialWAL 段暂未测试。
改进：
- 将
recovery-setting选项和章节重命名为recovery-option，与 pgBackRest 命名约定保持一致。 - 新增动态模块加载，加快命令执行速度，尤其是异步归档场景。
文档新功能：
- 命令行帮助现在从与其他文档共用的同一 XML 源中提取，包含更多详细信息。
v0.80 版本说明
DBI 支持、稳定性与便利性改进
发布于 2015 年 8 月 9 日
漏洞修复：
- 修复了
info命令将最旧和最新备份的格式化时间戳都显示为当前时间的问题。仅text输出受影响，json输出报告的epoch值是正确的。（由 Michael Renner 报告。） - 修复了阻止 SSH 错误（尤其是连接时）被记录的协议问题。
新功能：
- 仓库现在以统一的目录和文件权限模式创建和更新。默认情况下
umask被设置为0000，可通过neutral-umask设置禁用。（由 Cynthia Shang 建议。） - 新增
stop-auto选项，允许在启动新备份时自动停止失败的备份。 - 新增
db-timeout选项，限制 pgBackRest 等待pg_start_backup()和pg_stop_backup()返回的最长时间。 - 恢复开始时移除
pg_control文件，在最后才将其复制回去，防止 PostgreSQL 启动部分恢复的实例。 - 新增检查，通过比较集群报告的
data_directory与db-path设置，以及集群报告的版本与从pg_control读取的值，确保db-path与db-port设置一致。同时检查db-socket-path是否为绝对路径。 - 对 PostgreSQL 9.5 alpha1 提供实验性支持。未来版本中控制版本或 WAL magic 变更时可能发生兼容性问题，但 pgBackRest 将跟随每个版本更新。除
--target-resume测试（此功能在 9.5 中已更改）外，所有回归测试均通过，.partialWAL 段暂未测试。
改进：
- 现在使用 Perl 的
DBI和DBD::Pg连接 PostgreSQL，替代原来的psql。cmd-psql和cmd-psql-option设置已被移除，替换为db-port和db-socket-path。请按照安装指南在您的操作系统上安装DBD::Pg。
测试套件新功能：
- 新增了 Ubuntu 14.04 和 CentOS 7 的 vagrant 测试配置。
v0.78 版本说明
移除 CPAN 依赖、稳定性改进
发布于 2015 年 7 月 13 日
改进：
- 移除了多线程操作对 CPAN 软件包的依赖。更新
threads和Thread::Queue软件包并非坏事，但现在不再是必须。 - 将等待退避策略由等比数列改为斐波那契数列，等待时间增长更为平缓，同时保持合理的上限。
测试套件新功能：
- 新增了 Ubuntu 12.04 和 CentOS 6 的 vagrant 测试配置。
v0.77 版本说明
CentOS/RHEL 6 支持与协议改进
发布于 2015 年 6 月 30 日
新功能：
- 在
File对象中新增了文件和目录同步，为备份/恢复和归档操作提供额外的数据安全保障。（由 Andres Freund 建议。） - 新增对 CentOS/RHEL 6 默认版本 Perl 5.10.1 和 OpenSSH 5.3 的支持。（由 Eric Radman 建议。）
- 改进了未设置
archive_command且未指定--no-archive-check时运行备份的错误消息。（由 Eric Radman 建议。）
v0.75 版本说明
新仓库格式、info 命令与实验性 9.5 支持
发布于 2015 年 6 月 14 日
重要提示：此次重大版本变更与旧版本 pgBackRest 不兼容。manifest 格式、磁盘目录结构以及二进制文件名均已变更。您必须为此版本的 pgBackRest 创建新仓库以存储备份，并暂时保留旧仓库以备恢复之需。pg_backrest.conf 配置文件未变更，但需要将 cron（或其他位置）中对 pg_backrest.pl 的引用改为 pg_backrest（去掉 .pl 扩展名）。
新功能：
- 新增
info命令。 - 日志现在使用非缓冲输出，使多线程并发写入的日志文件更加有序。（由 Michael Renner 建议。）
- 对 PostgreSQL 9.5 提供实验性支持。控制版本或 WAL magic 变更时可能发生兼容性问题，但将在每个版本中同步更新。
改进：
- 改进了
backup的文件处理顺序，按文件大小降序复制，防止单个线程在末尾处理大文件。此优化此前已在restore中实现。
v0.70 版本说明
归档稳定性改进、日志与帮助优化
发布于 2015 年 6 月 1 日
漏洞修复：
- 修复了
hardlink=n时archive-copy在增量/差异备份中失败的问题。此情况下pg_xlog路径不存在，必须先创建。（由 Michael Renner 报告。） - 修复了异步归档中
archive-max-mb达到上限时archive-push未正确返回 0 的问题；同时将异步检查移到传输之后，以避免重复删除停止文件。新增了此情况的单元测试，并改进了错误消息，使用户更清楚地了解出错原因。（由 Michael Renner 报告。） - 修复了一个锁定问题，该问题可能允许对同一
stanza同时执行多个相同类型的操作。此问题在数据完整性方面似乎无害，但在归档时会引起虚假错误，并可能导致备份/恢复出错。（由 Michael Renner 报告。）
新功能：
- 允许在校验和匹配的情况下归档重复 WAL 段，这对某些恢复场景是必要的。
- 允许在
pg_backrest.conf中使用#字符进行注释/禁用。仅当#位于行首时才生效。（由 Michael Renner 建议。） - 改进了
pg_start_backup()之前的日志输出，当备份在等待检查点时输出更为明确。（由 Michael Renner 建议。） - 各命令行为和日志修复。（由 Michael Renner 审核，Michael Renner 建议。）
改进：
- 将
JSON模块替换为随核心 Perl 一起发布的JSON::PP。
文档漏洞修复：
- 各类帮助文档修复。（由 Michael Renner 审核，Michael Renner 报告。）
v0.65 版本说明
改进的续传与恢复日志、紧凑恢复
发布于 2015 年 5 月 11 日
漏洞修复：
- 修复了使用相对路径运行恢复时
recovery.conf中未写入绝对路径的问题。
新功能：
- 改进了续传支持。续传的文件会被检查以确保未被修改，
manifest保存频率更高，以在备份进行时保留校验和。新增了更多单元测试以验证各续传场景。 - 续传现在是可选的，可通过
resume设置或命令行的--no-resume禁用。 - 恢复时的
info级别消息更加详尽。此前大部分恢复消息为debug级别，日志中输出内容有限。 - 新增
tablespace设置，允许将表空间恢复到pg_tblspc路径中，产生紧凑型恢复，便于开发、测试等场景使用。目前此类恢复无法再次备份，因为 pgBackRest 要求pg_tblspc路径中只能有链接。
v0.61 版本说明
非压缩远程目标漏洞修复
发布于 2015 年 4 月 21 日
漏洞修复：
- 修复了将大型高可压缩文件复制到非压缩远程目标时可能出现的缓冲错误。该错误在解压代码中被检测到并导致备份失败，而非产生数据损坏，因此不应影响使用旧版本成功完成的备份。
v0.60 版本说明
更好的版本支持与 WAL 改进
发布于 2015 年 4 月 19 日
漏洞修复：
- 修复了推送重复 WAL 段不产生错误的问题。此前仅在禁用校验和时有效。
新功能：
- 使用数据库系统 ID 确保归档中所有 WAL 均来自同一集群，有助于防止将多个集群的 WAL 发送到同一归档的配置错误。
测试套件新功能：
- 回归测试支持追溯至 PostgreSQL 8.3。
v0.50 版本说明
恢复功能及更多改进
发布于 2015 年 3 月 25 日
漏洞修复：
- 修复了校验和问题，现在校验和可以在正常备份和续传备份中正常工作。校验和与校验和
delta在功能上应该分离，这简化了许多逻辑。Issue #28 已为校验和delta创建。 - 修复了可能从类型或前序备份不匹配的中止备份中续传的问题。
新功能：
- 新增恢复功能。
- 所有选项现在均可在命令行上设置，
pg_backrest.conf成为可选。 - 压缩/解压现在在非线程模式下执行，校验和/大小在流中计算，文件校验和不再是可选项。
- 新增
--no-start-stop选项，允许在 PostgreSQL 关闭时进行备份。如果postmaster.pid存在，则需要--force才能运行备份（但如果 PostgreSQL 正在运行，可能会创建不一致的备份）。此选项主要为单元测试目的而添加，但在实际环境中也可能有应用场景。 - 为
backup.manifest添加校验和，以检测损坏或被修改的manifest文件。 latest链接始终指向最后一次备份，便于使用并简化恢复操作。
测试套件新功能：
- 在各方面新增了更全面的单元测试。
v0.30 版本说明
核心重构与单元测试
发布于 2014 年 10 月 5 日
文档新功能：
- 新增了亟需的文档。
测试套件新功能：
- 对所有基本操作进行了相当全面的单元测试。当然，单元测试方面总是还有更多工作可做。
v0.19 版本说明
改进的错误报告/处理
发布于 2014 年 5 月 13 日
漏洞修复：
- 发现并修复了一个严重漏洞：
file_copy()被默认设置为忽略错误。file_exists()中也存在一个问题，会导致在文件实际存在时测试失败。两者共同作用，理论上可能在无任何错误提示的情况下产生损坏的备份，但概率极低。
v0.18 版本说明
归档缺失时返回软错误
发布于 2014 年 4 月 13 日
漏洞修复：
- 当归档文件缺失时，
archive-get命令现在返回 1，以区别于硬错误（SSH 连接失败、文件复制错误等），让 PostgreSQL 知道归档流已正常终止。但需注意，这并未考虑归档流中可能存在空洞的情况。（由 Stephen Frost 报告。）
v0.17 版本说明
归档目录无法删除时发出警告
发布于 2014 年 4 月 3 日
漏洞修复：
- 如果应为空的归档目录无法被删除，之前 pgBackRest 会抛出错误。目前有一个更好的修复方案正在开发中，暂时将其改为警告以允许处理继续。此问题影响了备份流程——在某些情况下，如果第一个归档文件与第二个归档文件在不同目录中，最后的归档文件可能无法被推送。
v0.16 版本说明
SSH 会话添加 RequestTTY=yes
发布于 2014 年 4 月 1 日
漏洞修复：
- 在 SSH 会话中添加了
RequestTTY=yes，以防止随机挂起问题。
v0.15 版本说明
新增 archive-get
发布于 2014 年 3 月 29 日
新功能：
- 新增
archive-get功能，辅助恢复操作。 - 新增启动备份时强制执行检查点的选项：
start-fast=y。
v0.11 版本说明
小型修复
发布于 2014 年 3 月 26 日
漏洞修复：
- 移除了数据库 SSH 连接上的
master_stderr_discard选项。此前偶发挂起问题，可能与文件代码中最初发现的问题相关。（由 Stephen Frost 报告。） - 将
backup和expire命令的锁文件冲突级别改为ERROR。此前由于从归档锁代码复制粘贴，误设为DEBUG。
v0.10 版本说明
备份与归档功能可用
发布于 2014 年 3 月 5 日
新功能：
- 暂无恢复功能，但备份目录是一致的 PostgreSQL 数据目录。需要手动解压文件，或在备份时关闭压缩。在 ZFS（或类似）文件系统上使用非压缩备份是一个好选择，可以通过快照在本地恢复备份，用于创建逻辑备份或进行点数据恢复。
- 归档为单线程。在多太字节数据库（高写入量）上，这并未造成问题。建议使用较大的 WAL 卷，或配合大容量卷使用异步选项。
- 备份为多线程，但
Net::OpenSSH库似乎并非 100% 线程安全，偶尔会在某个线程上发生死锁。现有一个整体进程超时机制，通过终止进程来解决此问题——是的，这很粗糙。 - 任何续传备份都会丢失校验和。多次续传时只有最终备份会记录校验和。之前备份的校验和可以正确记录，全量备份将重置所有内容。
backup.manifest正在以Storable格式写入，因为Config::IniFile似乎不能很好地处理大文件。理想情况下希望将这些文件保存为人类可读的文本格式。
文档新功能：
- 完全没有文档（代码之外）。嗯，除了这份发布说明。
这个页面对您有帮助吗？
感谢反馈，我们会据此改进这篇文档。
哪里没有解决？（可选）