麒麟 V10 / ARM 部署：国产化信创环境怎么装？
如果你当前最关心的是“麒麟系统到底能不能跑 Rainbond，以及应该怎么开始部署”，那这页的重点不是再讲一遍平台愿景，而是先把环境可行性、安装路径和实施注意事项讲清楚。
- 麒麟 V10 + ARM 架构是 Rainbond 在国产化信创项目里很典型的一条落地路径，站内已经有对应的离线实操教程。
- 如果你的项目同时叠加了内网、离线和实施交付要求，优先顺着“环境确认 -> 离线包准备 -> 安装 -> 验证”这条线看，效率会更高。
你真正需要先确认的 3 件事
1. 先确认你是不是这条典型路径
这页最适合下面这类场景：
- 目标机器是 Arm64 / ARM 架构
- 目标系统是麒麟 V10 或同类国产化 Linux 发行版
- 项目环境在内网，或者最终需要按离线路径交付
如果你的环境并不满足这几个条件，比如已经有现成 Kubernetes 集群，或者只是做通用在线体验，那就不要把这页当成唯一入口。
2. 先确认联网条件，再决定看哪条安装资料
很多国产化信创项目不会只提出“CPU / OS 必须国产化”，还会进一步要求：
- 环境必须在内网
- 依赖包不能直接访问公网下载
- 安装过程需要可以沉淀为实施手册
这意味着你通常不应该先看通用快速安装命令，而应该先判断：
- 目标服务器本身能不能联网
- 是否需要先在可联网环境准备离线包
- 这次是做单机验证，还是后续要扩展成正式交付
3. 先确认安装起点，不要一上来就抄命令
在 ARM / 麒麟环境里，最先要分清的是：
- 这次是从主机开始把 K8s 和 Rainbond 一起装起来
- 还是已经有 Kubernetes，只需要继续安装 Rainbond
- 还是除了安装，还要考虑后续源码构建和应用迁移
如果要照着“保姆级教程”落地，最短路径是什么
1. 先确认目 标环境
如果你的目标是尽快在麒麟 V10 上把一套可用环境跑起来，先把下面几件事定清楚：
| 架构 | OS | 作用 |
|---|---|---|
| Arm64 | 麒麟 V10 | 目标安装环境，单机部署 K8s 和 Rainbond |
| Arm64 | 可联网 Linux 环境 | 当目标机完全离线时，用来准备 ROI 离线包 |
如果目标机器本身可以联网，离线包准备和安装可以在同一台机器上完成；如果目标机器完全离线，就先把下载环境和目标环境分开。
2. 按 ROI 路径准备离线包
你现在最该看的，不是零散的 RKE2、Helm 和镜像命令，而是先把 ROI 离线包准备完整：
curl -o roi https://get.rainbond.com/roi/roi-arm64 && chmod +x roi
./roi download
这一步的意义是先把安装链路需要的资源一次性准备好，避免进了离线环境再回头补包。
3. 先用单机模式跑通最短安装路径
如果你当前阶段是做环境可行性验证，最短路径就是先把单机安装跑通：
./roi up --single
这一步会把 K8s 和 Rainbond 一起装起来。对于大多数“先验证国产化环境能不能跑”的项目来说，这比一开始就拆开研究每个组件更贴近真实目标。
4. 安装完成后先做控制台验证
安装成功后，先做最基本的两层确认：
- 日志里是否已经给出控制台访问入口
- Kubernetes 与 Rainbond 组件是否正常启动
export KUBECONFIG=/etc/rancher/rke2/rke2.yaml
/var/lib/rancher/rke2/bin/kubectl get pods -A
然后再去控制台完成注册、登录和基础验证。对这类项目来说，看到控制台能打开只是开始，最好再确认一次平台组件状态。
5. 需要源码构建时，再继续补下一步
如果你后面还要在离线环境里做源码构建，不要把这个动作混进主安装流程里，而是安装完成后再继续补：
./roi addon sourcebuild
这样更符合真实项目节奏：先把平台装起来，再补应用构建能力。
常见注意事项
- 如果项目一开始就确定是内网或离线环境，优先从 ROI 离线包准备和离线路径入手，不要先看通用快速安装
- 如果你的目标就是“按步骤把环境装起来”，直接进入教程会比停留在专题页更高效
- 如果你已经有 Kubernetes 集群，不要直接照抄单机教程，最好同时结合多架构安装文档一起判断
- 如果你还同时面对应用迁移问题，建议继续看本专题里的 x86 到 ARM 迁移
- 如果你是零基础或要给实施同学交接，优先用“环境确认 -> ROI 离线包准备 -> 单机安装 -> 控制台验证 -> 源码构建补充”这条顺序，不要来回跳读
- 如果你要在离线环境里用源码构建，记得把它当成安装后的下一步，而不是把所有动作一次堆到同一篇文档里
案例区
麒麟 V10 离线部署保姆级教程
从环境准备到控制台验证，按步骤带你把麒麟 V10 离线路径完整跑通。
一云多芯与多架构安装
如果你不是单机验证，而是异构集群或已有 K8s 环境，先看这里判断安装方式。
x86 到 ARM 迁移
如果你装平台只是第一步，下一步要迁移已有应用，就继续看这条专题路径。
FAQ
1. 我应该先看专题页，还是直接看教程？
如果你还在判断“这是不是我的场景、该走哪条路径”，先看这页；
如果你的目标环境已经很明确，就是麒麟 V10 单机离线部署，那直接看教程更省时间。
2. 我应该先看快速安装还是离线安装？
如果项目环境本身就是内网和离线条件，直接看离线安装更贴近真实情况；
如果你只是做通用在线体验，快速安装文档会更合适。
3. 只解决安装够吗？
不够。国产化信创项目往往还会继续进入源码构建、应用迁移、标准化交付和后续升级阶段，所以安装只是起点。
4. 这条路适合零基础团队吗？
如果你要的是“按保姆级教程一步步做完”，是适合的。
但前提仍然是先把目标环境信息、离线包和安装路径准备好，不要边做边补环境信息。
下一步动作
如果你已经确认目标环境就是麒麟 V10 / ARM，不要继续泛看资料，直接进入教程或离线路径文档。