入门指南

本节将引导您完成从首次下载到运行中的 Alluxio 集群并验证数据访问的全过程。每个安装指南均自包含，涵盖集群部署、存储挂载和初步验证。

部署内容概览

一个 Alluxio 集群由三类组件构成：

组件	职责	数量
Worker	将数据缓存在本地 NVMe/SSD 上，直接向客户端提供读服务	1+
Coordinator	后台任务：缓存加载、挂载表管理、Worker 健康监控	1
etcd	集群成员管理和挂载表存储	3（生产），1（测试）

集群部署完成后，您的应用通过 FUSE（本地文件系统挂载）、S3 API（HTTP，S3 兼容）或 Python FSSpec 访问数据。各访问方式在集群启动后单独配置——安装指南仅涵盖集群本身的部署。

开始前需要准备

硬件、操作系统、网络端口和资源规格要求，请参阅先决条件。

• Alluxio 下载链接 — 包含 Docker 镜像 .tar 文件和 License 字符串。

• 私有 Docker 镜像仓库（仅 Kubernetes）— 镜像需推送至集群节点可访问的仓库后才能部署。Docker / 裸机部署无需私有仓库，直接在每台主机上 docker load 即可。

• 存储后端就绪 — S3 存储桶（含凭据）、GCS、HDFS 或其他受支持的 UFS。完整列表请参阅底层存储。

选择安装指南

	Kubernetes（Operator）	Docker / 裸机
适用场景	已有 Kubernetes 集群	Linux 主机、EC2 实例或 Slurm——无 Kubernetes

两条路径部署的集群完全一致，选择取决于您的基础设施环境。

云平台专用指南建立在 Kubernetes 路径之上：

• OCI OKE —— Oracle Cloud Infrastructure Kubernetes Engine，包含 VCN 配置、OCIR 镜像推送和 oci-bv Worker page store 配置。

AI 辅助部署

• AI 辅助部署指南 — 一个 Claude Code 技能，会询问你的环境情况并生成个性化的分步部署计划。适合 Alluxio 新手或希望获得全程引导的用户。