pgBackRest SFTP存储配置中的权限问题解析
问题背景
在使用pgBackRest进行PostgreSQL数据库备份时,选择SFTP作为存储后端是一种常见的做法。然而在实际配置过程中,用户可能会遇到"libssh2 error [-31]: sftp error [3]"这样的权限错误。本文将以一个典型场景为例,深入分析该问题的成因和解决方案。
错误现象分析
当用户尝试执行pgbackrest --stanza=demo stanza-create
命令时,系统返回错误信息:
ERROR: [041]: unable to get info for path/file '/var/lib/pgbackrest/archive/demo/archive.info': libssh2 error [-31]: sftp error [3]
通过调试信息可以确认,错误代码3对应的是LIBSSH2_FX_PERMISSION_DENIED,即权限拒绝错误。这表明SFTP用户没有足够的权限访问指定的存储路径。
根本原因
-
目录所有权问题:检查
/var/lib/pgbackrest
目录发现,该目录及其子目录的所有者和组均为postgres用户:drwxr-x--- 3 postgres postgres 4096 Aug 21 08:32 archive drwxr-x--- 3 postgres postgres 4096 Aug 21 08:32 backup
-
SFTP用户权限不足:配置中指定的SFTP用户(pgbackrest)不属于postgres组,且目录权限设置为750(rwxr-x---),导致SFTP用户无法访问该目录。
解决方案
方案一:创建共享用户组
-
创建一个新的用户组,例如
backupgroup
:sudo groupadd backupgroup
-
将postgres和pgbackrest用户都加入该组:
sudo usermod -aG backupgroup postgres sudo usermod -aG backupgroup pgbackrest
-
修改存储目录的组所有权和权限:
sudo chown -R postgres:backupgroup /var/lib/pgbackrest sudo chmod -R 775 /var/lib/pgbackrest
方案二:直接修改目录权限
如果安全要求允许,可以直接放宽目录权限:
sudo chmod -R 777 /var/lib/pgbackrest
注意:这种方法会降低安全性,仅建议在测试环境中使用。
配置验证
完成权限调整后,可以通过以下方式验证配置是否生效:
-
使用SFTP用户身份测试目录访问:
sudo -u pgbackrest ls -l /var/lib/pgbackrest
-
重新执行stanza创建命令:
sudo -u postgres pgbackrest --stanza=demo stanza-create
技术要点总结
-
SFTP权限模型:SFTP协议继承自SSH,其权限检查基于Linux系统的文件权限设置。
-
pgBackRest的工作机制:当使用SFTP存储时,pgBackRest会通过libssh2库建立SFTP连接,所有文件操作都受限于SFTP用户的权限。
-
最佳实践:
- 为备份操作创建专用用户和组
- 遵循最小权限原则分配目录权限
- 定期审计备份目录的权限设置
-
调试技巧:
- 启用SFTP服务器的详细日志(通过配置
Subsystem sftp /usr/lib/openssh/sftp-server -l VERBOSE
) - 检查系统日志(/var/log/auth.log)获取详细的认证信息
- 启用SFTP服务器的详细日志(通过配置
后续操作建议
成功配置SFTP存储后,pgBackRest会将备份文件存储在配置的repo路径下(/var/lib/pgbackrest)。备份文件会按照以下结构组织:
- archive/:存放WAL归档日志
- backup/:存放基础备份
建议定期检查备份文件的完整性和可用性,确保在需要恢复时能够正常工作。
HunyuanImage-3.0
HunyuanImage-3.0 统一多模态理解与生成,基于自回归框架,实现文本生成图像,性能媲美或超越领先闭源模型00- DDeepSeek-V3.2-ExpDeepSeek-V3.2-Exp是DeepSeek推出的实验性模型,基于V3.1-Terminus架构,创新引入DeepSeek Sparse Attention稀疏注意力机制,在保持模型输出质量的同时,大幅提升长文本场景下的训练与推理效率。该模型在MMLU-Pro、GPQA-Diamond等多领域公开基准测试中表现与V3.1-Terminus相当,支持HuggingFace、SGLang、vLLM等多种本地运行方式,开源内核设计便于研究,采用MIT许可证。【此简介由AI生成】Python00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~0369Hunyuan3D-Part
腾讯混元3D-Part00ops-transformer
本项目是CANN提供的transformer类大模型算子库,实现网络在NPU上加速计算。C++095AI内容魔方
AI内容专区,汇集全球AI开源项目,集结模块、可组合的内容,致力于分享、交流。02Spark-Chemistry-X1-13B
科大讯飞星火化学-X1-13B (iFLYTEK Spark Chemistry-X1-13B) 是一款专为化学领域优化的大语言模型。它由星火-X1 (Spark-X1) 基础模型微调而来,在化学知识问答、分子性质预测、化学名称转换和科学推理方面展现出强大的能力,同时保持了强大的通用语言理解与生成能力。Python00GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00- HHowToCook程序员在家做饭方法指南。Programmer's guide about how to cook at home (Chinese only).Dockerfile09
- PpathwayPathway is an open framework for high-throughput and low-latency real-time data processing.Python00
最新内容推荐
项目优选









