AI 助理
备案控制台
文档
输入文档关键字查找
首页 对象存储 开发参考 常用工具 ossfs 常见问题

ossfs常见问题

更新时间：
产品详情
我的收藏

本文介绍在使用ossfs时遇到的一些问题案例及解决方案。

通用说明

ossfs报错信息中均包含message。排查问题时，需要收集这些message，并根据message判断问题。例如socket连接失败、HTTP响应的状态码4xx、5xx等，使用前先开启debug-log。

  • 403错误是因权限不足，导致访问被拒绝。

  • 400错误是用户的操作方法有误。

  • 5xx错误一般和网络抖动以及客户端业务有关系。

ossfs有以下特点：

  • ossfs是将远端的OSS挂载到本地磁盘，如果对文件读写性能敏感的业务，不建议使用ossfs 。

  • ossfs的操作不是原子性，存在本地操作成功，但OSS远端操作失败的风险。

如果ossfs不满足您的业务需求，建议使用ossutil。

权限问题

挂载成功后，touch文件时报错403

问题分析：403错误通常是访问权限问题导致的。以下情况会导致touch一个文件出现403报错。

  • 该文件为归档类型文件，touch时会出现403报错。

  • 使用的AccessKey无该存储空间的操作权限。

解决方案：

  • 归档类型文件问题：将文件解冻后访问或为文件所在Bucket开启归档直读。

  • 权限问题：为使用的AccessKey对应的账号配置正确的权限。

通过rm命令删除文件时报错"Operation not permitted"

问题分析：通过rm命令删除文件时，会调用DeleteObject API进行删除。如果您是通过RAM用户挂载，请检查挂载的RAM用户是否具备删除文件的权限。

解决方案：为该RAM用户设置正确的权限。更多信息，请参见RAM Policy和RAM Policy常见示例。

访问报错"The bucket you are attempting to access must be addressed using the specified endpoint”

问题分析：根据Message判断，错误原因是Endpoint指定错误，有以下两种可能性：

  • Bucket和Endpoint不匹配。

  • Bucket所属UID和实际的AccessKey对应的UID不一致。

解决方案：确认配置信息正确并修改。

挂载问题

挂载报错"ossfs: unable to access MOUNTPOINT /tmp/ossfs: Transport endpoint is not connected"

问题分析：未创建该目录导致的。

解决方案：先创建对应的目录，之后再进行挂载操作。

挂载报错"fusermount: failed to open current directory: Permission denied"

问题分析：fuse的Bug，要求当前用户对当前目录（非挂载目录）有读权限。

解决方案：通过cd命令切换到一个有读权限的目录，再运行ossfs命令。

挂载报错"ossfs: Mountpoint directory /tmp/ossfs is not empty. if you are sure this is safe, can use the 'nonempty' mount option"

问题分析：默认情况下，ossfs只能挂载到空目录下。当试图挂载到非空目录下时，会提示上述错误。

解决方案：切换到一个空目录下重新挂载。如果还是需要挂载到该目录下，挂载时增加 -ononempty 参数。

挂载报错"ops-nginx-12-32 s3fs[163588]: [tid-75593]curl.cpp:CurlProgress(532): timeout now: 1656407871, curl_times[curl]: 1656407810, readwrite_timeout: 60"

问题分析：ossfs挂载超时。

解决方案：ossfs通过readwrite_timeout选项指定读或者写请求的超时时间，单位为秒，默认值为60秒。您需要结合实际业务场景，适当增加该选项的取值。

挂载报错"ossfs: credentials file /etc/passwd-ossfs should not have others permissions"

问题分析：/etc/passwd-ossfs文件权限不正确。

解决方案：/etc/passwd-ossfs保留了访问凭证信息，需要限制others访问该文件。您可以通过chmod 640 /etc/passwd-ossfs命令修改文件的访问权限。

挂载成功后，ls目录时报错"operation not permitted"

问题分析：请检查您的Bucket中，是否存在名称含有不可见字符的Object。文件系统对文件名和目录名有严格的限制，因此会收到上述错误。

解决方案：用其他工具对这些Object重命名后，ls就能正确显示目录内容了。

挂载时报错"fuse: device not found, try 'modprobe fuse'"

