141 lines
5.0 KiB
Markdown
141 lines
5.0 KiB
Markdown
以下是 Mountpoint for Amazon S3 的安装和与 S3 兼容服务（如 RustFS）配合使用的教程。
|
||
|
||
### 1. 安装 Mountpoint
|
||
|
||
Mountpoint 提供预编译的安装包，支持多种 Linux 发行版。
|
||
|
||
* **Ubuntu / Debian (基于 DEB)**
|
||
```bash
|
||
# 下载适用于 x86_64 架构的 .deb 包
|
||
wget https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.deb
|
||
# 安装
|
||
sudo apt-get install -y ./mount-s3.deb
|
||
```
|
||
对于 ARM64 架构，将 URL 中的 `x86_64` 替换为 `arm64`。
|
||
|
||
* **Amazon Linux / RHEL / CentOS (基于 RPM)**
|
||
```bash
|
||
# 下载适用于 x86_64 架构的 .rpm 包
|
||
wget https://s3.amazonaws.com/mountpoint-s3-release/latest/x86_64/mount-s3.rpm
|
||
# 安装
|
||
sudo yum install -y ./mount-s3.rpm
|
||
```
|
||
对于 ARM64 架构，将 URL 中的 `x86_64` 替换为 `arm64`。
|
||
|
||
* **验证安装**
|
||
安装完成后，运行以下命令验证是否成功：
|
||
```bash
|
||
mount-s3 --version
|
||
```
|
||
如果安装成功，会输出版本信息，例如 `mount-s3 1.21.0`。
|
||
|
||
### 2. 配置访问凭证
|
||
|
||
Mountpoint 使用与 AWS CLI 相同的方式发现凭证。对于自建的 S3 服务，你需要通过环境变量提供访问密钥：
|
||
|
||
```bash
|
||
export AWS_ACCESS_KEY_ID=myaccesskey
|
||
export AWS_SECRET_ACCESS_KEY=mysecretkey
|
||
export AWS_ENDPOINT_URL=http://你的RustFS服务IP:9000
|
||
```
|
||
Mountpoint 会自动读取这些环境变量。
|
||
|
||
### 3. 挂载存储桶
|
||
|
||
#### 3.1 基础挂载（适用于 AWS S3）
|
||
|
||
如果你的目标是标准的 AWS S3，挂载命令非常简单：
|
||
```bash
|
||
mkdir ~/mnt
|
||
mount-s3 my-bucket ~/mnt
|
||
```
|
||
此时，`~/mnt` 目录就成为了你 S3 存储桶的挂载点。
|
||
|
||
#### 3.2 挂载到 S3 兼容服务（如 RustFS）
|
||
|
||
对于非 AWS 的 S3 兼容服务，**必须指定服务端点（Endpoint）**。
|
||
|
||
Mountpoint 提供两种方式：
|
||
|
||
* **方式一：使用命令行参数 `--endpoint-url`**
|
||
```bash
|
||
mount-s3 my-bucket ~/mnt --endpoint-url http://你的RustFS服务IP:9000
|
||
```
|
||
|
||
* **方式二：使用环境变量 `AWS_ENDPOINT_URL`（推荐）**
|
||
这种方式更便于在容器或脚本中统一管理配置。
|
||
```bash
|
||
export AWS_ENDPOINT_URL=http://你的RustFS服务IP:9000
|
||
mount-s3 my-bucket ~/mnt
|
||
```
|
||
|
||
> **注意**：Mountpoint 默认使用 `virtual-hosted-style` 的请求方式。如果你的 S3 服务（如 RustFS）不支持这种样式，可能会遇到 DNS 解析问题。此时，你可能需要在挂载时添加 `--endpoint-url` 参数，并确保其指向正确的服务地址。
|
||
|
||
### 4. 启用 10GB 本地缓存
|
||
|
||
Mountpoint 支持可选的本地缓存，用于加速对热点数据的重复读取。它的工作模式是按需加载，只有被访问过的数据才会被缓存。
|
||
|
||
你可以通过以下参数启用并限制缓存大小：
|
||
|
||
* `--cache <目录>`：指定缓存数据存放的本地目录。
|
||
* `--max-cache-size <大小>`：**以 MiB 为单位**设置缓存的最大容量。缓存淘汰策略为 **LRU（最近最少使用）**。
|
||
|
||
**挂载命令示例（10GB = 10240 MiB）：**
|
||
|
||
```bash
|
||
# 创建缓存目录
|
||
mkdir ~/cache
|
||
|
||
# 挂载并启用缓存，限制最大10GB
|
||
mount-s3 my-bucket ~/mnt \
|
||
--endpoint-url http://你的RustFS服务IP:9000 \
|
||
--cache ~/cache \
|
||
--max-cache-size 10240
|
||
```
|
||
|
||
当缓存占满后，Mountpoint 会自动淘汰最久未使用的数据以腾出空间。
|
||
|
||
### 5. 其他常用选项
|
||
|
||
* **元数据缓存 (`--metadata-ttl`)**：缓存文件的元数据（如大小、存在性），可减少对 S3 的请求。但需要注意，这可能会使外部对文件的修改无法及时看到。
|
||
* **后台运行**：`mount-s3` 命令默认在后台运行，不会阻塞终端。
|
||
* **卸载挂载点**：
|
||
```bash
|
||
umount ~/mnt
|
||
```
|
||
如果权限不足，可能需要使用 `sudo`。
|
||
|
||
### 6. 核心注意事项
|
||
|
||
1. **缓存仅加速读取**：本地缓存**仅对读取操作生效**。所有的写入（创建、修改、删除）操作都会**直接提交到后端的 S3 服务**，不会先写入缓存。
|
||
2. **非完整 POSIX 兼容**：Mountpoint 并非一个完整的 POSIX 文件系统，它针对高吞吐量的读写访问进行了优化。一些依赖复杂文件系统特性（如文件锁、稀疏文件等）的应用可能无法正常工作。
|
||
3. **权限问题**：如果遇到权限错误，可以尝试在挂载命令中添加 `--allow-other` 参数，允许其他用户访问挂载点。
|
||
|
||
### 7. 在 Docker 容器中使用
|
||
|
||
Mountpoint 也提供了官方 Docker 镜像，方便在容器化环境中使用。
|
||
|
||
```bash
|
||
# 拉取镜像
|
||
docker pull public.ecr.aws/mountpoint-s3/mountpoint-s3
|
||
|
||
# 运行容器并挂载
|
||
docker run -it --rm \
|
||
--cap-add SYS_ADMIN \
|
||
--device /dev/fuse \
|
||
-e AWS_ACCESS_KEY_ID=myaccesskey \
|
||
-e AWS_SECRET_ACCESS_KEY=mysecretkey \
|
||
-e AWS_ENDPOINT_URL=http://你的RustFS服务IP:9000 \
|
||
public.ecr.aws/mountpoint-s3/mountpoint-s3 \
|
||
my-bucket /mnt
|
||
```
|
||
注意，运行需要添加 `--cap-add SYS_ADMIN` 和 `--device /dev/fuse` 权限。
|
||
|
||
|
||
|
||
## 查询所有挂载
|
||
mount | grep mountpoint-s3
|
||
|
||
|
||
## 取消挂载
|
||
umount |