# 魔方财务手动对接操作教程(最新更新: 2026-10-16)

**URL:** <https://forum.rainyun.com/t/topic/13292>\
**Category:** 常见问题 FAQ\
**Created:** [2026 年7 月 15 日 18:54 UTC](https://forum.rainyun.com/t/topic/13292 "2026-07-15T18:54:52Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![竹林酱](https://forum.rainyun.com/user_avatar/forum.rainyun.com/%E7%AB%B9%E6%9E%97%E9%85%B1/32/12629_2.png) [@竹林酱](https://forum.rainyun.com/u/%E7%AB%B9%E6%9E%97%E9%85%B1)\
发布日期： [2026 年7 月 15 日 18:54 UTC](https://forum.rainyun.com/t/topic/13292/1 "2026-07-15T18:54:52Z")

</div>

> 对接模块最新更新可见github

本教程介绍雨云代理如何使用魔方财务模块手动对接雨云平台（有手动当然也有自动，不过自动还需要等待更新，目前仅支持手动，尽情期待）  
此外本教程需要具有一定魔方财务搭建和使用经验的人士阅读

另外还有视频教程也可以一起作为参考：

https://player.bilibili.com/player.html?bvid=BV18NJX6EEpN&high_quality=1&autoplay=0

## 1. 安装魔方财务

安装好了的可以跳过

> [https://docs.idcsmart.com/docs/财务系统使用文档/安装+升级+迁移/如何安装魔方财务](https://docs.idcsmart.com/docs/%E8%B4%A2%E5%8A%A1%E7%B3%BB%E7%BB%9F%E4%BD%BF%E7%94%A8%E6%96%87%E6%A1%A3/%E5%AE%89%E8%A3%85+%E5%8D%87%E7%BA%A7+%E8%BF%81%E7%A7%BB/%E5%A6%82%E4%BD%95%E5%AE%89%E8%A3%85%E9%AD%94%E6%96%B9%E8%B4%A2%E5%8A%A1)

## 2. 模块安装

模块下载和开源地址

云服务器

[https://github.com/runyutech/mofang-rcs](https://github.com/runyutech/mofang-rcs)

游戏云(VPS)

[https://github.com/runyutech/mofang-rgs](https://github.com/runyutech/mofang-rgs)

裸金属物理机

[https://github.com/runyutech/mofang-rbm](https://github.com/runyutech/mofang-rbm)

在魔方财务的public/plugins/servers路径下放入模块压缩包并解压

 ![image](https://forum.rainyun.com/uploads/default/original/2X/2/27a718666eb0d2ee9db5c6d27ee3fe617f1ad671.png)

## 3. 模块配置

解压完成后，打开你的魔方财务后台，打开：设置—\>商品设置—\>自动化接口—\>通用接口  
（手机端UI跟截图里的PC端有出入，但也大同小异，设置位置也是一样的）

 ![image](https://forum.rainyun.com/uploads/default/original/2X/9/91846441f7986445e7a776de6cff8473ab31ba99.png)

然后我们先创建一下接口分组， **云服务器和游戏云需要分别创建一个**

 ![image](https://forum.rainyun.com/uploads/default/original/2X/5/5c61828275876c42601eb0a5f2a1f9f5a2e27e3b.png)

分组名随意，你自己看得懂就可以了，然后提交保存

 ![image](https://forum.rainyun.com/uploads/default/original/2X/1/1c6412fd9183f25920765b56d984c5f8d1262efd.png)

然后我们再创建接口

 ![image](https://forum.rainyun.com/uploads/default/original/2X/2/244171d403b7032e832a455e8f5f57d46caec0e6.png)

其中：

- **名称** 随意，填一个你自己看得懂的就可以
- **IP地址** 随意填一点内容就可以（实际没有任何作用，只是魔方要求必填）
- **服务器模块** 选择对应的模块 Rainyun_Rcs_ 是云服务器 Rainyun_Rgs_ 是游戏云
- **接口数量** 随便填一个数字即可，没太大作用
- **主机名** 填：`https://api.v2.rainyun.com`
- **接口分组** 选择你刚才创建的对应分组
- **密码** 填你的雨云[API密钥](https://app.rainyun.com/account/settings/api-key)，可前往[这里](https://app.rainyun.com/account/settings/api-key)获取

其他没标注的都不需要管，直接提交保存即可

 ![image](https://forum.rainyun.com/uploads/default/original/2X/8/86c9952dede2ba829b450aa0009d9fa330485365.png)

对接成功后显示绿色✔图标

 ![image](https://forum.rainyun.com/uploads/default/original/2X/7/7c39e1ee7ea4a9137c5241606ad3fd510f148f83.png)

## 4. 商品配置

接着我们打开 设置—\>商品设置—\>商品配置—\>商品管理

需要先创建一下商品分组，这个自由发挥了，这里就简单示例，不需要完全模仿

 ![image](https://forum.rainyun.com/uploads/default/original/2X/7/715b83145fea652ee463c3bcb6f87fa16f4dbca4.png)

先要创建一个一级分组

 ![image](https://forum.rainyun.com/uploads/default/original/2X/b/b28603861c10eb9a4166892cd6b7e944df0963a3.png)

然后再次点击创建分组

![image](https://forum.rainyun.com/uploads/default/original/2X/0/059f099bbde8b9c1d704b55f9d66e660c2c8418c.png)

一级分组选择你刚才创建的就可以

 ![image](https://forum.rainyun.com/uploads/default/original/2X/b/ba4d00f3138c0c8708750231c92d41a12e3f6dc9.png)

然后我们新建商品

 ![image](https://forum.rainyun.com/uploads/default/original/2X/f/f5498d1f6d7bd080e7a94c90ddd231ee988c9338.png)

商品名称随意发挥，类型可以选择云服务器，商品组选择你上一步新建的就可以，会员中心导航栏分类就是你用户前台的控制台显示的分类，自由发挥即可

 ![image](https://forum.rainyun.com/uploads/default/original/2X/c/caccdbcacfd7ee68b28faea4d80a09929267ead7.png)

商品描述等自由发挥即可，_ **密码需要启用，然后必须勾选所有选项，长度填12-20** _（否则用户将无法重置密码）。然后打开购买是否需要实名的选项

 ![image](https://forum.rainyun.com/uploads/default/original/2X/9/915ac27076346f97da907896a299342f92008fd3.png)

然后是定价部分，付款类型选择周期，然后启用月付、季付、半年付、年付，填入套餐价格

 ![image](https://forum.rainyun.com/uploads/default/original/2X/4/450a619e69a6d337fbb24320381935467e381b8d.png)

### 云服务器配置部分

接着是云服务器自动开通部分，接口分组选择你刚创建的分组

然后这里只需要填写_ **套餐ID** _即可，其他都不需要管

开通方式选择付款后自动

> 套餐ID在官网购买页就有显示
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/4/43db02cf3bb2c4607803d254dbe91ad091172ac4.png)

 ![image](https://forum.rainyun.com/uploads/default/original/2X/8/895f86a788c8efa86432944b03e4ce9b833853d5.png)

然后是产品配置部分，点击添加配置项

 ![image](https://forum.rainyun.com/uploads/default/original/2X/f/ffd4170e7b9a0fe558b39d23612018239213c324.png)

> 我们先配置IP数量的选项
> 
> **配置选项名称** 填 `with_eip_num|IP数量`
> 
> **配置项类型** 选择 _数量(应用价格)_
> 
> **配置项名称** 也填一样的 `with_eip_num|IP数量`
> 
> （这里也会出现特殊IP的情况，推荐你只配置这个普通IP就好，如果需要配置特殊IP的这俩项填`with_eip_num_{特殊IP键名}|IP数量` 例如：`with_eip_num_sz_txip|腾讯多线BGP IP数量`）
> 
> 然后点击确认添加
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/0/0910e8e7494c650f0488792dda1b40a8bd904c11.png)
> 
> 最小值改成1，最大值看一下雨云官网最大能加到多少，一般是3，填入IP价格，然后保存更改就好了
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/f/f6d4fe53b6812af6ae6640510a99a385f6ed2b62.png)

> 然后我们配置系统选项，再次添加配置项
> 
> **配置选项名称** 填 `os_id|操作系统`
> 
> **配置项类型** 选择 _操作系统_
> 
> **配置项名称** 按 `{系统id}|{系统分组}^{系统版本名称}` 这个格式填写，例如`82|Debian^Debian 11`
> 
> 系统id等在官网购买页可以看到：
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/9/9941b38516bb5ac08f79a711f1677969330d8eab.png)
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/4/45431d37887059c9f2ff5087c6e40d280c94421d.png)

> 然后是硬盘类型，当然你也可以不配置，不配置会使用默认类型
> 
> **（如果对应区域官网硬盘类型只显示高速NVME和机械盘则此配置可以直接跳过：**
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/5/537df51e863c66f5148dd822a3a6801c6ca5afe0.png)
> 
> **）**
> 
> **配置选项名称** 填 `disk_type|硬盘类型`
> 
> **配置项类型** 选择 _单选_
> 
> **配置项名称** 根据区域支持的硬盘类型填写，支持什么类型看官网显示的就可以：
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/6/6400c41004d139a758e52bdf56ae8d29037abc24.png)
> 
> 根据官网显示的支持类型有下面这些选项：
> 
> `cloud-hdd|高效云盘`
> 
> `cloud-ssd|SSD云盘`
> 
> `ssd|高速NVME`
> 
> `hdd|机械盘`（一般不要配置，机械盘不能作为系统盘）
> 
> `chdd|系统机械`
> 
> （注意要官网对应区域有显示这个类型才是支持的，错误的配置会导致开通失败）
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/d/dfae169127dead147824d899ce5b38fea7815b9a.png)

### 游戏云配置部分

接着是游戏云自动开通部分，接口分组选择你刚创建的分组

_ **计费套餐ID** _ 填写官网的计费ID

**服务器类型** 如果是VPS则填写`kvm`，如果是雨云面板则填写`k8s_panel` (mcsm面板暂不支持对接)

> 计费套餐id在官网购买页处就有显示
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/7/721760af22e6c9f035455041d5bb00e4deb279ab.png)

开通方式选择付款后自动

 ![image](https://forum.rainyun.com/uploads/default/original/2X/7/7f35be5d3edba1cee3e292c6786b3c274a105369.png)

然后是产品配置部分，点击添加配置项

 ![image](https://forum.rainyun.com/uploads/default/original/2X/f/ffd4170e7b9a0fe558b39d23612018239213c324.png)

> 配置CPU，内存，系统盘等
> 
> 这些大同小异，这里就不一一操作了，如果遇到不懂的可以咨询竹林
> 
> 选项名称分别填写：  
> `cpu|CPU核心`
> 
> `memory|内存`
> 
> `base_disk|系统盘`
> 
> `data_disk|数据盘` (面板服不支持)
> 
> `net_out|上行宽带` (面板服不支持)
> 
> `egg_type_id|游戏` (仅面板服需要)
> 
> `online_mode|在线模式` (仅面板服需要，true|在线模式(正版)，false|离线模式)
> 
> 配置可以自由发挥，也可以参考：
> 
> 配置项类型
> 
> _面板服_
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/e/e8986e2b0f41dca46141022c1a9a081beddc9a9e.png)
> 
> _VPS_
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/5/5a5bd87350ffe8a5200bce09767a28c311f9fd4a.png)
> 
> 游戏云在不同的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数量`）
> 
> 然后点击确认添加
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/0/0910e8e7494c650f0488792dda1b40a8bd904c11.png)
> 
> 最小值改成1，最大值看一下雨云官网最大能加到多少，一般是3，填入IP价格，然后保存更改就好了
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/f/f6d4fe53b6812af6ae6640510a99a385f6ed2b62.png)

> _配置系统选项_
> 
> 再次添加配置项
> 
> **配置选项名称** 填 `os_id|操作系统`
> 
> **配置项类型** 选择 _操作系统_
> 
> **配置项名称** 按 `{系统id}|{系统分组}^{系统版本名称}` 这个格式填写，例如`82|Debian^Debian 11`
> 
> 系统id等在官网购买页可以看到：
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/9/9941b38516bb5ac08f79a711f1677969330d8eab.png)
> 
> ![image](https://forum.rainyun.com/uploads/default/original/2X/4/45431d37887059c9f2ff5087c6e40d280c94421d.png)

部分区域支持使用，你也可以给他启用试用，填入试用价格，试用条件建议至少打开实名认证防止滥用，试用时长雨云是1天，单个账户最大试用数量建议限制一下

 ![image](https://forum.rainyun.com/uploads/default/original/2X/9/94b3fb691059700595b6aab9535a2bfefda96a45.png)

配置好后,即可进行开通创建

请确保代理商余额充足,否则无法顺利开通

> 对接模块还在不断完善中,并且最新版本模块不一定兼容旧模块  
> 如有相关功能建议,可以发起工单反馈