问题分析：尝试在Docker容器中使用ossfs挂载时遇到的错误"fuse: device not found, try 'modprobe fuse'"通常是因为容器缺乏访问或加载FUSE内核模块所需的权限。

解决方案：在Docker容器中运行时，可以通过添加--privileged=true参数来赋予容器更高的权限，从而允许容器内的进程执行类似宿主机的操作，包括使用FUSE文件系统。使用--privileged标志启动容器的命令示例如下：

docker run --privileged=true -d your_image

费用问题

在ECS上挂载OSS，如何避免因后台程序扫描文件而产生费用

问题分析：程序扫描ossfs挂载的目录，会转换成向OSS的请求。如果请求次数很多，会产生费用。

解决方案：可以通过auditd工具查看是哪些进程扫描了OSS挂载的目录。具体步骤如下：

  1. 安装auditd并启动。 

    sudo apt-get install auditd
sudo service auditd start

  2. 将OSS挂载的目录设置为监视目录，例如挂载目录为/mnt/ossfs。 

    auditctl -w /mnt/ossfs

  3. 在auditlog中查看是哪些进程访问了这个目录。 

    ausearch -i | grep /mnt/ossfs

  4. 修改参数，跳过程序扫描。

    例如通过auditlog查到是updatedb扫描了所挂载的目录，可以通过修改/etc/updatedb.conf让它跳过。具体做法是：

    1. 在RUNEFS =后面加上fuse.ossfs。

    2. 在PRUNEPATHS =后面加上挂载的目录。

磁盘内存问题

ossfs偶尔出现断开的情况

问题分析：

  1. 开启ossfs的debug日志，加上-d -odbglevel=dbg参数，ossfs会将日志写入到默认系统文件中。

    • CentOS系统：写入到/var/log/message。

    • Ubuntu系统：写入到/var/log/syslog。

  2. 分析日志，发现ossfs在listbucket、listobject申请内存过多，触发了系统的oom。

    说明

    listobject是发起HTTP请求到OSS获取文件的meta信息，如果客户的文件很多，ls会消耗系统大量内存来获取文件的meta。

解决方案：

  • 通过-omax_stat_cache_size=xxx参数增大stat cache 的 size，这样第一次ls会较慢，但是后续的ls速度会提高，因为文件的元数据都在本地cache中。这个值默认是1000，约消耗4 MB内存，请根据您机器内存大小调整为合适的值。

  • ossfs在读写时会占用磁盘写大量的temp cache ，和Nginx差不多，可能会导致磁盘可用空间不足。当ossfs退出后，会自动清理临时文件。

  • 使用ossutil替代ossfs，非线上敏感业务可以使用ossfs ，要求可靠性、稳定性的建议使用ossutil。

ossfs为什么会把磁盘空间写满？

问题原因：为提升性能，默认情况下ossfs会尽可能使用磁盘空间来保存上传或下载的临时数据，此时会存在磁盘空间写满的情况。

解决方法：您可以通过-oensure_diskfree选项指定保留磁盘空间大小。例如，指定保留20 GB的磁盘空间大小，命令如下：

ossfs examplebucket /tmp/ossfs -o url=http://oss-cn-hangzhou.aliyuncs.com -oensure_diskfree=20480

ossfs挂载后，为什么通过df命令显示磁盘空间大小为256 TB？

通过df命令显示的磁盘空间大小仅作为展示值，并不代表OSS存储空间实际容量。其中，Size（磁盘空间总大小）和Avail（磁盘空间剩余可用大小）固定为256 TB，Used（已使用磁盘空间大小）固定为0 TB。

OSS存储空间容量无限制，存储空间使用量取决于您的实际使用量。关于存储空间用量查询的更多信息，请参见查询Bucket级别的用量情况。

通过cp命令拷贝数据时报错"input/output error"

问题分析：input/output error都是捕获到系统磁盘的错误而产生的报错，可以查看出现报错时，磁盘读写是否存在高负载的情况。

解决方案：可以增加分片参数，控制文件读写。使用ossfs -h命令可以查看分片参数。

使用rsync同步时报错"input/output error"

