SFTPGo存储后端深度解析本地磁盘、S3、Google Cloud Storage和Azure Blob如何接入【免费下载链接】sftpgoFull-featured and highly configurable SFTP, HTTP/S, FTP/S and WebDAV server - S3, Google Cloud Storage, Azure Blob项目地址: https://gitcode.com/gh_mirrors/sf/sftpgoSFTPGo 是一款功能完整、高度可配置的开源 SFTP/FTP/WebDAV/HTTP 文件服务器其核心亮点之一就是灵活多样的存储后端同一台 SFTP 服务器可以同时把不同用户映射到本地磁盘、S3 对象存储、Google Cloud Storage 或 Azure Blob而客户端感知不到任何差异。本文带你快速搞懂 SFTPGo 存储后端的架构设计与四种主要后端的接入方法。统一抽象一个接口多种后端SFTPGo 之所以能无缝切换存储后端关键在于internal/vfs/虚拟文件系统层定义了统一的Fs接口所有后端都必须实现同一套文件操作读、写、重命名、删除、列目录等。接口定义见 internal/vfs/vfs.go。每个后端在用户数据中由provider字段区分配置结构体则定义在 internal/vfs/filesystem.go 中后端Provider 名称对应源码本地磁盘LocalFilesystemProviderinternal/vfs/osfs.goS3 对象存储S3FilesystemProviderinternal/vfs/s3fs.goGoogle Cloud StorageGCSFilesystemProviderinternal/vfs/gcsfs.goAzure BlobAzureBlobFilesystemProviderinternal/vfs/azblobfs.go本地加密磁盘CryptedFilesystemProviderinternal/vfs/cryptfs.go当用户发起连接时User.GetFilesystem会根据provider字段选择并构造对应的后端实例逻辑见 internal/dataprovider/user.go。后端一本地磁盘最常用本地文件系统是 SFTPGo 的默认后端也是新手最熟悉的一种。它只需要两样东西用户根目录Home Dir把用户关在哪个目录下OSConfig设置文件/目录的默认属主、属组和权限避免上传文件后权限混乱。配置示例sftpgo.json中用户条目完整示例见 sftpgo.json{ fs: 1, home_dir: /srv/uploads/alice }fs: 1即LocalFilesystemProvider。除此之外SFTPGo 还提供了CryptFsinternal/vfs/cryptfs.go把本地文件以加密形式落盘——只需要一个高强度 passphrase适合在共享服务器上存放敏感数据。后端二S3 对象存储兼容 MinIO、Ceph 等这是云部署场景中使用率最高的后端。SFTPGo 通过标准 AWS SDK 接入任何S3 兼容存储官方文档中明确支持 AWS S3实践中 MinIO、Ceph、Google Cloud StorageS3 API、Backblaze B2 等同样可以工作。核心配置项internal/vfs/vfs.go 中的S3FsConfigbucket存储桶名称必填region区域例如us-east-1endpoint自定义端点——接入 MinIO 或 B2 时必填access_key / access_secret访问密钥access_secret会自动用 KMS 加密后存储见下文密钥安全key_prefix在桶内划出子前缀相当于把多个用户隔离到不同子目录storage_class存储类型如STANDARD、GLACIERupload_part_size / upload_concurrency分片大小与并发数大文件传输性能的关键调节旋钮sse_customer_key客户侧加密密钥SSE-C。 小贴士S3 后端对象不可随机改写SFTPGo 对此做了透明处理——上传完成后才提交对象并支持条件断点续传IsConditionalUploadResumeSupported对 SFTP 客户端完全无感。后端三Google Cloud StorageGCS 后端配置在GCSFsConfiginternal/vfs/vfs.go必填项只有bucket另有两类凭证方式二选一AutomaticCredentials 1不填任何凭据自动使用 Google 元数据服务凭证——部署在 GCP 虚拟机或 Kubernetes配合 Workload Identity上时最省心Credentials 字段填入 Service Account 的 JSON 凭据私钥SFTPGo 会自动将其加密保存。同样支持key_prefix隔离用户、storage_class与acl控制对象属性以及upload_part_size调节上传性能。实现细节在 internal/vfs/gcsfs.go。后端四Azure Blob StorageAzure Blob 后端对应AzBlobFsConfiginternal/vfs/vfs.go有两种鉴权方式Account Name Account Key传统账号密钥方式SAS URL共享访问签名 URL权限更细、可设过期时间推荐生产使用。可选项同样丰富endpoint支持 Azure 中国或主权云端点、access_tier选择Hot/Cool/Archive访问层级以优化成本还有upload_part_size、download_part_size等分片并发参数。实现见 internal/vfs/azblobfs.go。密钥安全KMS 自动加密所有云后端都会涉及敏感凭据S3 的 secret key、GCS 的私钥、Azure 的 account key 等。SFTPGo 内置 KMSKey Management Serviceinternal/kms/kms.go明文密钥在保存前自动加密ValidateAndEncryptCredentials见 internal/vfs/vfs.go数据库里只存密文支持内置密钥、本地密钥文件、KMS 插件等多种密钥来源界面展示时通过HideConfidentialData自动打码避免泄漏。这意味着你可以放心地把 SFTPGo 配置备份或迁移而不必担心云凭据明文躺在配置文件里。进阶玩法虚拟文件夹SFTPGo 还支持一个虚拟路径映射多个后端。例如用户家目录/local走本地磁盘、/archive直接映射到 S3 桶客户端进入不同目录时自动切换后端GetFilesystemForPath见 internal/dataprovider/user.go。配合配额、IP 白名单、事件规则等能力一套 SFTPGo 就能同时服务本地备份与云端归档两种业务。总结如何选择存储后端场景推荐后端理由内网文件共享、备份本地磁盘 / CryptFs零依赖、性能最高加密落盘可保敏感数据私有对象存储S3MinIO/Ceph通过 endpoint 即插即用公有云 AWS 生态S3官方一等支持分片上传稳定GCP 应用GCS自动凭证免维护Azure 环境Azure BlobSAS URL 权限可控无论你使用哪种后端SFTPGo 都通过同一套Fs接口提供服务端能力配额统计、断点续传、目录级权限、传输事件钩子等全部对云存储生效。这也是 SFTPGo 区别于普通 sftp-server 的关键——把传统文件服务器能力平移到对象存储之上。想动手尝试克隆仓库后即可参考 sftpgo.json 修改fs字段与对应 config 区块一分钟切换后端git clone https://gitcode.com/gh_mirrors/sf/sftpgo【免费下载链接】sftpgoFull-featured and highly configurable SFTP, HTTP/S, FTP/S and WebDAV server - S3, Google Cloud Storage, Azure Blob项目地址: https://gitcode.com/gh_mirrors/sf/sftpgo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 SFTPGo存储后端深度解析：本地磁盘、S3、Google Cloud Storage和Azure Blob如何接入
SFTPGo存储后端深度解析本地磁盘、S3、Google Cloud Storage和Azure Blob如何接入【免费下载链接】sftpgoFull-featured and highly configurable SFTP, HTTP/S, FTP/S and WebDAV server - S3, Google Cloud Storage, Azure Blob项目地址: https://gitcode.com/gh_mirrors/sf/sftpgoSFTPGo 是一款功能完整、高度可配置的开源 SFTP/FTP/WebDAV/HTTP 文件服务器其核心亮点之一就是灵活多样的存储后端同一台 SFTP 服务器可以同时把不同用户映射到本地磁盘、S3 对象存储、Google Cloud Storage 或 Azure Blob而客户端感知不到任何差异。本文带你快速搞懂 SFTPGo 存储后端的架构设计与四种主要后端的接入方法。统一抽象一个接口多种后端SFTPGo 之所以能无缝切换存储后端关键在于internal/vfs/虚拟文件系统层定义了统一的Fs接口所有后端都必须实现同一套文件操作读、写、重命名、删除、列目录等。接口定义见 internal/vfs/vfs.go。每个后端在用户数据中由provider字段区分配置结构体则定义在 internal/vfs/filesystem.go 中后端Provider 名称对应源码本地磁盘LocalFilesystemProviderinternal/vfs/osfs.goS3 对象存储S3FilesystemProviderinternal/vfs/s3fs.goGoogle Cloud StorageGCSFilesystemProviderinternal/vfs/gcsfs.goAzure BlobAzureBlobFilesystemProviderinternal/vfs/azblobfs.go本地加密磁盘CryptedFilesystemProviderinternal/vfs/cryptfs.go当用户发起连接时User.GetFilesystem会根据provider字段选择并构造对应的后端实例逻辑见 internal/dataprovider/user.go。后端一本地磁盘最常用本地文件系统是 SFTPGo 的默认后端也是新手最熟悉的一种。它只需要两样东西用户根目录Home Dir把用户关在哪个目录下OSConfig设置文件/目录的默认属主、属组和权限避免上传文件后权限混乱。配置示例sftpgo.json中用户条目完整示例见 sftpgo.json{ fs: 1, home_dir: /srv/uploads/alice }fs: 1即LocalFilesystemProvider。除此之外SFTPGo 还提供了CryptFsinternal/vfs/cryptfs.go把本地文件以加密形式落盘——只需要一个高强度 passphrase适合在共享服务器上存放敏感数据。后端二S3 对象存储兼容 MinIO、Ceph 等这是云部署场景中使用率最高的后端。SFTPGo 通过标准 AWS SDK 接入任何S3 兼容存储官方文档中明确支持 AWS S3实践中 MinIO、Ceph、Google Cloud StorageS3 API、Backblaze B2 等同样可以工作。核心配置项internal/vfs/vfs.go 中的S3FsConfigbucket存储桶名称必填region区域例如us-east-1endpoint自定义端点——接入 MinIO 或 B2 时必填access_key / access_secret访问密钥access_secret会自动用 KMS 加密后存储见下文密钥安全key_prefix在桶内划出子前缀相当于把多个用户隔离到不同子目录storage_class存储类型如STANDARD、GLACIERupload_part_size / upload_concurrency分片大小与并发数大文件传输性能的关键调节旋钮sse_customer_key客户侧加密密钥SSE-C。 小贴士S3 后端对象不可随机改写SFTPGo 对此做了透明处理——上传完成后才提交对象并支持条件断点续传IsConditionalUploadResumeSupported对 SFTP 客户端完全无感。后端三Google Cloud StorageGCS 后端配置在GCSFsConfiginternal/vfs/vfs.go必填项只有bucket另有两类凭证方式二选一AutomaticCredentials 1不填任何凭据自动使用 Google 元数据服务凭证——部署在 GCP 虚拟机或 Kubernetes配合 Workload Identity上时最省心Credentials 字段填入 Service Account 的 JSON 凭据私钥SFTPGo 会自动将其加密保存。同样支持key_prefix隔离用户、storage_class与acl控制对象属性以及upload_part_size调节上传性能。实现细节在 internal/vfs/gcsfs.go。后端四Azure Blob StorageAzure Blob 后端对应AzBlobFsConfiginternal/vfs/vfs.go有两种鉴权方式Account Name Account Key传统账号密钥方式SAS URL共享访问签名 URL权限更细、可设过期时间推荐生产使用。可选项同样丰富endpoint支持 Azure 中国或主权云端点、access_tier选择Hot/Cool/Archive访问层级以优化成本还有upload_part_size、download_part_size等分片并发参数。实现见 internal/vfs/azblobfs.go。密钥安全KMS 自动加密所有云后端都会涉及敏感凭据S3 的 secret key、GCS 的私钥、Azure 的 account key 等。SFTPGo 内置 KMSKey Management Serviceinternal/kms/kms.go明文密钥在保存前自动加密ValidateAndEncryptCredentials见 internal/vfs/vfs.go数据库里只存密文支持内置密钥、本地密钥文件、KMS 插件等多种密钥来源界面展示时通过HideConfidentialData自动打码避免泄漏。这意味着你可以放心地把 SFTPGo 配置备份或迁移而不必担心云凭据明文躺在配置文件里。进阶玩法虚拟文件夹SFTPGo 还支持一个虚拟路径映射多个后端。例如用户家目录/local走本地磁盘、/archive直接映射到 S3 桶客户端进入不同目录时自动切换后端GetFilesystemForPath见 internal/dataprovider/user.go。配合配额、IP 白名单、事件规则等能力一套 SFTPGo 就能同时服务本地备份与云端归档两种业务。总结如何选择存储后端场景推荐后端理由内网文件共享、备份本地磁盘 / CryptFs零依赖、性能最高加密落盘可保敏感数据私有对象存储S3MinIO/Ceph通过 endpoint 即插即用公有云 AWS 生态S3官方一等支持分片上传稳定GCP 应用GCS自动凭证免维护Azure 环境Azure BlobSAS URL 权限可控无论你使用哪种后端SFTPGo 都通过同一套Fs接口提供服务端能力配额统计、断点续传、目录级权限、传输事件钩子等全部对云存储生效。这也是 SFTPGo 区别于普通 sftp-server 的关键——把传统文件服务器能力平移到对象存储之上。想动手尝试克隆仓库后即可参考 sftpgo.json 修改fs字段与对应 config 区块一分钟切换后端git clone https://gitcode.com/gh_mirrors/sf/sftpgo【免费下载链接】sftpgoFull-featured and highly configurable SFTP, HTTP/S, FTP/S and WebDAV server - S3, Google Cloud Storage, Azure Blob项目地址: https://gitcode.com/gh_mirrors/sf/sftpgo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考