{message type="info" content="核心说明：本教程适用于从魔方云迁移至 RainlyStack，迁移原理为通过魔方云 API 读取原机器信息，建议提前确保魔方云为「主控与被控分离」架构，避免迁移过程中出现数据冲突。"/}

一、迁移前准备迁移前需完成3项基础配置，分别操作不同服务器，务必逐一落实：1. 搭建 RainlyStack 全新主控（单独服务器）准备一台未部署过其他面板的全新服务器，通过 SSH 连接后，执行以下命令一键安装主控：curl -O https://www.rainly.net/stack/install_webchmod +x install_web./install_web

{message type="info" content="等待安装完成，记录主控服务器 IP（后续配置需用到）。"/}

2. 清理原魔方云被控节点（原魔方云服务器）操作对象为原魔方云的被控服务器，步骤如下：1. 先关闭服务器上所有虚拟机（避免迁移中数据丢失）；2. 执行以下命令，仅卸载魔方云节点（保留系统及数据）：curl -o /root/zjmf_uninstall https://www.rainly.net/stack/zjmf_uninstallchmod +x /root/zjmf_uninstall./zjmf_uninstall3. 搭建 RainlyStack 被控（原魔方云服务器）卸载魔方云节点后，在同一台服务器上安装 RainlyStack 被控，执行命令：curl -O https://www.rainly.net/stack/install_kvmchmod +x install_kvm./install_kvm二、配置 MySQL 远程访问（RainlyStack 主控服务器）为实现数据迁移，需临时开启主控 MySQL 远程访问权限，步骤如下：1. 先获取 MySQL 数据库密码，执行命令：cat /home/rainly/main/control/config.json（从输出内容中提取 MySQL 密码，复制备用）2. 登录 MySQL 并修改访问权限，依次执行以下命令：

登录数据库（回车后输入上述密码）

mysql -uroot -p

允许 root 远程访问

UPDATE mysql.user SET host = '%' WHERE user = 'root' AND host = 'localhost';

刷新权限使配置生效

FLUSH PRIVILEGES;三、执行数据迁移（原魔方云服务器）所有准备工作完成后，在原魔方云服务器（已安装 RainlyStack 被控）上执行迁移操作：1. 下载并解压迁移脚本curl -o /home/moveZJMF.tar.gz https://www.rainly.net/stack/moveZJMF.tar.gztar -zxvf /home/moveZJMF.tar.gz -C /home（将迁移脚本解压到 /home 目录，解压完成后会生成 moveZJMF 文件夹）chmod +x /home/moveZJMF/move_web（赋予迁移脚本执行权限，避免后续运行时提示权限不足）2. 配置迁移参数编辑迁移配置文件，填写 RainlyStack 主控相关信息，执行命令：vi /home/moveZJMF/.env在打开的文件中，配置以下核心参数（按实际信息填写）：RainlyStack 主控 IP 地址MySQL 数据库用户名（默认 root）MySQL 数据库密码（前文获取的密码）配置完成后，按 Esc 键，输入 :wq 保存并退出。3. 启动迁移先确认：魔方云主控上的 IP 信息与 RainlyStack 主控 IP 一致（避免网络不通），确认无误后执行：cd /home/moveZJMF（进入迁移脚本所在目录，确保后续命令可正常执行）./move_web迁移过程中请勿中断 SSH 连接，等待终端显示「迁移完成」提示即可。四、迁移后配置与问题排查1. 关闭 MySQL 远程访问（必做）迁移完成后，为保障数据库安全，需关闭远程访问权限，操作如下（RainlyStack 主控服务器）：mysql -uroot -p（输入 MySQL 密码，登录数据库）UPDATE mysql.user SET host = 'localhost' WHERE user = 'root' AND host = 'localhost';（恢复本地访问权限，关闭远程连接）FLUSH PRIVILEGES;（刷新权限，确保配置生效）exit（退出 MySQL 数据库，完成权限调整）2. 网络不稳定问题排查若迁移后出现网络断断续续、不稳定，大概率是镜像源下载不完整或防火墙拦截导致，执行以下命令可解决（被控服务器）：dnf install net-tools -y（安装网络工具，用于后续网络排查，-y 参数自动确认安装）systemctl stop firewalld（关闭防火墙，避免拦截内部网络连接）

执行完成后，重启网络服务（systemctl restart network），网络通常可恢复稳定。

systemctl restart network五、迁移完成验证迁移成功后，可通过以下方式验证：登录 RainlyStack 主控后台，查看是否已同步原魔方云的虚拟机、节点等信息；启动一台虚拟机，测试网络连接、功能运行是否正常；若出现数据缺失或功能异常，可联系管理员协助排查。

前置条件已部署完成 RainlyStack 主控端和被控端。如果尚未部署，请先参考我们的 部署安装。核心概念