问题分析：ossfs与rsync同步使用本身会出现问题。此案例中，用户对一个141 GB的大文件进行cp操作，使磁盘读写处于非常高的负载状态，从而产生此报错。

解决方案：如果想要将OSS文件下载到本地ECS ，或者本地上传到ECS ，可以通过ossutil的分片上传、下载进行操作。

上传大文件时报错"there is no enough disk space for used as cache(or temporary)"

  • 问题原因

    磁盘空间小于multipart_size * parallel_count。

    multipart_size表示分片大小（默认单位为MB），parallel_count表示并发上传分片数量（默认值为5）。

  • 问题分析

    ossfs默认通过分片上传的方式上传大文件。上传时，ossfs会将临时缓存文件写入/tmp目录下，写入前需要先判断/tmp目录所在的磁盘可用空间是否小于multipart_size * parallel_count。如果磁盘可用空间大于multipart_size * parallel_count，则正常写入文件。如果磁盘可用空间小于multipart_size * parallel_count，则出现本地磁盘可用空间不足的报错。

    例如，磁盘可用空间为300 GB，待上传的文件为200 GB，但multipart_size设置为100000（100 GB），并发上传分片数量保持默认值5。此时，ossfs判断上传的文件大小为100 GB*5=500 GB，超出本地磁盘可用空间。

  • 解决方法

    在并发上传分片数量保持默认值5的情况下，设置合理的multipart_size：

    • 如果磁盘可用空间为300 GB，待上传的文件为200 GB，则multipart_size设置为20。

    • 如果磁盘可用空间为300 GB，待上传的文件为500 GB，则multipart_size设置为50。

版本依赖问题

安装ossfs时报错"fuse: warning: library too old, some operations may not work"

问题分析：出现错误的原因是ossfs编译时所使用的libfuse版本比运行时链接到的libfuse版本高，这往往是用户自行安装了libfuse导致的。CentOS-5.x和CentOS-6.x系统中，阿里云提供的ossfs安装包里包含了libfuse-2.8.4，如果在运行的时候环境中有libfuse-2.8.3，并且ossfs被链接到了旧版本的fuse上，就会出现上述错误。

您可以通过ldd $(which ossfs) | grep fuse命令确认ossfs运行时链接的fuse版本，如结果是/lib64/libfuse.so.2，那么通过ls -l /lib64/libfuse*命令可以看到fuse的版本。

解决方案：让ossfs链接到正确的版本。

  1. 通过rpm -ql ossfs | grep fuse命令找到libfuse的目录。

  2. 如果结果是/usr/lib/libfuse.so.2，则通过LD_LIBRARY_PATH=/usr/lib ossfs …命令运行ossfs。

安装依赖库fuse报错

问题分析：fuse的版本不满足ossfs的要求。

解决方案：手动下载fuse最新版本安装，不要使用yum安装。详情请参见fuse。

使用Is列举文件时报错"Input/Output error"

问题原因：该问题主要出现在CentOS环境，日志中报错NSS error -8023。ossfs在使用libcurl进行HTTPS通信时出现问题，可能是由于libcurl依赖的NSS（Network Security Services）库版本过低导致的。

解决方案：使用以下代码，升级NSS库至最新版本。

yum update nss

使用yum/apt-get安装ossfs时报错"conflicts with file from package fuse-devel"

问题分析：系统中存在老版本的fuse，与ossfs里的依赖版本冲突。

解决方案：请先使用相关的包管理器卸载fuse，再重新安装ossfs。

其他问题

使用ossfs上传到OSS的文件的Content-Type全是application/octet-stream

问题分析：上传文件时，ossfs通过查询/etc/mime.types中的内容来设置文件的Content-Type。当该文件不存在时，默认设置为application/octet-stream。

解决方案：请检查这个文件是否存在，如果不存在，则需要添加。

  • 通过命令自动添加mime.types文件

    • Ubuntu系统

      使用sudo apt-get install mime-support命令添加。

    • CentOS系统

      使用sudo yum install mailcap命令添加。

  • 手动添加mime.types文件

    1. 创建mime.types文件 

      vi /etc/mime.types

    2. 添加需要的格式，每种格式一行，每行格式为application/javascript js。

添加完成后，需要重新挂载OSS。

