前言：

RainlyStack 作为欢雨科技自主研发的公有云管理系统，具备功能强大、运维便捷等优势，其中 KVM 节点类型凭借稳定的性能成为多数用户的首选。本文专为需要快速搭建主控+KVM被控环境的用户设计，提供一站式一键部署指南，规避部署过程中的常见踩坑点，助力用户高效完成环境搭建。

一、 部署环境要求：筑牢搭建基础

环境配置是部署成功的核心前提，需严格遵循以下要求，避免因配置不当导致部署失败或功能异常。

1. 服务器基础规范

• 系统纯净度：一键部署（主控+被控）或单独部署被控，必须使用「全新服务器」；仅部署主控需确保 3306（MySQL）、6379（Redis）端口未被占用。
• 宝塔冲突解决：若主控服务器已安装宝塔，可能出现 Python 环境变量、软链路异常，需在 SSH 执行 bt 命令修复宝塔面板。
• 操作系统：推荐 CentOS 8 Stream、Rocky-Linux 8.10（强烈建议，兼容性最佳），需为干净系统（无其他预装环境）。

2. 硬件与存储配置

• 硬盘分区：建议将所有容量分配至根目录（/），SWAP 分区预留总内存的 1/2。
• 内存建议：主控若安装在虚拟机，内存不低于 4GB（可根据后续创建的虚拟机数量调整，越多越好）。

3. 端口放行要求

需在服务器安全组、防火墙中放行以下端口，否则将影响服务正常运行：

• Rainly_Control 主控服务：HTTPS 443 端口
• Rainly_Node 被控服务：HTTPS 8443 端口
• Rainly_VNC 控制台：5900-7000 端口（可根据需求预留更多）

二、 前置操作：一键更换国内源

为避免因源站问题导致组件缺失，部署前需优先更换国内优质源，推荐使用腾讯云源（不推荐学校源站）。

SSH 中执行以下命令一键换源：

curl -O https://www.rainly.net/stack/linux_mirror.sh && chmod +x linux_mirror.sh && ./linux_mirror.sh

三、 一键部署脚本：分场景精准执行

SSH 进入已准备好的服务器，根据服务器地域（国内/海外）选择对应脚本，仅执行其中一个即可，重复执行会导致系统异常。

1. 主控+KVM被控 一键部署（推荐，快速上手）

适用系统：Centos 8 Stream / Rocky-Linux 8.10

• 国内服务器专用：

  curl -O https://www.rainly.net/stack/install && chmod +x install && ./install

• 国外服务器专用：

  curl -O https://www.rainly.net/stack/install_abroad && chmod +x install_abroad && ./install_abroad

2. 单独部署（按需选择）

• 仅安装 WEB 主控：

  curl -O https://www.rainly.net/stack/install_web && chmod +x install_web && ./install_web

• 仅安装 KVM 被控：

  curl -O https://www.rainly.net/stack/install_kvm && chmod +x install_kvm && ./install_kvm

四、 部署后必做操作：保障系统正常运行

部署完成后需完成以下操作，否则系统无法正常使用，重点注意环境保护与授权配置。

1. 核心信息保管

部署完成后，会输出后台登录地址、账号密码等信息，请妥善保管，后续登录需用到。

2. 系统环境保护

禁止擅自更新服务器系统，否则可能破坏 Python 环境变量，导致 RainlyStack 无法运行。

3. 本地许可授权

系统采用本地许可授权（无需联网），授权流程请参考单独文档：《RainlyStack 授权教程》，未授权将无法使用核心功能。

4. 系统镜像下载

授权完成后，需下载系统镜像（脚本已集成 Windows/Linux 共 30+ 种镜像），参考文档：《RainlyStack KVM镜像 一键下载》。

五、 常见问题提醒：规避部署风险

• 部署失败大概率是端口被占用、系统环境不纯净或源站异常，优先检查端口和换源操作。
• 海外服务器务必使用带「abroad」后缀的脚本，否则可能因网络问题导致组件下载失败。

六、 使用说明：典型场景快速上手

以下为两种高频使用场景的操作指南，无需复杂配置，按需设置即可快速启用对应功能。

案例一：游戏云/挂机宝（NAT转发）

无需额外配置，创建虚拟机时直接设置好NAT转发数量，即可完成部署，省去手动配置IP地址的繁琐操作，全程极简高效。

案例二：独立IP云服务器

需先进入「IP管理」模块设置IP信息，支持批量添加IP段范围，也可单独配置VLAN，灵活适配不同网络需求。

七、 常见问题与解决方案

汇总高频问题及解决办法，遇到异常可优先查阅，快速排查故障。

1. 单独部署被控对接已有主控

操作步骤：进入主控后台 → 节点管理 → 填写被控IP地址（格式：IP:8443，例：127.0.0.1:8443） → 输入被控节点Apikey → 完成对接。

2. 主控HTTPS服务说明

主控HTTPS服务采用Golang自带监听服务，不依赖Nginx、Apache等第三方软件，减少环境冲突风险。

3. 启动失败排查

优先检查3306（MySQL）、6379（Redis）等核心端口是否正常监听，端口被占用会导致服务启动失败。

4. 常用服务重启命令（解决多数异常）

• 主控服务（WEB无法访问时）：

  systemctl restart rainly_control

• 被控服务（自动化操作异常时）：

  systemctl restart rainly_node

• 自动定时服务（任务状态不更新时）：

  systemctl restart crond

• 虚拟化套件（自动化失效时）：

  systemctl restart libvird

5. 问题反馈渠道

若遇到安全风险或不可控BUG，可加入QQ群 1011287901 及时反馈，获取技术支持。

结语：

本文通过清晰的步骤拆解，为你提供了 RainlyStack 主控+KVM被控的完整部署指南，从环境配置到后续操作均已覆盖关键要点。按照教程逐步执行，即可快速完成环境搭建，开启高效的云管理体验。若部署过程中遇到特殊问题，可联系官方技术支持获取进一步协助。