ossfs归档 - KB记录与收集站

Aliyun, Cloud

CentOS 7.0/Ubuntu18.04及以上版本安装阿里云OSSFS

2021年3月14日

ossfs能让您在Linux系统中，将对象存储OSS的存储空间（Bucket）挂载到本地文件系统中，您能够像操作本地文件一样操作OSS的对象（Object），实现数据的共享。

运行环境

ossfs基于fuse用户态文件系统开发，只能运行在支持fuse的机器上。OSS提供了Ubuntu和CentOS系统的安装包，如果需要在其它环境下运行，可以通过源码方式构建目标程序。

CentOS 7.0及以上版本

ossfs支持在阿里云内网以及互联网环境下使用。在内网环境下时，建议使用内网访问域名，以提升访问速度和稳定性。

使用限制

不支持挂载归档型Bucket。
不适合高并发读写的场景。
编辑OSS内文件会导致文件被重新上传。
元数据操作（例如list directory）需要远程访问OSS服务器，所以性能较差。
重命名文件或文件夹可能会出错。若操作失败，可能会导致OSS和本地数据不一致。
多个客户端挂载同一个OSS Bucket时，数据一致性由您自行维护。建议您合理规划文件使用时间，避免出现多个客户端写同一个文件的情况。
不支持hard link。
若您因意外中断了文件上传的过程，且未继续完成该文件的上传，则已上传的部分会以碎片（Part）的形式存储在OSS的存储空间（Bucket）中。若您不再需要这些Part，建议您通过以下方式删除，以免产生额外的存储费用。

下载地址

Linux发行版	下载
Ubuntu 18.04 (x64)	ossfs_1.80.6_ubuntu18.04_amd64.deb
Ubuntu 16.04 (x64)	ossfs_1.80.6_ubuntu16.04_amd64.deb
Ubuntu 14.04 (x64)	ossfs_1.80.6_ubuntu14.04_amd64.deb
CentOS 7.0 (x64)	ossfs_1.80.6_centos7.0_x86_64.rpm
CentOS 6.5 (x64)	ossfs_1.80.6_centos6.5_x86_64.rpm

以上列表中提供了常用系统的安装包，若你的系统版本不在列表中，请通过源码编译。源码地址请参见GitHub ossfs。

注意复制链接的时候，会自动加上spm编码内容，使用wget命令下载的时候，注意删除链接中?spm=xxxx内容。

快速安装

1. 下载安装包。
  以下载CentOS 7.0 (x64)版本为例：
```
wget http://gosspublic.alicdn.com/ossfs/ossfs_1.80.6_centos7.0_x86_64.rpm
```
2. 安装ossfs。
  - Ubuntu系统
    以Ubuntu 16.04 (x64)版本为例，安装命令如下：
    
    sudo apt-get update sudo apt-get install gdebi-core sudo gdebi ossfs_1.80.6_ubuntu16.04_amd64.deb
  - CentOS系统
    以CentOS 7.0(x64)版本为例，安装命令如下：
    
    sudo yum install ossfs_1.80.6_centos7.0_x86_64.rpm
    对于使用yum安装rpm包的客户端，如果客户端节点网络环境特殊，无法直接用yum下载依赖包。可以在网络正常的、相同版本操作系统的节点上，使用yum下载依赖包并拷贝到网络特殊的节点。例如，ossfs需要依赖fuse 2.8.4以上版本，可使用如下命令，下载yum源中最新的fuse到本地：
    sudo yum install --downloadonly --downloaddir=./ fuse
    注意如果需要下载其他依赖包，则将fuse换成对应包的名称。
3. 配置账号访问信息。
  将Bucket名称以及具有此Bucket访问权限的AccessKeyId/AccessKeySecret信息存放在/etc/passwd-ossfs文件中。注意这个文件的权限必须正确设置，建议设为640。
  echo BucketName:yourAccessKeyId:yourAccessKeySecret > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs
4. 将Bucket挂载到指定目录。
```
ossfs BucketNamemountfolder -ourl=Endpoint
```
  挂载示例：将杭州地域名称为bucket-test的Bucket挂载到/tmp/ossfs目录下。
  echo bucket-test:LTAIbZcdVCmQ****:MOk8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs chmod 640 /etc/passwd-ossfs mkdir /tmp/ossfs ossfs bucket-test /tmp/ossfs -ourl=http://oss-cn-hangzhou.aliyuncs.com
  注意如果您使用从阿里云购买的云服务器（ECS）来提供ossfs服务，您可以使用内网域名，在这个示例中您可以将OSS endpoint 改为oss-cn-hangzhou-internal.aliyuncs.com，这样可以节省流量费用。OSS的内网域名请参见访问域名和数据中心。

如果您不希望继续挂载此Bucket，您可以将其卸载。

fusermount -u /tmp/ossfs

原文链接：https://help.aliyun.com/document_detail/153892.html?spm=a2c4g.11186623.6.911.20eb7a74hjUyzf

Ubuntu快速安装：

1.挂载命令：