ossfs为什么将文件夹识别成普通文件

  • 情形一：

    问题分析：创建文件夹对象（以/结尾的对象）时，content-type指定为text/plain，ossfs会将这个对象识别成普通文件。

    解决方案：您可以挂载时加上-ocomplement_stat参数。如果该文件夹对象大小为0或1，ossfs会将其识别成文件夹。

  • 情形二：

    问题分析：可以通过ossutil stat 文件夹对象（以'/'结尾）命令（例如：ossutil stat oss://[bucket]/folder/）。执行命令后：

    1. 查看该对象的Content-Length字段，即对象的大小。如果对象大小非0，则会被识别成文件。

      解决方案：如果不再需要该文件夹对象的内容，可以通过ossutil rm oss://[bucket]/folder/命令删除该对象（不会影响文件夹下面的文件），或者通过ossutil上传一个大小为0的同名对象将其覆盖。

    2. 如果对象大小为0，查看Content-Type字段，即对象属性，如果不是application/x-directory，httpd/unix-directory，binary/octet-stream或application/octet-stream，也会被识别成文件。

      解决方案：可以通过ossutil rm oss://[bucket]/folder/命令删除该对象（不会影响文件夹下面的文件）

ossfs执行mv操作失败

问题原因：通过ossfs执行mv操作失败的可能原因是源文件为归档存储、冷归档存储或者深度冷归档存储类型文件。

解决方法：对归档存储、冷归档存储或者深度冷归档存储类型的文件执行mv操作前，您需要先解冻文件。具体步骤，请参见解冻文件。

ossfs是否支持在Windows环境中挂载存储空间？

不支持。您可以在Windows环境下，通过以下两种方式挂载OSS存储空间。

为什么用ossfs看到的文件信息（例如大小）与其他工具看到的不一致

问题分析：ossfs默认会缓存文件的元数据（包括大小/权限等），这样就不需要每次ls的时候向OSS发送请求，加快速度。 如果用户通过其他程序（例如SDK/官网控制台/ossutil等）对文件进行了修改，由于缓存的关系，ossfs没有及时更新，导致与其他工具看到的文件信息不一致。

解决方案：可以在挂载的时候加上参数-omax_stat_cache_size=0，禁用元数据缓存功能。每次ls时，都会向OSS 发送请求，获取最新的文件信息。

为什么Bucket开启版本控制后出现挂载慢的问题？

问题原因：ossfs默认通过调用ListObjects（GetBucket）列举文件。在Bucket开启版本控制，且Bucket中存在一个或者多个历史版本Object以及大量的过期删除标记的情况下，使用ListObjects（GetBucket）接口列举当前版本Object时会出现响应速度下降，从而影响ossfs挂载操作。

解决方法：使用-olistobjectsV2选项将ossfs切换至ListObjectsV2（GetBucketV2）接口，提升列举文件的性能。

如何设置通过HTTPS方式挂载？

ossfs支持通过HTTPS方式挂载，以华东1（杭州）地域为例，挂载命令如下：

ossfs examplebucket /tmp/ossfs -o url=https://oss-cn-hangzhou.aliyuncs.com

目录下有非常多的文件时，为什么ls该目录很慢

问题分析：假设一个目录下有N个文件，那么ls该目录至少需要N次OSS HTTP requests。在文件非常多的时候，这可能造成严重的性能问题。

解决方案： 通过-omax_stat_cache_size=xxx参数增大stat cache的size，这样第一次ls会较慢，但是后续的ls就快了，因为文件的元数据都在本地cache中。在1.91.1版本之前，这个值默认是1000；从1.91.1版本开始，这个值默认是100000，内存占用约几十MB，请根据您机器内存大小调整为合适的值。

卸载时报错"fusermount: failed to unmount /mnt/ossfs-bucket: Device or resource busy"

问题分析：有进程正在访问挂载目录/mnt/ossfs-bucket下的文件 ，所以无法卸载。

解决方案：

  1. 使用lsof /mnt/ossfs-bucket找出访问该目录的进程。

  2. 使用kill命令强制关闭进程。

  3. 使用fusermount -u /mnt/ossfs-bucket卸载Bucket。

上一篇：只读场景性能调优下一篇：版本更新功能介绍
文档推荐