ossfs 2.0常用配置示例

更新时间:2025-03-25 05:39

在实际使用过程中,为满足不同场景下对存储空间(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

配置文件格式

  • 格式说明

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

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

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

常用配置示例

说明
  • 创建AccessKey ID和AccessKeySecret请参见创建AccessKey

  • 查看Bucket的Endpoint

    请进入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
--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

# 访问密钥AccessKey ID和AccessKey Secret
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

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

挂载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

# 访问密钥AccessKey ID和AccessKey Secret
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

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

挂载Bucket并开启调试日志

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

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

# Bucket名称
--oss_bucket=bucketName

# 访问密钥AccessKey ID和AccessKey Secret
--oss_access_key_id=LTAI******************
--oss_access_key_secret=8CE4**********************

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

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

后续步骤

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

相关文档

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

  • 本页导读 (1)
  • 创建配置文件
  • 配置文件格式
  • 常用配置示例
  • 挂载整个Bucket
  • 挂载Bucket中的指定目录
  • 挂载Bucket并配置内存限制
  • 挂载Bucket并开启调试日志
  • 后续步骤
  • 相关文档
文档反馈