对接模块最新更新可见github
本教程介绍雨云代理如何使用魔方财务模块手动对接雨云平台（有手动当然也有自动，不过自动还需要等待更新，目前仅支持手动，尽情期待）
此外本教程需要具有一定魔方财务搭建和使用经验的人士阅读
1. 安装魔方财务
安装好了的可以跳过
2. 模块安装
模块下载和开源地址
云服务器
游戏云(VPS)
裸金属物理机
在魔方财务的public/plugins/servers路径下放入模块压缩包并解压
3. 模块配置
解压完成后，打开你的魔方财务后台，打开：设置—>商品设置—>自动化接口—>通用接口
（手机端UI跟截图里的PC端有出入，但也大同小异，设置位置也是一样的）
然后我们先创建一下接口分组，云服务器和游戏云需要分别创建一个
分组名随意，你自己看得懂就可以了，然后提交保存
然后我们再创建接口
其中：
- 名称 随意，填一个你自己看得懂的就可以
- IP地址 随意填一点内容就可以（实际没有任何作用，只是魔方要求必填）
- 服务器模块 选择对应的模块 RainyunRcs 是云服务器 RainyunRgs 是游戏云
- 接口数量 随便填一个数字即可，没太大作用
- 主机名 填：
https://api.v2.rainyun.com - 接口分组 选择你刚才创建的对应分组
- 密码 填你的雨云API密钥，可前往这里获取
其他没标注的都不需要管，直接提交保存即可
对接成功后显示绿色
图标
4. 商品配置
接着我们打开 设置—>商品设置—>商品配置—>商品管理
需要先创建一下商品分组，这个自由发挥了，这里就简单示例，不需要完全模仿
先要创建一个一级分组
然后再次点击创建分组
一级分组选择你刚才创建的就可以
然后我们新建商品
商品名称随意发挥，类型可以选择云服务器，商品组选择你上一步新建的就可以，会员中心导航栏分类就是你用户前台的控制台显示的分类，自由发挥即可
商品描述等自由发挥即可，密码需要启用，然后必须勾选所有选项，长度填12-20（否则用户将无法重置密码）。然后打开购买是否需要实名的选项
然后是定价部分，付款类型选择周期，然后启用月付、季付、半年付、年付，填入套餐价格
云服务器配置部分
接着是云服务器自动开通部分，接口分组选择你刚创建的分组
然后这里只需要填写套餐ID即可，其他都不需要管
开通方式选择付款后自动
套餐ID在官网购买页就有显示
然后是产品配置部分，点击添加配置项
我们先配置IP数量的选项
配置选项名称 填
with_eip_num|IP数量配置项类型 选择 数量(应用价格)
配置项名称 也填一样的
with_eip_num|IP数量（这里也会出现特殊IP的情况，推荐你只配置这个普通IP就好，如果需要配置特殊IP的这俩项填
with_eip_num_{特殊IP键名}|IP数量例如：with_eip_num_sz_txip|腾讯多线BGP IP数量）然后点击确认添加
最小值改成1，最大值看一下雨云官网最大能加到多少，一般是3，填入IP价格，然后保存更改就好了
然后我们配置系统选项，再次添加配置项
配置选项名称 填
os_id|操作系统配置项类型 选择 操作系统
配置项名称 按
{系统id}|{系统分组}^{系统版本名称}这个格式填写，例如82|Debian^Debian 11系统id等在官网购买页可以看到：
然后是硬盘类型，当然你也可以不配置，不配置会使用默认类型
（如果对应区域官网硬盘类型只显示高速NVME和机械盘则此配置可以直接跳过：
）
配置选项名称 填
disk_type|硬盘类型配置项类型 选择 单选
配置项名称 根据区域支持的硬盘类型填写，支持什么类型看官网显示的就可以：
根据官网显示的支持类型有下面这些选项：
cloud-hdd|高效云盘
cloud-ssd|SSD云盘
ssd|高速NVME
hdd|机械盘（一遍不要配置，机械盘不能作为系统盘）
chdd|系统机械（注意要官网对应区域有显示这个类型才是支持的，错误的配置会导致开通失败）
游戏云配置部分
接着是游戏云自动开通部分，接口分组选择你刚创建的分组
计费套餐ID 填写官网的计费ID
服务器类型 如果是VPS则填写kvm，如果是雨云面板则填写k8s_panel (mcsm面板暂不支持对接)
计费套餐id在官网购买页处就有显示
开通方式选择付款后自动
然后是产品配置部分，点击添加配置项
配置CPU，内存，系统盘等
这些大同小异，这里就不一一操作了，如果遇到不懂的可以咨询竹林
选项名称分别填写：
cpu|CPU核心
memory|内存
base_disk|系统盘
data_disk|数据盘(面板服不支持)
net_out|上行宽带(面板服不支持)
egg_type_id|游戏(仅面板服需要)
online_mode|在线模式(仅面板服需要，true|在线模式(正版)，false|离线模式)配置可以自由发挥，也可以参考：
配置项类型
面板服
VPS
游戏云在不同的CPU下有不同的内存最大值
如果没有魔方专业版或者无法进行优雅设置,可以考虑使用套餐制来定义
配置IP数量的选项
配置选项名称 填
with_eip_num|IP数量配置项类型 选择 数量(应用价格)
配置项名称 也填一样的
with_eip_num|IP数量（这里也会出现特殊IP的情况，推荐你只配置这个普通IP就好，如果需要配置特殊IP的这俩项填
with_eip_num_{特殊IP键名}|IP数量例如：with_eip_num_sz_txip|腾讯多线BGP IP数量）然后点击确认添加
最小值改成1，最大值看一下雨云官网最大能加到多少，一般是3，填入IP价格，然后保存更改就好了
配置系统选项
再次添加配置项
配置选项名称 填
os_id|操作系统配置项类型 选择 操作系统
配置项名称 按
{系统id}|{系统分组}^{系统版本名称}这个格式填写，例如82|Debian^Debian 11系统id等在官网购买页可以看到：
部分区域支持使用，你也可以给他启用试用，填入试用价格，试用条件建议至少打开实名认证防止滥用，试用时长雨云是1天，单个账户最大试用数量建议限制一下
配置好后,即可进行开通创建
请确保代理商余额充足,否则无法顺利开通
对接模块还在不断完善中,并且最新版本模块不一定兼容旧模块
如有相关功能建议,可以发起工单反馈