顶联 DCIM 对接魔方V10
适用系统：魔方财务 v10（IDCsmart）
插件名称：Top-Link DCIM（toplink_dcim）
插件版本：v1.1.3
📖 一、插件概述
插件是干什么的？
什么情况下需要用它？
⚙️ 二、后台配置指引
2.1 第一步：添加接口，连接 DCIM 系统
| 配置项 | 作用 | 推荐填写值 |
|---|---|---|
| 接口名称 | 给这条接口起个名字，方便自己辨认 | 例如 Toplink-香港机房 |
| 地址 | Top-Link DCIM 系统的访问网址 | 例如 https://dcim.您的域名.com；必须以 http:// 或 https:// 开头，非 80 端口需带上端口号（末尾多打 / 没关系，系统会自动处理） |
| 用户名 | DCIM 系统生成的 API Key | 从 DCIM 管理端的 API 设置处复制粘贴 |
| 密码 | DCIM 系统生成的 API Secret | 从 DCIM 管理端复制粘贴；保存后系统会加密存储，无法明文查看 |
| 是否启用 | 该接口是否投入使用 | 启用 |
💡 小提示 对接的 DCIM 系统版本需为 1.5.x 及以上，版本过低时测试连接会提示「DCIM版本过低, 请升级到1.5.x」。 如果您使用的是 DCIM 的「经销商账号」，需要技术人员在接口的扩展参数中开启经销商模式并填写专用 API 地址，普通用户无需关心。
2.2 第二步：创建商品并配置售卖内容
| 选项卡 | 在这里配置什么 | 操作要点 |
|---|---|---|
| 周期设置 | 月付、季付、年付等计费周期及价格系数 | 点【添加周期】逐个添加；⚠️ 页面提示：「请注意，后续在配置周期价格时，所有周期均需填写价格，若不填写价格视为0」 |
| 数据中心配置 | 数据中心（国家 / 城市 / 机房名称）和线路 | 每条线路需选择计费方式：按带宽 或 按流量（想卖流量包必须选“按流量”）；可配置公网 IP 价格、防护（防御峰值）价格；流量填 0 表示不限流量 |
| 机型配置 | 客户可选的服务器规格 | 填写配置名称、关联套餐、处理器、内存、硬盘、显卡和各周期价格；可勾选「允许选配」「隐藏」 |
| 增值设置 | 可加购的内存 / 硬盘 / 显卡等硬件及价格 | 客户下单或后期升级时可自助加购 |
| 高级规则 | 配置之间的限制关系 | 例如“某机型不允许装某系统”；页面提示：「用户订购时，若命中规则中的某一配置项，则系统将根据限制规则展示配置」 |
| 操作系统 | 可供客户安装的系统镜像 | 点【拉取操作系统】从 DCIM 同步镜像，可设置分类、排序、是否收费（收费镜像客户需购买后才能重装） |
| 其他设置 | 客户自助功能的开关 | 见下方 2.3 节详解 |
⚠️ 注意：进入「数据中心配置」等页面配置价格前，请先保存好周期设置——页面也会提醒您：「配置价格前请确认是否保存了周期设置！」
图 3：商品编辑页【接口管理】标签——顶部为接口选择与「付款后自动开通」，下方为模块配置各选项卡（图中为「周期设置」）。
图 4：「数据中心配置 → 新增线路」弹窗——左侧「计费方式」下拉可选带宽计费 / 流量计费，下方为公网 IP 价格配置。
2.3 核心功能开关（「其他设置」选项卡）
| 开关名称 | 作用 | 推荐设置 |
|---|---|---|
| 控制服务器电源 | 客户可自助开机 / 关机 / 重启 | ✅ 开启 |
| 自助重装系统 | 客户可自助重装操作系统 | ✅ 开启 |
| 显示硬件信息 | 前台显示 CPU / 内存 / 硬盘等硬件详情 | ✅ 开启 |
| VNC 控制 | 前台显示「远程控制台」按钮 | ✅ 开启 |
| 显示端口速率 | 前台显示端口速率和流量统计 | 按需 |
| 允许设置主机名 | 客户可自助修改主机名 | ✅ 开启 |
| 暂停时关闭电源 | 业务被暂停（如到期 / 超流量）时自动关机 | 按需（超流量停机场景建议只断网不关机） |
| 暂停时关闭所有网络端口 | 业务被暂停时自动断网 | ✅ 建议开启 |
| 下架时关闭电源 / 关闭所有网络端口 | 产品删除下架时自动关机断网 | ✅ 建议开启 |
| 下架时删除所有 IP 地址 / 删除所有额外 IP 地址 | 下架时自动回收 IP 资源 | ✅ 建议开启 |
| 开通新机器时解绑旧机器的 IP 地址 / 分配时保留旧 IP 地址 | 换机场景下 IP 的处理方式 | 按需 |
| 允许自助断网 / 允许自助恢复联网 | 客户可自助控制联网状态 | 按需 |
| 手动分配资源 | 开启后商品将不会通过接口自动开通，需要管理员手动分配服务器（见 2.5 节） | 默认关闭 |
| 重置密码时需要短信验证 / 重装系统时需要短信验证 | 客户执行敏感操作前须输入手机验证码 | 按需（更安全） |
图 5：「其他设置」选项卡中的功能开关（控制服务器电源、自助重装系统、显示硬件信息、VNC 控制等）。
2.4 保存与启用：如何确认配置生效
1.
2.
3.
2.5 手动分配服务器（可选场景）
1.
2.
3.
4.
5.
2.6 流量包售卖配置（可选）
1.
2.
⚠️ 重要：需要技术人员做一次小改动
官方流量包插件在「关联商品」列表中默认不显示本 模块的商品。需让技术人员编辑文件public/plugins/addon/flow_packet/template/admin/js/traffic_package_manage.js，
在其中的商品模块白名单数组（搜索mf_cloud即可定位）里追加"toplink_dcim"，保存后后台页面按 Ctrl+F5 强制刷新即可。
每次升级或重装流量包插件后，这个改动会被覆盖，需要重新加回（表现为：新增流量包时又找不到本模块商品了）。已售出的流量包和客户购买流程不受影响。
图 9：流量包插件的新增/编辑弹窗——设置容量、售价、长期有效开关，「关联商品」中能正常选到本模块商品（图中已关联 DCIM）即表示补丁生效。
⚠️ 卸载警告：如果删除最后一个 Top-Link DCIM 接口，系统会自动清空该模块的全部配置数据（数据中心、线路、机型、价格、镜像等），且无法恢复。执行前请务必先备份数据库。
🖥️ 三、前端使用指南
3.1 如何购买服务器
1.
💡 页面提示：处于不同地域的产品内网不通，创建成功后不支持切换地域，建议选择最靠近您用户的地域，可降低访问时延。
2.
3.
4.
💡 注意：Windows 系统要求系统盘容量 27G 及以上；Linux 系统要求 8G 及以上。
5.
6.
7.
8.
图 10：下单页上半部分——基础配置（区域 / 可用数据中心）、机型配置表格，底部为时长、数量与实时价格栏。
图 11：下单页下半部分——网络配置（线路 / IP / 带宽）、系统配置（Windows / Linux 镜像）和自动续费选项。
3.2 进入「服务器管理面板」
图 12：会员中心产品列表——状态选项卡、筛选、每台服务器的电源状态图标、IP 和到期时间。
3.3 开机 / 关机 / 重启
1.
2.
3.
4.
图 14：点击电源按钮后的二次确认弹窗——「请确认对该服务器进行电源操作: ××」。
3.4 远程控制台（在网页里直接操作服务器）
1.
2.
3.
4.
3.5 重装操作系统
1.
2.
3.
4.
5.
⚠️ 重要提醒：重装会清空所选硬盘上的全部数据且无法恢复，请务必提前备份！若站点开启了短信验证，提交 时还需输入手机验证码。
3.6 重置密码
1.
2.
3.
3.7 救援模式（系统坏了进不去时的急救通道）
1.
2.
3.
3.8 修改主机名
3.9 查看硬件、网络与流量
3.10 购买流量包（按流量计费的产品）
1.
2.
3.
3.11 续费
1.
2.
3.
4.
3.12 安全事件提醒
❓ 四、常见问题与注意事项（FAQ）
👤 用户篇
您的产品是按带宽计费的，只有按流量计费的产品才能购买流量包。如需改为流量 计费，请联系客服。
您选择的操作系统是收费镜像（如 Windows 授权版），需先购买该镜像授权后才能安装；也可以改选免费系统。
您的服务器硬件配置与所选系统不兼容（站点设置了配置限制规则）。请换一个系统版本，或联系客服确认哪些系统可用。
最常见原因是流量超出套餐上限或到期未续费。超流量的情况直接购买流量包，支付成功后系统会自动解除暂停；到期的情况完成续费即可。仍未恢复请联系客服。
按页面提示分三种情况：
站点为保障安全开启了短信验证，请输入发送到您绑定手机的验证码；收不到短信请联系客服。
重装系统时设置的密码至少 8 位；建议同时包含大写字母、小写字母和数字，避免使用纯数字弱密码。
修改主机名会在下一次重装系统时才写入系统内部，属正常现象。
🛠️ 管理员篇
商品的模块配置不完整（通常是机型未关联套餐或未配置镜像）。补全配置后，可先到该产品详情页用「手动绑定服务器」应急开通。
这是流量包插件升级后覆盖了白名单补丁（见 2.6 节）。让技术人员在
traffic_package_manage.js 的模块白名单里重新加回 "toplink_dcim"，后台页面 Ctrl+F5 强制刷新即可。已售出的流量包不受影响。删除最后一个 Top-Link DCIM 接口会自动清空该模块全部配置数据（数据中心、线路、机型、价格、镜像等）且不可恢复。操作前请务必备份数据库。
📌 通用注意事项
修改于 2026-08-12 02:37:24