ossfs 2.0常用配置示例

在实际使用过程中,为满足不同场景下对存储空间(OSS Bucket)的挂载需求,需对ossfs 2.0配置文件进行针对性配置,然后在挂载存储空间(OSS Bucket)时,引用该配置文件即可完成挂载。本文将为您介绍,如何通过挂载选项,生成适用不同场景的ossfs 2.0配置文件。

创建配置文件

重要

一个配置文件仅能挂载一个Bucket。若要挂载多个Bucket,需创建多个配置文件,对每个Bucket分别进行配置,文件名与路径可自定义。挂载时引用相应的配置文件,就能实现多个Bucket的挂载。

您可按需自由设定ossfs 2.0配置文件的文件名与路径。例如,创建/etc/ossfs2.conf文件作为配置文件。

sudo touch /etc/ossfs2.conf

配置访问凭证

  • 环境变量

    ossfs 2.0.1及后续版本用户推荐您使用更加安全方便的环境变量配置方式。请参考以下命令配置挂载OSS Bucket时所需RAM用户的AccessKey(访问密钥)

    export OSS_ACCESS_KEY_ID=LTAI******************
    export OSS_ACCESS_KEY_SECRET=8CE4**********************
  • 配置文件

    ossfs 2.0.1及后续版本也支持在配置文件中完成访问凭证配置,如果您已经使用环境变量进行了配置,则无需在配置文件中重复配置。

    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
    --oss_bucket=bucketName
    --oss_access_key_id=AAAI************
    --oss_access_key_secret=AAA8x*************************

配置文件格式

  • 格式说明

    --为挂载选项前缀,<option>为挂载选项名称,[=<value>]value为挂载选项值,[]代表挂载选项值为可选。

    --<option>[=<value>]    
  • 配置示例

    # Bucket所处Endpoint(地域节点)
    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
    
    # Bucket名称
    --oss_bucket=bucketName
    
    # 访问密钥AccessKey IDAccessKey Secret(可选)。对于ossfs 2.0.1及后续版本的用户,可通过环境变量来配置访问凭证,无需在配置文件中进行设置。
    --oss_access_key_id=AAAI************
    --oss_access_key_secret=AAA8x*************************

常用配置示例

说明

查看BucketEndpoint请进入Bucket列表页面,选择目标Bucket并进入,接着单击左侧导航栏的概览选项,在概览页的访问端口栏中即可查看目标Bucket所处的地域节点。如图所示,以杭州地域Bucket为例。

image

请打开已创建的ossfs 2.0配置文件,参照以下示例(均以杭州地域内网Endpoint为例)配置并保存。内网和OSS加速器Endpoint仅支持同地域VPC内实例挂载,数据传输更快速、稳定;不建议ossfs配合外网Endpoint使用,受高延迟和不稳定的Internet网络连接影响,可能会出现各种卡顿问题。

挂载整个Bucket

挂载整个Bucket中的所有目录文件到本地。

# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名称
--oss_bucket=bucketName

# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

挂载Bucket中的指定目录

挂载Bucket时,指定目标Bucket中的特定目录挂载到本地。

# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名称
--oss_bucket=bucketName

# OSS文件目录路径(可选)
--oss_bucket_prefix=folder-test/folder-prefix/

# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

挂载Bucket并配置内存限制

在挂载Bucket时,分配指定的内存给ossfs 2.0进程使用。

重要

若不配置内存使用限制,ossfs 2.0默认会以性能优先进行调优,最大会使用约8 GB内存用于数据读写,从而获取最优性能。如果您的内存资源有限,建议配置total_mem_limit选项,以免出现OOM(内存不足)问题。

# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名称
--oss_bucket=bucketName

# 内存限制参数,单位为字节。(可选)
--total_mem_limit=4294967296

# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

挂载Bucket并开启调试日志

在挂载Bucket时,将日志级别指定为debug,同时自定义日志存放路径。

# Bucket所处Endpoint(地域节点)
--oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com

# Bucket名称
--oss_bucket=bucketName

# 日志存放路径(可选)
--log_dir=/tmp/log/ossfs2

# 日志级别(可选)
--log_level=debug

# 访问密钥AccessKey ID和AccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

挂载并配置Bucket访问权限

重要

ossfs 2.0挂载默认允许所有用户读写所有文件,若您需要更严格的权限需求,请参考如下配置。以下配置示例仅适用于ossfs 2.0.1及后续版本。

  • 挂载整个Bucket中的所有目录到本地,同时限制非root用户读写。

    # Bucket所处Endpoint(地域节点)
    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
    
    # Bucket名称
    --oss_bucket=bucketName
    
    # 禁止非root用户(挂载用户)访问
    --allow_other=false
    
    # 全局文件夹权限属性
    --dir_mode=0755
    
    # 全局文件权限属性
    --file_mode=0644
    
    # 访问密钥AccessKey IDAccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
    --oss_access_key_id=LTAI******************
    --oss_access_key_secret=8CE4**********************
  • 挂载整个Bucket中的所有目录到本地,仅允许root及特定用户读写,其他用户只读。

    # Bucket所处Endpoint(地域节点)
    --oss_endpoint=https://oss-cn-hangzhou-internal.aliyuncs.com
    
    # Bucket名称
    --oss_bucket=bucketName
     
    # 全局文件夹权限属性
    --dir_mode=0755
    
    # 全局文件权限属性
    --file_mode=0644
    
    # 特定用户uidgid(可以使用id命令获取对应用户的uidgid)
    --uid=1000
    --gid=1000
    
    # 访问密钥AccessKey IDAccessKey Secret(ossfs 2.0.1及后续版本该配置项可选)
    --oss_access_key_id=LTAI******************
    --oss_access_key_secret=8CE4**********************

后续步骤

完成ossfs 2.0的安装与配置后,接着您就可以将Bucket挂载到本地Linux系统中。具体操作,请参见挂载存储空间

相关文档

更多有关ossfs 2.0挂载选项说明,请参见挂载选项说明