本教程介绍的是 本地许可验证 方式。

优点：只需验证一次，后续永久有效。即使服务器断网，授权也不受影响，确保业务稳定性。限制：由于授权是绑定在本地机器上的，不支持更改主控域名。请在第一次部署时就确定好主控域名。步骤一：获取主控 Apikey通过 SSH 连接到你的主控服务器。

执行以下命令，即可在输出中找到你的 Apikey：

cat /home/rainly/main/control/config.json注意：此 Apikey 将在后续发送本地授权时使用，请妥善保管。步骤二：进行本地授权（推荐方式）

此方式适用于大多数有公网 IP 的场景。

注册账号：访问 RainlyLicense 官方网站，注册一个账号。发起授权：在网站上使用你的 Apikey 发起本地授权请求。

完成实名认证：

系统将引导你进行实名认证。重要提示：目前采用 微信人脸实名认证 方式。只要是合法公民，均可通过。（下图为以前的手机号三要素实名认证，现已升级为人脸核身）

验证成功：当页面显示“授权成功”或类似成功提示时，即代表操作完成。步骤三：手动进行授权（无公网 IP 场景）

如果你的服务器没有公网 IP，或者你希望手动管理授权，可以使用此方式。

获取密钥：在 RainlyLicense 网站的授权管理页面，找到并复制以下三个密钥信息：

LicenseKeySymmetricKeySignatureKey

配置主控后台：

登录到你的主控后台。进入 系统设置。将上述三个密钥 分别 填入对应的输入框中。点击 保存。

配置本地密钥：

通过 SSH 连接到主控服务器。将获取到的本地密钥内容，复制并粘贴到文件 /home/rainly/main/control/public.pem 中。

注意：确保文件格式为 `.pem`。

重启服务：执行以下命令，使配置生效：

systemctl restart rainly_control总结

无论你选择哪种方式，只要授权验证成功（显示成功页面或服务重启成功），你的 RainlyStack 系统就已获得本地许可。如果在操作过程中有任何疑问，可以参考其他文档或联系技术支持。

一、所需文件（当前暂不支持下载）魔方财务对接插件：戳我下载{dotted startColor="#ff6c6c" endColor="#1989fa"/}魔方财务noVNC（可选）：戳我下载二、插件安装步骤1. 对接插件上传：将下载后的 rainlystack.tar.gz

解压，上传至服务器/public/plugins/server目录下，最终路径需确保为 /public/plugins/server/rainlystack/rainlystack.php{message type="warning" content="禁止多嵌套一层目录"/}

2. 可选组件安装（noVNC）：将 noVNC.tar.gz 解压后，直接上传至/public目录即可三、核心配置流程1. 添加服务器接口IP地址填写：主控域名（无需填写具体IP）密码填写：主控ApiKey

ApiKey查询方法：

登录主控SSH，执行命令cat /home/rainly/main/control/config.json

文件中对应的apikey字段值即为所需

2. 添加商品配置必须添加自定义字段：vserverid按页面提示设置可配置项，必填/选填标识已明确标注特殊设置：若开通公网IP服务器，需将“NAT转发数量”设置为 0

3. 弹性云配置（可选）若需启用弹性云功能，在产品配置页设置“弹性拖拉”参数

基础示例字段参考页面指引，其余参数可查阅配置说明文档

四、注意事项未启用弹性云时，仅需完成所有必填项填写，选填项可留空文件上传需确保路径准确，目录错误会导致插件无法加载ApiKey需妥善保管，泄露可能导致服务器权限风险

公网IP与NAT转发的配置冲突需避免，按实际服务器类型选择对应设置

五、以下是对接插件所有传递字段，key对应的就是

RainlyStack 提供标准RESTful API接口，支持跨程序调用，便于二次开发与功能集成，核心信息如下：1. 核心特性接口规范：采用标准RESTful设计，调用灵活，适配任意程序开发场景

调用参考：可参考服务器路径 /home/rainly/main/control/templates 模板文件内的AJAX方法，快速掌握调用方式{dotted startColor="#ff6c6c" endColor="#1989fa"/}

2. 文档信息API文档地址：戳我前往

前言：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 进入已准备好的服务器，根据服务器地域（国内/海外）选择对应脚本，仅执行其中一个即可，重复执行会导致系统异常。

{message type="warning" content="提示：被控节点不可与魔方云节点共生，若之前安装过魔方云，需先卸载再部署。"/}

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_abroad2. 单独部署（按需选择）

仅安装 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镜像 一键下载》。

{message type="warning" content="完成授权和镜像下载后，无需手动添加节点、镜像信息，可直接上手使用！"/}

五、 常见问题提醒：规避部署风险部署失败大概率是端口被占用、系统环境不纯净或源站异常，优先检查端口和换源操作。海外服务器务必使用带「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 libvird5. 问题反馈渠道

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

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