您可以通过-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的更多说明请参见 Object ACL 。
    retries 指定请求失败后的重试次数，默认值为2。
    storage_class 指定写入OSS文件的存储类型。可选参数为：
    • 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，约额外消耗4 MB大小的空间。
    stat_cache_expire 指定文件元数据缓存的失效时间，单位为秒，默认不失效。
    no_check_certificate 对服务端的证书不做校验，仅在使用HTTPS协议时有效，默认开启证书校验。该选项无选项值，使用时请直接添加 -ono_check_certificate 选项。
    multireq_max 列举文件时，访问文件元信息时的最大的并发数，默认值为20。
    parallel_count 以分片模式上传大文件时，分片的并发数，默认值为5。
    multipart_size 以分片模式上传数据时分片的大小，单位是MB，默认值为10。该参数会影响最大支持的文件大小。分片模式上传时，最多的分片数为10000，默认值下，最大的支持文件为100 GB。如果需要支持更大的文件，需要根据需求调整这个值。
    url 指定存储空间的访问域名。
    mp_umask 用来设定挂载点的权限掩码，只有当 allow_other 选项设置后，该选项才生效，默认值为000。使用方法与 umask 命令使用方式一致。例如需要设置挂载点的权限为770，则增加 -oallow_other -omp_umask=007 ；需要设置挂载点的权限为700，则增加 -oallow_other -omp_umask=077 。
    enable_content_md5 指定进行上传操作时，是否设置 CONTENT_MD5 ，默认不设置。如果您需要设置Content-MD5，则增加 -oenable_content_md5 选项。
    ram_role 使用ram_role方式访问OSS。当使用该方式访问OSS时，会忽略密钥文件的AccessKey ID和AccessKey Secret参数。
    listobjectsv2 当Bucket开启版本控制时，建议使用 -olistobjectsv2 选项列举文件。
    notsup_compat_dir 用于限制不兼容多种目录类型。默认情况下，ossfs会将 dir/ 、 dir 以及 dir_$folder$ 识别为目录。

    如果您需要限制ossfs仅将 dir/ 识别为目录，以减少ossfs与服务端的交互请求，您需要使用 -onotsup_compat_dir 选项。

    ensure_diskfree 用于设置ossfs保留的可用磁盘空间大小。为提升性能，默认情况下ossfs会使用磁盘空间来保存上传或下载的临时数据。您可以通过该选项设置保留的可用硬盘空间大小，单位为MB。例如，您需要设置ossfs保留1024 MB的可用磁盘空间，则使用 -oensure_diskfree=1024 。
    dbglevel 设置日志信息的级别，支持日志信息级别如下：
    • critical（默认值）
    • error
    • warn
    • info
    • debug
    curldbg 打开libcurl的日志信息，默认不打开。如果需要输出libcurl日志，则需要增加 -ocurldbg 选项。
  • fuse选项列表
    选项名称 描述
    allow_other 修改挂载点的权限，允许所有的用户访问。该选择默认情况下只允许root用户设置。该选项无选项值，使用时请直接添加 -oallow_other 选项。
    uid 指定文件夹归属用户的用户UID。
    gid 指定文件夹归属用户的用户GID。