better-staridc-MNBT
1---
2title: 魔方财务 × Docker 对接
3description: 将 MNBT Docker 容器作为标准服务器产品接入魔方财务（idcsmart）的完整指南
4---
5
6# 魔方财务 × Docker 对接
7
8将梦奈宝塔 Docker 容器作为标准服务器产品接入魔方财务（idcsmart），实现"产品 → 自动开通 → 前台管理 → 到期续费/删除"的完整闭环。
9
10> 详见 PRD：[Docker×魔方财务对接 PRD](../prd/docker-idcsmart.md)
11
12---
13
14## 架构
15
16```
17魔方财务（idcsmart）
18 前台用户 ──下单/续费/删除/控制台──▶ shd_host / 订单体系
19 │
20 ▼
21/modules/servers/mnbtdocker/mnbtdocker.php
22 (server module：CreateAccount/Renew/Status/...)
23 │ HTTPS POST（mn_key/mn_bh/mn_keye 鉴权）
24 ▼
25MNBT 外部 API：api/docker.php (gn=cfif/kt/zt/jc/tj/xf/bg/czmm/ztcx/sy/start/stop/restart)
26 │
27 ▼
28MN_docker_node（节点）/ MN_docker_user（账号）/ MN_docker_plan（套餐）
29```
30
31**单容器模型**：`CreateAccount` 只开通账号，容器由用户登录 MNBT Docker 控制台后在应用商店自行创建。
32
33---
34
35## 配置方式
36
37### 方式一：服务器接口设置（简洁）
38
39| 魔方字段 | 填写 |
40|----------|------|
41| 服务器 IP | MNBT IP地址 |
42| 端口 | MNBT 端口 |
43| 用户名 | 节点ID（自增ID）（`MN_docker_node.id`） |
44| 密码 | 调用密钥（可留空）（`md5(ktmy.qmk)`） |
45| Access Hash | 系统 API 密钥 |
46| SSL | 按站点 |
47
48### 方式二：产品配置选项（精确）
49
50| key | 说明 |
51|-----|------|
52| `api_url` | `https://mnbt.example.com/api/docker.php` |
53| `api_key` | 系统 API 密钥 |
54| `node_id` | 节点ID |
55| `call_key` | `md5(ktmy.qmk)` |
56| `plan_id` | 默认套餐 ID（可选） |
57| `console_url` | `https://mnbt.example.com/docker/login.php` |
58
59---
60
61## 模块方法映射
62
63| 魔方操作 | MNBT gn | 说明 |
64|----------|---------|------|
65| 开通 | `kt` | 仅开通账号，不创建容器（容器由用户在控制台创建） |
66| 暂停 | `zt` | 停容器 + qk=paused |
67| 恢复 | `jc` | qk=active |
68| 删除 | `tj` | 删容器 + 删用户行（立即） |
69| 续费 | `xf` | 更新到期时间 |
70| 升降级 | `bg` | 更新 plan_id（运行中容器配额不实时调整） |
71| 改密 | `czmm` | 重置密码，旧 docker_token 自动失效 |
72| 开机/关机/重启 | `start/stop/restart` | 容器启停 |
73| 状态/同步 | `ztcx` | 查询容器状态 |
74
75---
76
77## 状态映射
78
79| MNBT 状态 | 魔方 status | 说明 |
80|-----------|-------------|------|
81| `qk=paused` / `qk=expired` | `suspend` | 已暂停/已到期 |
82| `container_status=creating` | `waiting` | 容器创建中 |
83| `container_status=running` | `on` | 运行中 |
84| `container_status=stopped` | `off` | 已停止 |
85| `container_status=none` | `waiting` | 未创建容器 |
86
87---
88
89## 前台功能
90
91- **容器控制台** 选项卡：容器状态 + 「前往控制台」按钮
92- **打开容器控制台** 按钮：跳转 MNBT Docker 登录页
93
94---
95
96## 注意事项
97
98- **双登录体系**：魔方登录态 ≠ MNBT `docker_token`，用户需用 Docker 账号二次登录控制台
99- 用户名使用魔方 `username`
100- 节点编号 `MN_docker_node.id` 与虚拟主机的 `MN_bt.btdh` 不同
101
102> 完整部署说明见 `mf_modules/servers/mnbtdocker/README.md`