cosfs 能让您在Linux/Mac OS X 系统中把Tencent COS bucket 挂载到本地文件 系统中，您能够便捷的通过本地文件系统操作COS 上的对象，实现数据的共享。

cosfs 基于s3fs 构建，具有s3fs 的全部功能。主要功能包括：

• 支持POSIX 文件系统的大部分功能，包括文件读写，目录，链接操作，权限，uid/gid
• 通过COS 的multipart 功能上传大文件。
• MD5 校验保证数据完整性。

COS为了方便用户安装，提供了相应操作系统的安装包   * ubuntu-16.04 ubuntu-14.04 * centos6.5/centos7.0   可以从版本发布页面来下载安装

centos6.5+ 安装方式  

sudo yum localinstall release-cosfs-package
其中 ， release-cosfs-package 需要改成用户系统对应的安装包的名称，如 release-cosfs-1.0.1-centos6.5.x86_64.rpm

ubuntu 安装方式

sudo apt-get update; sudo apt-get install gdebi-core
sudo  gdebi release-cosfs-package

如果没有找到对应的安装包，您也可以自行编译安装。编译前请先安装下列依赖库：

Ubuntu 14.04+:

sudo apt-get install automake autotools-dev g++ git libcurl4-gnutls-dev \
                     libfuse-dev libssl-dev libxml2-dev make pkg-config

CentOS 6.5+:

sudo yum install automake gcc-c++ git libcurl-devel libxml2-devel \
                 fuse-devel make openssl-devel

  如果在编译过程中遇到提示fuse版本低于2.8.4，请参考常见问题来解决

然后您可以在github上下载源码并编译安装：

git clone https://github.com/XXX/cosfs.git
cd cosfs
./autogen.sh
./configure
make
sudo make install

设置bucket name, access key/id信息，将其存放在/etc/passwd-cosfs 文件中， 注意这个文件的权限必须正确设置，建议设为640。

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

将cos bucket mount到指定目录,注意 需要在bucke前面指定appid

cosfs my-appid:my-bucket my-mount-point -ourl=my-cos-endpoint

将my-bucket这个bucket挂载到/tmp/cosfs目录下，AccessKeyId是faint， AccessKeySecret是123，cos endpoint是http://cn-south.myqcloud.com cn-south 对应华南广州地域 cn-north 对应华北天津地域 cn-east 对应华东上海地域

echo my-bucket:faint:123 > /etc/passwd-cosfs
chmod 640 /etc/passwd-cosfs
mkdir /tmp/cosfs
cosfs appid:my-bucket /tmp/cosfs -ourl=http://cn-south.myqcloud.com -odbglevel=info -ouse_cache=/path/to/local_cache

-ouse_cache 指定了使用本地cache来缓存临时文件，进一步提高性能，如果不需要本地cache或者本地磁盘容量有限，可不指定该选项

卸载bucket:

fusermount -u /tmp/cosfs # non-root user

如何使用STS（临时密钥）来挂载bucket

参考挂载示例
./cosfs 1252448703:rabbitliu /mnt/rabbit/ -ourl=http://cn-south.myqcloud.com -odbglevel=info -oallow_other -ocam_role=sts -opasswd_file=/tmp/passwd-jimmy-sts

其中 -ocam_role=sts 是必须的参数

-opasswd_file 含义和之前一致，文件名和路径可以任意指定
但是文件内容需要以以下格式提供
COSAccessKeyId=AKID5yc1B6BEwRikX8gaQ1NTIrAE2ay92mFS
COSSecretKey=80e1A3h5FBtNbcPxGPL3ZqthFYdU6TbY
COSAccessToken=109dbb14ca0c30ef4b7e2fc9612f26788cadbfac3
COSAccessTokenExpire=2017-08-29T20:30:00

其中COSAccessTokenExpire 代表临时token过期时间，本地时间，格式需要和例子中一致
cosfs会根据这个时间来判断是否要重新加载配置来获取到最新的配置

其它三个参数需要向CAM申请获取

cosfs提供的功能和性能和本地文件系统相比，具有一些局限性。具体包括：

• 随机或者追加写文件会导致整个文件的重写。
• 元数据操作，例如list directory，性能较差，因为需要远程访问COS服务器。
• 文件/文件夹的rename操作不是原子的。
• 多个客户端挂载同一个COS bucket时，依赖用户自行协调各个客户端的行为。例如避免多个客户端写同一个文件等等。
• 不支持hard link。
• 不适合用在高并发读/写的场景，这样会让系统的load升高

• s3fs - 通过fuse接口，mount s3 bucket到本地文件系统。

Licensed under the GNU GPL version 2

• 如何挂载目录   在挂载命令的时候，可以指定目录，如

  cosfs appid:my-bucket:/my-dir /tmp/cosfs -ourl=http://cn-south.myqcloud.com -odbglevel=info -ouse_cache=/path/to/local_cache   注意，my-dir必须以/开头  

• 为什么之前可用写文件，突然不能写了？

  由于cos鉴权产品策略调整，所以老版本的cosfs工具会导致策略校验不过，因此需要拉取最新的cosfs工具重新mount

• 在centos6.5及较低版本，提示fuse版本太低，该如何解决？

  如在configure操作时，提示

    hecking for common_lib_checking... configure: error: Package requirements (fuse >= 2.8.4 libcurl >= 7.0 libxml-2.0 >=    2.6) were not met:
    Requested 'fuse >= 2.8.4' but version of fuse is 2.8.3 
  

  此时，你需要来手动安装fuse版本，具体步骤

    # yum remove -y fuse-devel
    # wget https://github.com/libfuse/libfuse/releases/download/fuse_2_9_4/fuse-2.8.4.tar.gz
    # tar -zxvf fuse-2.8.4.tar.gz
    # cd fuse-2.8.4
    # ./configure
    # make
    # make install
    # export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/lib64/pkgconfig/:/usr/local/lib/pkgconfig
    # modprobe fuse
    # echo "/usr/local/lib" >> /etc/ld.so.conf
    # ldconfig
    # pkg-config --modversion fuse   
    2.8.4   //看到版本表示安装成功