s3fs - 云端在线

程序：

您的姓名

S3FS - 由 Amazon S3 支持的基于 FUSE 的文件系统

概要

安装
s3fs 桶[：/路径] 挂载点 [选项]

卸载
卸除 挂载点

效用 模式 ( 去掉 间断 多部分 上传 对象 )
s3fs -u 桶

商品描述

s3fs 是一个 FUSE 文件系统，允许您将 Amazon S3 存储桶挂载为本地
文件系统。 它以本机和透明的方式将文件存储在 S3 中（即，您可以使用其他
访问相同文件的程序）。

认证

s3fs 密码文件具有这种格式（如果您只有一组
证书）：
访问密钥 ID:秘密访问密钥

如果您有多个凭据，也可以识别此语法：
桶名:访问密钥 ID:秘密访问密钥

密码文件可以存储在两个位置：
/etc/passwd-s3fs [0640]
$HOME/.passwd-s3fs [0600]

配置

一般 选项
-h - 帮帮我
打印帮助

- 版
印刷版

-f FUSE 前台选项 - 不要作为守护程序运行。

-s FUSE 单线程选项（禁用多线程操作）

安装 选项
所有 s3fs 选项必须以“opt”的形式给出：
=

-o default_acl（默认=“私有”）
默认罐头 acl 应用于所有写入的 S3 对象，例如，“public-read”。
任何创建的文件都将具有此罐头 acl。 任何更新的文件也会有这个
罐装acl应用！

-o 重试（默认=“2”）
重试失败的 S3 事务的次数。

-o use_cache (default="" 表示禁用)
用于本地文件缓存的本地文件夹。

-o del_cache - 删除本地文件缓存
在 s3fs 启动和退出时删除本地文件缓存。

-o storage_class（默认为标准）
存储具有指定存储类的对象。 此选项替换旧选项
使用_rrs。 可能的值：standard、standard_ia 和 reduction_redundancy。

-o use_rrs（默认为禁用）
使用亚马逊的低冗余存储。 不能指定此选项
使用_sse。 （可以为旧版本指定 use_rrs=1）此选项已被替换为
新的 storage_class 选项。

-o use_sse（默认为禁用）
指定三种类型的亚马逊服务器站点加密：SSE-S3、SSE-C 或 SSE-KMS。 上证所-
S3 使用 Amazon S3 管理的加密密钥，SSE-C 使用客户提供的加密
密钥，SSE-KMS 使用您在 AWS KMS 中管理的主密钥。 您可以指定
"use_sse" 或 "use_sse=1" 启用 SSE-S3 类型（use_sse=1 是旧类型参数）。
设置SSE-C的情况下，可以指定“use_sse=custom”、“use_sse=custom”：
密钥文件路径>”或“use_sse= “（只要
指定的是旧类型参数）。 您可以使用“c”来表示“自定义”的简称。 习俗
密钥文件必须是 600 权限。 文件可以有几行，每一行是一行
SSE-C 密钥。 文件中的第一行用作客户提供的加密密钥
上传和更改标题等。如果第一行之后有一些键，那些
用于下载由非第一密钥加密的对象。 这样，你可以
将所有 SSE-C 密钥保存在文件中，即 SSE-C 密钥历史记录。 如果您指定
"custom"("c") 没有文件路径，您需要通过 load_sse_c 选项设置自定义键或
AWSSSECKEYS 环境。（AWSSSECKEYS 环境有一些带有“：”的 SSE-C 密钥
分隔符。）此选项用于决定 SSE 类型。 所以如果你不
想在上传时加密对象，但您需要在
下载时，您可以使用 load_sse_c 选项代替此选项。 用于设置 SSE-
KMS，指定“use_sse=kmsid”或“use_sse=kmsid”： ”。你可以使用“k”来表示
简称“kmsid”。 如果您指定 SSE-KMS 类型与您的在 AWS KMS 中，您
可以在“kmsid:”（或“k:”）之后设置。 如果仅指定“kmsid”("k")，则需要
设置 AWSSSEKMSID 环境的值是. 你必须小心
您不能使用与 EC2 区域不同的 KMS id。

