快速安装

运行环境

建议您将ossfs运行在以下环境中：

• Linux系统
  • CentOS 7.0及以上，8.0以下版本
  • Ubuntu 14.04及以上版本
• fuse 2.8.4以上版本

由于低版本的Linux系统内核版本比较低，ossfs进程在运行过程中容易出现掉线或者其他问题。OSS虽然提供了低版本Linux系统的安装包，但为了保证ossfs的稳定运行，请将您的操作系统升级到上述版本。

下载地址

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

快速安装

1. 下载安装包。
   以下载CentOS 7.0 (x64)版本为例：

   wget http://gosspublic.alicdn.com/ossfs/ossfs_1.80.6_centos7.0_x86_64.rpm

2. 安装ossfs。
   • Ubuntu系统的安装命令：

     sudo apt-get update
     sudo apt-get install gdebi-core
     sudo gdebi your_ossfs_package

   • CentOS 6.5及以上系统版本的安装命令：

     sudo yum localinstall your_ossfs_package

     说明 对于使用yum安装rpm包的客户端，如果客户端节点网络环境特殊，无法直接用yum下载依赖包。可以在网络正常的、相同版本操作系统的节点上，使用yum下载依赖包并拷贝到网络特殊的节点。例如，ossfs需要依赖fuse 2.8.4以上版本，可使用如下命令，下载yum源中最新的fuse到本地：

     sudo yum install --downloadonly --downloaddir=./ fuse

     如果需要下载其他依赖包，则将fuse换成对应包的名称。
   • CentOS 5系统版本的安装命令：

     sudo yum localinstall your_ossfs_package --nogpgcheck

3. 配置账号访问信息。
   将Bucket名称以及具有此Bucket访问权限的AccessKeyId/AccessKeySecret信息存放在/etc/passwd-ossfs文件中。注意这个文件的权限必须正确设置，建议设为640。

   echo my-bucket:my-access-key-id:my-access-key-secret > /etc/passwd-ossfs
   chmod 640 /etc/passwd-ossfs

4. 将Bucket挂载到指定目录。

   ossfs my-bucket my-mount-point -ourl=my-oss-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的内网域名请参见访问域名和数据中心。
5. 如果您不希望继续挂载此Bucket，您可以将其卸载。

   fusermount -u /tmp/ossfs

版本日志

版本日志信息，请参见GitHub ChangeLog。