Goofys

简介

Goofys是一个开源的使用Go编写的存储桶挂载工具，允许Linux和macOS挂载KS3存储桶在本地文件系统，即可像访问本地文件系统一样访问KS3存储桶，Goofys能够保持对象原来的格式。

前期准备

• 创建金山云账号，开通金山云对象存储KS3服务。
• 获取当前账号的AccessKey和SecretKey信息。
• 了解KS3的Endpoint信息。

安装

方式一：使用Go语言安装

主要面向开发人员安装，详细步骤如下：

安装FUSE

1. 执行以下命令下载安装包：

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

2. 执行以下命令安装FUSE：

sudo yum install fuse

下载Go语言

Goofys采用Go语言编写，所以依赖Go的运行环境。

1. 执行以下命令下载Go版本包：go1.15.linux-amd64.tar.gz

wget https://golang.google.cn/dl/go1.15.linux-amd64.tar.gz

2. 执行以下命令解压安装包：

tar -C /usr/local -xzf go1.15.linux-amd64.tar.gz

3. 执行以下命令创建Go的工作目录：

mkdir /opt/gowork

4. 设置Go的环境变量配置，首先执行以下命令进入/etc/profile：

vim /etc/profile //打开文件
a //进入插入模式

5. 执行以下命令配置环境变量参数：

export GOPATH=/opt/gowork
export PATH=$PATH:/usr/local/go/bin
// 按【Esc】键退出插入模式
:wq // 保存并退出

6. 执行以下命令使得配置生效：

source /etc/profile

7. 执行以下命令，可以查看Go的版本：

go version

输出示例如下：

go version go1.15 linux/amd64

安装Goofys

1. 执行以下命令设置Go的工作目录：

export GOPATH=$HOME/work

2. 执行以下命令去拉取Goofys：

go get github.com/kahing/goofys

注意：由于网络原因，此时可能会报错，需要VPN才可下载GitHub的仓库。

3. 执行以下命令安装Goofys：

go install github.com/kahing/goofys

方式二：直接下载安装

主要面向非开发人员安装，详细安装步骤如下：

1. 执行以下命令直接下载编译好的Goofys：

wget https://github.com/kahing/goofys/releases/latest/download/goofys

2. 执行以下命令赋予执行权限：

chmod +x goofys

3. 执行以下命令输出Goofys的版本：

./goofys -version

输出示例如下：

goofys version 0.24.0-45b8d78375af1b24604439d2e60c567654bcdf88

配置

• 挂载

1. 执行以下命令创建.aws目录：

mkdir .aws

2. 执行以下命令进入.aws目录：

cd .aws

3. 执行以下命令创建文件credentials：

vi credentials

  文件配置信息如下：

[default]
aws_access_key_id = AK
aws_secret_access_key = SK

配置项说明：

• aws_access_key_id：输入访问密钥信息AccessKey，可在金山云控制台的访问控制页面获取。
• aws_secret_access_key：输入访问密钥信息SecretKey，可在金山云控制台的访问控制页面获取。

4. 执行以下命令进入Goofys目录：

cd goofys

5. 执行以下命令为Goofys设置权限：

chmod +x goofys

6. 执行以下命令挂载存储桶：

goofys --subdomain --endpoint=https://[KS3 ENDPOINT] [挂载存储桶名称] [挂载目录]

示例：

goofys --subdomain --endpoint=https://ks3-cn-beijing.ksyuncs.com test-auto-bucket /mnt/  //将test-auto-bucket存储桶挂载到/mnt/目录下

7. 执行以下命令查看挂载结果：

df -h

注：挂载结果显示的Bucket容量为虚拟数值，KS3 Bucket实际无容量限制。

挂载成功显示结果如下所示：

8. 执行以下命令进入/mnt/目录，即可查看桶内文件：

cd /mnt/

• 卸载

1. 执行以下命令卸载存储桶：

umount auto-test-bucket

2. 查看是否卸载成功：

df -h

下图所示表明已卸载成功：

常见问题

• 查看工具日志

输入以下命令查看工具日志：

vi /var/log/syslog

• 挂载调试模式

输入以下命令挂载调试：

goofys --subdomain --endpoint=https://[KS3 ENDPOINT] [挂载存储桶名称] [挂载目录] --debug_s3 --debug_fuse