-o load_sse_c - 指定 SSE-C 密钥
指定自定义提供的加密密钥文件路径进行解密
下载。 如果您在上传时使用自定义提供的加密密钥，您
用“use_sse=custom”指定。 文件有多行，一行代表一个自定义
钥匙。 这样您就可以将所有 SSE-C 密钥保存在文件中，即 SSE-C 密钥历史记录。
AWSSSECKEYS 环境与此文件内容相同。

-o passwd_file（默认=“”）
指定密码文件的路径，该路径优先于
$HOME/.passwd-s3fs 和 /etc/passwd-s3fs 中的密码

-o ahbe_conf (default="" 表示禁用)
该选项指定配置文件路径哪个文件是附加的HTTP
文件（对象）扩展名的标头。
配置文件格式如下：
-----------
line = [文件后缀] HTTP-header [HTTP-values]
file suffix = file(object) 后缀，如果此字段为空，则表示“*”（所有
目的）。
HTTP-header = 附加的 HTTP 头名称
HTTP-values = 附加 HTTP 标头值
-----------
示例：
-----------
.gz 内容编码 gzip
.Z 内容编码压缩
X-S3FS-MYHTTPHEAD 我的价值
-----------
示例配置文件上传到“test”目录。 如果你指定这个
设置“内容编码”HTTP 标头的选项，请注意 RFC 2616。

-o public_bucket（默认=“”，表示禁用）
设置为 1 时匿名挂载公共存储桶，忽略 $HOME/.passwd-s3fs 和
/etc/passwd-s3fs 文件。

-o connect_timeout（默认=“300”秒）
在放弃之前等待连接的时间。

-o readwrite_timeout（默认=“60”秒）
在放弃之前等待读/写活动之间的时间。

-o max_stat_cache_size（默认=“1000”个条目（大约 4MB））
统计缓存中的最大条目数

-o stat_cache_expire（默认为无过期）
为统计缓存中的条目指定过期时间（秒）

-o enable_noobj_cache（默认为禁用）
为不存在的对象启用缓存条目。 s3fs 总是要检查
当s3fs做一些事情时，文件（或子目录）是否存在于对象（路径）下
命令，因为 s3fs 已识别出一个不存在且有文件的目录
或自身下的子目录。 它增加了 ListBucket 请求并使
表现不好。 你可以指定这个选项来提高性能，s3fs 记住了
stat 缓存对象（文件或目录）不存在。

-o no_check_certificate（默认情况下禁用此选项）
不检查 ssl 证书。 服务器证书不会被检查
可用的证书颁发机构。

-o nodnscache - 禁用 dns 缓存。
s3fs 始终使用 dns 缓存，此选项使 dns 缓存禁用。

-o nosscache - 禁用 ssl 会话缓存。
s3fs 始终使用 ssl 会话缓存，此选项使 ssl 会话缓存禁用。

-o multireq_max（默认=“20”）
列出对象的最大并行请求数。

-o parallel_count（默认=“5”）
上传大对象的并行请求数。 s3fs 上传大
对象（默认：超过 20MB）通过多部分 post 请求，并发送并行请求。
此选项限制 s3fs 一次请求的并行请求计数。 这是
需要根据 CPU 和网络带宽设置此值。 这个选项是
与 fd_page_size 选项相关并影响它。

-o fd_page_size(default="52428800"(50MB))
每个文件描述符的内部管理页面大小的数量。 对于延迟
s3fs 读写，s3fs 管理与对象分离的页面。
每个页面都有一个数据已加载（或尚未加载）的状态。 这个
当您没有性能问题时，不应更改选项。 这个
值由 parallel_count 和 multipart_size 自动更改
值（fd_page_size 值 = parallel_count * multipart_size）。

-o multipart_size（默认=“10”（10MB））
分段上传请求中分段大小的数量。 默认大小为
10MB(10485760byte)，这个值是最小大小。 指定 MB 数及以上
10(MB)。 此选项与 fd_page_size 选项相关并影响它。

-o 网址（默认 =http://s3.amazonaws.com")
设置用于访问 Amazon S3 的 url。 如果你想使用HTTPS，那么你可以设置
网址=https://s3.amazonaws.com

-o 端点（默认=“us-east-1”）
设置要使用的端点。 如果未指定此选项，s3fs 将使用“us-east-1”
区域为默认值。 如果 s3fs 无法连接到指定的区域
这个选项，s3fs 无法运行。 但是如果你不指定这个选项，并且如果你
默认区域无法连接，s3fs会重试自动连接
到其他地区。 所以 s3fs 可以知道正确的区域名称，因为 s3fs 可以
在 S3 服务器的错误中找到它。

