> For the complete documentation index, see [llms.txt](https://documentation.alluxio.io/ee-ai-cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.alluxio.io/ee-ai-cn/start.md).

# 入门指南

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

## 部署内容概览

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

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

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

## 开始前需要准备

硬件、操作系统、网络端口和资源规格要求，请参阅[先决条件](/ee-ai-cn/start/prerequisites.md)。

* **Alluxio 下载链接** — 包含 Docker 镜像 `.tar` 文件和 License 字符串。
* **私有 Docker 镜像仓库**（*仅 Kubernetes*）— 镜像需推送至集群节点可访问的仓库后才能部署。Docker / 裸机部署无需私有仓库，直接在每台主机上 `docker load` 即可。
* **存储后端就绪** — S3 存储桶（含凭据）、GCS、HDFS 或其他受支持的 UFS。完整列表请参阅[底层存储](/ee-ai-cn/ufs.md)。

## 选择安装指南

|          | [Kubernetes（Operator）](/ee-ai-cn/start/installing-on-kubernetes.md) | [Docker / 裸机](/ee-ai-cn/start/installing-on-docker.md) |
| -------- | ------------------------------------------------------------------- | ------------------------------------------------------ |
| **适用场景** | 已有 Kubernetes 集群                                                    | Linux 主机、EC2 实例或 Slurm——无 Kubernetes                   |

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

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

* [OCI OKE](/ee-ai-cn/start/installing-on-kubernetes/oci-oke.md) —— Oracle Cloud Infrastructure Kubernetes Engine，包含 VCN 配置、OCIR 镜像推送和 `oci-bv` Worker page store 配置。

## AI 辅助部署

* [AI 辅助部署指南](/ee-ai-cn/start/ai-assisted-deployment-guide.md) — 一个 Claude Code 技能，会询问你的环境情况并生成个性化的分步部署计划。适合 Alluxio 新手或希望获得全程引导的用户。