您可以通过-h 选项来查看ossfs支持的设置参数。

命令格式

./ossfs -h

您需要在ossfs程序所在目录使用该命令,默认目录为/usr/local/bin/,以实际安装环境为准。

常用选项

ossfs是基于fuse用户态文件系统来实现的,所以除了ossfs自己的选项外,也支持fuse的选项。挂载存储空间(Bucket)时,您可以根据具体的业务场景,设置不同的启动选项。选项格式如下:
-o option_name[=option_value]  或者  -ooption_name[=option_value]
例如在挂载时指定uid和gid参数:
ossfs bucket_name mount_point -ourl=endpoint -ouid=uid -ogid=gid
ossfs常用选项如下:
  • url:用于指定存储空间的访问域名,格式为url=endpoint。当不指定具体的请求协议时,默认选择HTTP。

    示例:

    -ourl=oss-cn-hangzhou.aliyuncs.com
    -ourl=http://oss-cn-hangzhou.aliyuncs.com
    -ourl=https://oss-cn-hangzhou.aliyuncs.com
  • passwd_file:用于指定保存存储空间访问密钥的文件,默认为/etc/passwd-ossfs。这个文件的权限必须正确设置,当密钥文件为/etc/passwd-ossfs时,权限可设置为640;当密钥文件不为/etc/passwd-ossfs时,权限需要设置为600。密钥文件内容的格式为${bucket}:${access-key-id}:{access-key-secret}

    示例:

    echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs
    chmod 640 /etc/passwd-ossfs
    
    echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /passwd-path/passwd-ossfs
    chmod 600 /passwd-path/passwd-ossfs
    
    -opasswd_file=/passwd-path/passwd-ossfs
  • max_stat_cache_size:用于指定文件元数据的缓存空间可缓存多少个文件的元数据。单位是个,默认值为1000。当目录下文件比较多时,可以调整这个参数,加快ls的速度。如果要禁止使用元数据缓存,可以设置为0。
  • allow_other:赋予计算机上其他用户访问挂载目录的权限,但不包括目录内的文件。如果您要更改文件夹中的文件访问权限,请用chmod命令。该选项不需要设置选项值,如果需要启用,请直接添加-oallow_other选项。
  • dbglevel:用于设置日志信息的级别,支持日志信息级别为critical、error、warn、info和debug ,默认值为critical,例如需要开启info级别的日志,请添加-odbglevel=info选项。日志信息会写到系统日志中,例如在centos系统会写到/var/log/messages中。
  • -f:以前台方式而非守护进程方式运行ossfs,在前台模式下,日志会输出到终端屏幕。该参数一般用于调试问题时使用。
  • -d:用于打开日志信息,同时该选项也会传递到fuse。在ossfs里,该选项等效于-odbglevel=info

选项列表

无特别说明时,选项的格式均为-ooption_name=option_value-o option_name=option_value

  • ossfs选项列表
    选项名称 描述
    default_acl 指定往OSS写文件时设置的权限,默认设置为private。可选值为:
    • private:私有
    • public-read:公共读
    • public-read-write:公共读写
    关于ACL的更多说明请参见基于读写权限ACL的权限控制
    retries 指定请求失败后的重试次数,默认值为2。
    storage_class 指定往OSS写文件时设置的存储类型,默认设置为Standard。可选参数为:
    • Standard:标准存储
    • IA:低频访问存储
    • Archive:归档存储
    关于存储类型的更多详情请参见存储类型介绍
    public_bucket 指定用户通过匿名方式访问存储空间,该选项仅对ACL为public-read-write的存储空间有效。可选参数为:
    • 0:不使用匿名方式访问,默认设置为该项。
    • 1:使用匿名方式访问。
    passwd_file 用于指定保存存储空间访问密钥的文件,默认为/etc/passwd-ossfs
    connect_timeout 指定连接的超时时间,单位为秒,默认值为300秒。
    readwrite_timeout 指定读或者写请求的超时时间,单位为秒,默认值为60秒。
    max_stat_cache_size 指定文件元数据的缓存数量,单位为个,默认值为1000,约额外消耗4MB大小的空间。
    stat_cache_expire 指定文件元数据缓存的失效时间,默认不失效。
    no_check_certificate 对服务端的证书不做校验,仅在使用https协议时有效,默认开启证书校验。该选项无选项值,使用时请直接添加-ono_check_certificate选项。
    multireq_max 列举文件时,访问文件元信息时的最大的并发数,默认值为20。
    parallel_count 以分片模式上传大文件时,分片的并发数,默认值为5。
    multipart_size 以分片模式上传数据时分片的大小,单位是MB,默认值为10。该参数会影响最大支持的文件大小。分片模式上传时,最多的分片数为10000,默认值下,最大的支持文件为100G。如果需要支持更大的文件,需要根据需求调整这个值。
    url 指定存储空间的访问域名。
    mp_umask 用来设定挂载点的权限掩码,只有当allow_other选项设置后,该选项才生效,默认值为000。使用方法与umask命令使用方式一致。例如需要设置挂载点的权限为770,则增加-oallow_other -omp_umask=007;需要设置挂载点的权限为700,则增加-oallow_other -omp_umask=077
    enable_content_md5 进行上传操作时,是否需要设置CONTENT_MD5,默认不设置。该选项无选项值,使用时直接增加-oenable_content_md5选项。
    ram_role 使用ram_role方式访问OSS。当使用这个方式访问OSS时,会忽略掉密钥文件的AK(AccessKeyID)、SK(AccessKeySecret)参数。
    dbglevel 设置日志信息的级别,支持日志信息级别为critical、error、warn、info和debug 。默认值为critical。
    curldbg 打开libcurl的日志信息,默认是不打开。该选项无选项值,如果需要输出libcurl日志请直接增加-ocurldbg选项。
  • fuse选项列表
    选项名称 描述
    allow_other 修改挂载点的权限,允许所有的用户访问。该选择默认情况下只允许root用户设置。该选项无选项值,使用时请直接添加-oallow_other选项。
    uid 设置文件夹属于某个用户时填写的用户uid。
    gid 设置文件夹属于某个用户时填写的用户gid。