-o sigv2（默认为签名版本 4）
通过签名版本 2 设置签署 AWS 请求。

-o mp_umask（默认为“0000”）
为挂载点目录设置 umask。 如果没有设置 allow_other 选项，s3fs
只允许所有者访问挂载点。 在相反的情况下 s3fs
默认允许所有用户访问。 但是如果你设置了allow_other
这个选项，你可以通过这个控制挂载点的权限
像umask这样的选项。

-o nomultipart - 禁用分段上传

-o enable_content_md5（默认为禁用）
通过 content-md5 标头验证没有 multipart 的上传数据。 启用发送
上传没有分段发布的对象时的“Content-MD5”标头。 如果这
选项已启用，它在上传时对s3fs的性能有一些影响
小物体。 因为s3fs在上传大对象的时候总是会检查MD5，这个
选项不会影响大对象。

-o iam_role（默认为无角色）
设置将从实例元数据提供凭证的 IAM 角色。

-o noxmlns - 禁用注册 xml 名称空间。
禁用注册 xml 名称空间以响应 ListBucketResult 和
ListVersionsResult 等。默认名称空间是从
"http://s3.amazonaws.com/doc/2006-03-01"。现在不应指定此选项，
因为 s3fs 在 v1.66 之后会自动查找 xmlns。

-o nocopyapi - 用于其他不完全兼容的对象存储。
对于分布式对象存储，它是没有 PUT 的兼容性 S3 API（复制
api）。 如果设置此选项，s3fs 不会将 PUT 与“x-amz-copy-source”（复制
api）。 由于此选项使流量增加了 2-3 倍，因此我们不建议
本。

-o norenameapi - 用于其他不完全兼容的对象存储。
对于分布式对象存储，它是没有 PUT 的兼容性 S3 API（复制
api）。 此选项是 nocopyapi 选项的子集。 nocopyapi 选项没有
对所有命令使用 copy-api（例如 chmod、chown、touch、mv 等），但此选项
不将 copy-api 仅用于重命名命令（例如 mv）。 如果指定了这个选项
使用 nocopapi，s3fs 会忽略它。

-o use_path_request_style（使用旧 API 调用风格）
启用与不支持虚拟主机请求的类似 S3 的 API 的兼容性
样式，通过使用较旧的路径请求样式。

-o dbglevel（默认=“暴击”）
设置调试消息级别。 将值设置为 crit(critical), err(error),
警告（警告），信息（信息）到调试级别。 默认调试级别至关重要。
如果 s3fs 使用“-d”选项运行，则调试级别是设置信息。 当 s3fs 捕获
信号SIGUSR2，调试级别是bumpup。

-o curldbg - 放置 curl 调试消息
指定此选项时，放置来自 libcurl 的调试消息。

保险丝/安装座 配置

支持“man mount”中描述的大多数通用挂载选项（ro、rw、suid、
nosuid、dev、nodev、exec、noexec、atime、noatime、sync async、dirsync）。 文件系统是
默认情况下使用“-onodev,nosuid”挂载，只能由特权覆盖
用户。

可以指定许多 FUSE 特定的安装选项。 例如allow_other。 看
全套的 FUSE README。

附注

最大文件大小=64GB（受 s3fs 限制，不受亚马逊限制）。

如果通过“use_cache”选项启用，s3fs 会自动维护文件的本地缓存
在 use_cache 指定的文件夹中。 每当 s3fs 需要在 S3 上读取或写入文件时，
它首先将整个文件本地下载到 use_cache 指定的文件夹中，然后
对其进行操作。 当调用 fuse_release() 时，s3fs 会重新上传文件到 S3
已经变了。 s3fs 使用 md5 校验和来最小化来自 S3 的下载。

use_cache 指定的文件夹只是本地缓存。 它可以随时删除。
s3fs 根据需要重建它。

本地文件缓存通过计算和比较 md5 校验和（ETag HTTP 标头）来工作。

s3fs 杠杆 /etc/mime.types 根据文件名“猜测”“正确”的内容类型
延期。 这意味着您可以将网站复制到 S3 并直接从 S3 提供服务
具有正确的内容类型！

使用 onworks.net 服务在线使用 s3fs