nextcloud阿里云oss挂载辅助文档(腾讯云可参考）

官方 FAQ 拷贝

FAQ
1
Q: ossfs 适合什么样的程序？
ossfs 能把 oss bucket 挂载到本地，如果您使用的软件没有支持OSS，但您又想让数据能自动同步到OSS，那么 ossfs 是很好的选择。
2
Q: ossfs 有什么局限性？
由于数据需要经过网络同步到云端，ossfs 在性能和功能上可能与本地文件系统有差距。如果您想让数据库等对 io 要求很高的应用跑在 ossfs 挂载的盘上，请慎重考虑。和本地文件系统具体差异：
随机或者追加写文件会导致整个文件的重写。
元数据操作，例如 list directory，性能较差，因为需要远程访问OSS服务器。
文件/文件夹的 rename 操作不是原子的。
多个客户端挂载同一个 oss bucket 时，依赖用户自行协调各个客户端的行为。例如避免多个客户端写同一个文件等等。
不支持 hard link。
3
Q: ossfs 一定要阿里云的机器才能用么？
ossfs 不限制一定要阿里云的内网才可以使用，外网机器依然可以使用。
4
Q: ossfs 能不能同时挂载多个OSS bucket
可以的，在 passwd-ossfs 文件中写入多个OSS配置信息即可。支持不同帐号的OSS。
5
Q: 我在 yum/apt-get 安装 ossfs，遇到 conflicts with file from package fuse-devel 的错误，请问是怎么回事？
您的系统中存在老版本的 fuse，请先使用相关的包管理器卸载，再重新安装 ossfs。
6
Q: ossfs 工作不正常，如何 debug？
您可以使用在挂载时，加上-d -o f2 参数，ossfs 会把日志写入到系统日志中。在 centos 系统中，在/var/log/messages 中。
您也可以在挂载时使用-f -d -o f2 参数，ossfs 会把日志输出到屏幕上。
7
Q: 为什么我在 mount 时遇到 ossfs: unable to access MOUNTPOINT /tmp/ossfs: Transport endpoint is not connected 这样的错误？
请先 umount 对应的目录。
请检查您在使用 ossfs 挂载时，填入的 url 参数是否正确，是否和 bucket/access key id/access key secret 匹配。
特别注意：url 中不包含 bucket 的名字。例如：您在 oss 控制台中看到 bucket 的域名是这样的：ossfs-test-1.oss-cn-hangzhou.aliyuncs.com。那么填入的 url 则是：http://oss-cn-hangzhou.aliyuncs.com。
8
Q: ossfs 提示 ossfs: unable to access MOUNTPOINT /tmp/odat: No such file or directory
这是您未创建该目录导致的，在挂载前需要创建对应目录
9
Q: 我把 bucket 挂载到本地后，ls 目录，却收到 operation not permitted 错误，这是为什么？
请检查您的 bucket 中，是否包含目录名含有不可见字符的OSS object。文件系统对文件/目录名有更严格的限制，因此会收到上述错误。使用其他工具对这些 object 重命名后，ls 就能正确显示目录内容了。
10
Q: 我的一个目录下有非常多的文件，为什么 ls 该目录很慢？
假设一个目录下有 n 个文件，那么 ls 该目录至少需要 n 次OSS http requests。在文件非常多的时候，这可能造成严重的性能问题。
您可以采用下面两个办法优化：
通过-omax_stat_cache_size=xxx 参数增大 stat cache 的 size，这样第一次 ls 会较慢，但是后续的 ls 就快了，因为文件的元数据都在本地 cache 中。默认这个值是1000，大约消耗4MB内存，请根据您机器内存大小调整为合适的值。
使用 ls -f 命令，这个命令会消除与OSS的 n 次 http 请求。
具体参见 issue 13
11
Q: ossfs 挂载时如何设置权限？
如果要允许其他用户访问挂载文件夹，可以在运行 ossfs 的时候指定 allow_other 参数：
ossfs your_bucket your_mount_point -ourl=your_endpoint -o allow_other
为什么使用 allow_other 参数，仍然不能访问文件？
注意：allow_other 是赋予挂载目录其他用户访问的权限，不是里面的文件！如果您要更改文件夹中的文件，请用 chmod 命令。
allow_other 默认赋予挂载目录777权限，我想让挂载目录的权限为770，该怎么办？
可以通过 umask 来设置，参见这里。
12
Q：如果要使挂载的文件夹(/tmp/ossfs)属于某个 user：
首先通过 id 命令获得指定用户的 uid/gid 信息。例如获取 www 用户的 uid/gid 信息：id www
然后挂载时指定 uid/gid 参数：ossfs your_bucket your_mountpoint -ourl=your_url -ouid=your_uid -ogid=your_gid
注意：uid/gid 都是数字。
13
Q: 我不是 root 用户，如何 umount ossfs 挂载的目录
fusermount -u your_mountpoint
14
Q: 如何开机自动挂载 ossfs？
Step 1 首先请参考使用说明，把 bucket name，access key id/secret 等信息写入/etc/passwd-ossfs，并将该文件权限修改为640。
echo your_bucket_name:your_access_key_id:your_access_key_secret > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs
Step 2 接下来针对不同的系统版本，设置方式有所不同
Step 2A 通过 fstab 的方式自动 mount（适用于 ubuntu14.04, centos6.5）
在/etc/fstab 中加入下面的命令
ossfs#your_bucket_name your_mount_point fuse _netdev,url=your_url,allow_other 0 0
其中上述命令中的 your_xxx 信息需要根据您的 bucket name 等信息填入。
保存/etc/fstab 文件。执行 mount -a 命令，如果没有报错，则说明设置正常。
到这一步，ubuntu14.04就能自动挂载了。centos6.5还需要执行下面的命令：
chkconfig netfs on
Step 2B 通过开机自启动脚本 mount（适用于 centos7.0及以上的系统）
在/etc/init.d/目录下建立文件 ossfs，把模板文件中的内容拷贝到这个新文件中。并将其中的 your_xxx 内容改成您自己的信息。
执行命令：chmod a+x /etc/init.d/ossfs
上述命令是把新建立的 ossfs 脚本赋予可执行权限。您可以执行该脚本，如果脚本文件内容无误，那么此时 oss 中的 bucket 已经挂载到您指定的目录下了。
执行命令：chkconfig ossfs on
上述命令是把 ossfs 启动脚本作为其他服务，开机自动启动。
好了，现在 ossfs 就可以开机自动挂载了。总结起来，如果您是 ubuntu14.04和 centos6.5，您需要执行 Step 1 ＋ Step 2A；如果您是 centos7.0系统，您需要执行 Step 1 ＋ Step 2B。
15
Q: 遇到 fusermount: failed to open current directory: Permission denied 错误如何解决？
这是 fuse 的一个 bug，它要求当前用户对当前目录（非挂载目录）有读权限。解决的办法就是 cd 到一个有读权限的目录再运行 ossfs 命令
16
Q: 使用ECS挂载 ossfs，如何避免因后台程序扫描文件而产生费用？
程序扫描 ossfs 挂载的目录，会转换成向OSS的请求，如果请求次数很多，会产生费用（1分钱/1万次）。如果是 updatedb，可以通过修改/etc/updatedb.conf 让它跳过。具体做法是：
 1. 在`PRUNEFS = `后面加上`fuse.ossfs`
 2. 在`PRUNEPATHS = `后面加上挂载的目录
如何确定是哪个进程扫了我的目录？
首先安装 auditd: sudo apt-get install auditd
启动 auditd: sudo service auditd start
设置监视挂载目录: auditctl -w /mnt/ossfs
在 auditlog 中可以查看是哪些进程访问了这个目录：ausearch -i | grep /mnt/ossfs
17
Q: 使用 ossfs 上传到OSS的文件 Content-Type 全是"application/octet-stream"是怎么回事？
ossfs 通过查询/etc/mime.types 中的内容来确定文件的 Content-Type，请检查这个文件是否存在，如果不存在，则需要添加：
对于 ubuntu 可以通过 sudo apt-get install mime-support 来添加
对于 centos 可以通过 sudo yum install mailcap 来添加
也可以手动添加，每种格式一行，每行格式为：application/javascript js
18
Q: 如何使用 supervisor 启动 ossfs？
安装 supervisor，在 ubuntu 中执行 sudo apt-get install supervisor
建立一个目录，编辑 ossfs 的启动脚本：
mkdir /root/ossfs_scripts
vi /root/ossfs_scripts/start_ossfs.sh
# contents of start_ossfs.sh
fusermount -u /mnt/ossfs
exec ossfs ... -f
编辑/etc/supervisor/supervisord.conf，在最后加入下面一段：
[program:ossfs]
command=bash /root/ossfs_scripts/start_ossfs.sh
logfile=/var/log/ossfs.log
log_stdout=true
log_stderr=true
logfile_maxbytes=1MB
logfile_backups=10
运行 supervisor：
supervisord
确认一切正常：
ps aux | grep supervisor # 应该能看到 supervisor 进程
ps aux | grep ossfs # 应该能看到 ossfs 进程
killall ossfs # 杀掉 ossfs 进程，supervisor 应该会重启它
ps aux | grep ossfs # 应该能看到 ossfs 进程
如果出错，请检查/var/log/supervisor/supervisord.log 和/var/log/ossfs.log。
19
Q: 遇到"fuse: warning: library too old, some operations may not work"怎么办？
出现的原因是：ossfs 编译时所使用的 libfuse 版本 比运行时链接到的 libfuse 版本高。这往往是用户自行安装了 libfuse 导致的。使用我们提供的 rpm 包安装 ossfs，无需再安装 libfuse。
在 CentOS-5.x 和 CentOS-6.x 上我们提供的 rpm 包里包含了 libfuse-2.8.4，如果在运行的时候环境中有 libfuse-2.8.3，并且 ossfs 被链接到了旧版本的 fuse 上，就会出现上述 warning。
如何确认 ossfs 运行时链接的 fuse 版本？
运行 ldd $(which ossfs) | grep fuse
例如结果是"/lib64/libfuse.so.2"，那么通过 ls -l /lib64/libfuse*可以看到 fuse 的版本
如何让 ossfs 链接到正确的版本？
首先通过 rpm -ql ossfs | grep fuse 找到 libfuse 的目录
例如结果是"/usr/lib/libfuse.so.2"，则通过LD_LIBRARY_PATH=/usr/lib ossfs ...运行 ossfs
我能忽略这个WARNING吗？
最好不要，见这个 bug
20
Q: 为什么用 ossfs 看到的文件信息（例如大小）与其他工具看到的不一致？
因为 ossfs 默认会缓存文件的元信息（包括大小/权限等），这样就不需要每次 ls 的时候向OSS发送请求，加快速度。 如果用户通过其他程序（例如SDK/官网控制台/osscmd 等）对文件进行了修改，那么有可能在 ossfs 中看到的文件信息 没有及时更新。
如果想禁止 ossfs 的缓存，那么可以在挂载的时候加上如下参数：
-omax_stat_cache_size=0