wget http://gosspublic.alicdn.com/ossfs/ossfs_1.80.5_ubuntu16.04_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl1.0/libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb
sudo apt-get update
sudo apt-get install gdebi-core
sudo dpkg -i libssl1.0.0_1.0.2n-1ubuntu5_amd64.deb
sudo gdebi ossfs_1.80.5_ubuntu16.04_amd64.deb
echo bj-xxxxxx-01:xxxxfRCuDPGtsPQxxxx:y1YdxxxxxxcbipMr0RYaxxxxxw > /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs
mkdir /myoss
ossfs bj-xxxxxx-01 /myoss -ourl=http://oss-cn-beijing-internal.aliyuncs.com

2.卸载命令：

fusermount -u /myoss

3.开机自动挂载OSS：

检查系统目录/lib/systemd/system/rc-local.service，如果没有自己新建，文件内容为（如果文件存在本身是没有[Install]项的，需要自己添加进去）

[Unit]
Description=/etc/rc.local Compatibility
Documentation=man:systemd-rc-local-generator(8)
ConditionFileIsExecutable=/etc/rc.local
After=network.target
 
[Service]
Type=forking
ExecStart=/etc/rc.local start
TimeoutSec=0
RemainAfterExit=yes
GuessMainPID=no
 
####  需要自己添加
[Install]
WantedBy=multi-user.target
Alias=rc-local.service

4.创建/etc/rc.local脚本文件，并写入想要运行的脚本程序

#! /bin/bash
echo 'ossfs bj-xxxxxx-01 /myoss -ourl=http://oss-cn-beijing-internal.aliyuncs.com' >> /etc/rc.local
sudo chmod +x /etc/rc.local
sudo systemctl enable rc-local
sudo systemctl start rc-local.service
sudo systemctl status rc-local.service

5.验证重启

sudo reboot

CentOS快速安装：

1.挂载命令：

wget http://rpmfind.net/linux/centos/8-stream/AppStream/x86_64/os/Packages/compat-openssl10-1.0.2o-3.el8.x86_64.rpm
wget http://gosspublic.alicdn.com/ossfs/ossfs_1.80.6_centos7.0_x86_64.rpm
sudo yum install compat-openssl10-1.0.2o-3.el8.x86_64.rpm
sudo yum install ossfs_1.80.6_centos7.0_x86_64.rpm
echo bj-xxxxxx-01:xxxxfRCuDPGtsPQxxxx:y1YdxxxxxxcbipMr0RYaxxxxxw > /etc/passwd-ossfs 
chmod 640 /etc/passwd-ossfs 
mkdir /myoss 
ossfs bj-xxxxxx-01 /myoss -ourl=http://oss-cn-beijing-internal.aliyuncs.com

2.卸载命令：

fusermount -u /myoss

3.开机自动挂载OSS：

CentOS 7.0及以上的系统通过开机自动启动脚本进行挂载

在/etc/init.d/目录下建立文件ossfs，将模板文件中的内容拷贝到这个新文件中。并将其中的your_xxx内容改成您自己的信息。
为新建立的ossfs脚本赋予可执行权限：
```
chmod a+x /etc/init.d/ossfs
```
命令执行完成后，您可以尝试执行该脚本，如果脚本文件内容无误，那么此时OSS中的Bucket已经挂载到您指定的目录下了。
把ossfs启动脚本作为其他服务，开机自动启动：
```
chkconfig ossfs on
```
执行上述步骤后，ossfs就可以开机自动挂载了。

4.验证重启

sudo reboot

多Bucket挂载

账号配置文件的默认路径为/etc/passwd-ossfs，您也可以通过-opasswd_file=passwd-path选项指定配置文件。两者的区别在于：默认路径的权限可以是640，其他路径下的配置文件权限必须是600。

同一个账号配置文件里可以保存多条账号信息，一条记录一行。ossfs会根据挂载的存储空间名称匹配到正确的账号上。

配置示例：

echo bucket-test-1:AAAIbZcdVCmQ****:AAA8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs
echo bucket-test-2:BBBIbZcdVCmQ****:BBB8x0y9hxQ31coh7A5e2MZEUz**** >> /etc/passwd-ossfs
chmod 640 /etc/passwd-ossfs
mkdir /tmp/ossfs-1
mkdir /tmp/ossfs-2
ossfs bucket-test-1 /tmp/ossfs-1 -ourl=http://oss-cn-hangzhou.aliyuncs.com
ossfs bucket-test-2 /tmp/ossfs-2 -ourl=http://oss-cn-hangzhou.aliyuncs.com

当需要同时挂载多个存储空间时，您可以将所有的配置信息写到同一个账号配置文件里，也可以将不同的账号信息写到不同的账号配置文件中，通过-opasswd_file=xxx选项加载。

配置示例：

echo bucket-test-3:CCCIbZcdVCmQ****:CCC8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs-3
chmod 600 /etc/passwd-ossfs-3
mkdir /tmp/ossfs-3
ossfs bucket-test-3 /tmp/ossfs-3 -ourl=http://oss-cn-hangzhou.aliyuncs.com -opasswd_file=/etc/passwd-ossfs-3
echo bucket-test-4:DDDIbZcdVCmQ****:DDD8x0y9hxQ31coh7A5e2MZEUz**** > /etc/passwd-ossfs-4
chmod 600 /etc/passwd-ossfs-4
mkdir /tmp/ossfs-4
ossfs bucket-test-4 /tmp/ossfs-4 -ourl=http://oss-cn-hangzhou.aliyuncs.com -opasswd_file=/etc/passwd-ossfs-4