使用指南

适用：1.2.3。本页教您添加设备 → 部署模型 → 使用模型，以及停止、卸载和移除设备。先按软件安装安装并登录；技术细节需要时再看维护手册。

先打开平台： 在管理MegaCube本机用https://127.0.0.1:18181/；其他电脑复制安装脚本显示的“其他电脑浏览器地址”，格式为https://管理节点IP:18181/，必须保留https://。首次证书提示先核对管理设备地址，再点“高级 → 继续访问”，或请现场管理员处理。打不开时见安装说明的网页登录步骤。模型服务的使用地址以“API接入”窗口为准，按原样复制。

1. 添加设备

1. 点击左侧“集群总览” → “添加设备”。
2. 按下表填写，先用“单台添加”接入运行管理软件的MC-001；其余设备可单台或批量添加。

3. 点击“添加”，等待完成，不重复提交。
4. 回到总览确认设备在线、环境完整。多设备时在“高级管理 → 集群网络”查看QSFP结果，按提示检查；不通过时先请网络管理员处理。

单台添加失败后，留在本次窗口重新输入SSH密码，点击“重试本次添加”；不要再建重复编号。批量失败在批次结果中重试。 只需在MC-001安装管理软件，其他设备由平台自动接入。

添加时，平台会自动设置设备之间的高速网络、运行模型所需的账号权限，并将该账号的桌面设为永不息屏。请先接好线缆，使用具有管理员权限的设备系统账号；设备缺少必要软件时，按提示联系设备支持人员。

数据地址和状态可在“高级管理 → 集群网络”查看。设备有模型或资源占用时不能重新配置；失败先看具体原因，按本次添加窗口或批次结果的提示重试。仅一台设备时节点间连通待验证是正常提示。

高速网络地址由平台统一安排，集群网络页用于查看。若提示地址冲突，请管理员按维护手册的网络说明检查后重试，不要自行修改正在使用的设备地址。

一次添加多台设备

1. 在“添加设备”窗口点击 “批量添加”。
2. 填写需要扫描的管理IP范围，例如 192.168.10.20-192.168.10.80。填写这批设备共用的系统账号、密码和SSH端口，点击 “开始扫描”。
3. 勾选要添加的设备，或点击 “选择新设备”。只列出本次SSH账号密码认证成功、硬件已核验且尚未添加的MegaCube。已添加设备自动隐藏，不会重复安装。单次最多选择32台。
4. 点击 “确认所选设备”。新设备自动生成未使用的MC编号；移除后重新接入的同一台设备，默认建议原编号。您可按现场编号修改，但不能占用其他设备的编号。
5. 核对列表并勾选确认，点击 “开始批量接入”。平台会自动设置高速网络、账号权限和永不息屏，并接入设备；同时最多处理两台，其余排队。
6. 查看每台的结果。失败项点击 “重新认证并重试本设备”；成功设备保持。关闭窗口后，可再次打开“批量添加 → 查看历史批次”继续查看进度或重试。

网段扫描中，账号密码不匹配、无法连接或不是MegaCube的设备不显示。没有显示的设备，请先确认管理IP、账号密码、接线以及SSH是否开启。已移除的设备可以重新扫描和添加。扫描只查找设备，确认接入后才开始设置；正在运行模型或已专属分配的设备不能重复配置。

每台设备的账号密码不同时：文件导入

1. 打开“添加设备 → 批量添加 → 文件导入”，点击“下载TXT模板”。
2. 用记事本打开模板，在等号右侧填写实际信息。管理IP、SSH用户、SSH密码必填；端口默认22，MegaCube序号留空自动分配，位置选填。密码原样填写，不要加引号，也不要额外加空格。
3. 多台设备时，复制从[设备]开始的整段内容，再填写下一台。按 Ctrl+S 保存，保持.txt后缀。
4. 回到平台点击“选择文件”，查看读取数量和设备信息，再点击“核验文件中的设备”。平台只连接文件中的IP，结果不会显示密码。
5. 已添加设备自动跳过；连接或认证失败的设备会显示原因，修正后可重新导入。勾选核验成功的设备，再按上面的步骤确认序号、开始批量接入。

每个文件最多256台，每批最多接入32台。剩余设备可重新导入同一文件，已添加成功的设备会跳过。已有CSV文件也可直接选择。文件核验不安装软件或修改设备网络；确认接入后才开始设置。密码不写入数据库或日志，但原文件含有您填写的密码，请妥善保管。接入失败项仍可在批次结果中单独重试。

2. 部署模型

1. 点击“模型部署”，选择需要的模型。点“详情”查看需要几台设备及内存、磁盘要求；有多个版本时，选版本并点“使用所选版本”。
2. 点击下一步，选择单副本或所需副本数量，勾选要运行模型的设备。灰色、不能选择的设备先按页面提示处理。
3. 点击下一步，核对模型、设备和服务名称，只点击一次“开始部署”。
4. 在同页下方的模型服务列表查看进度，等待下载、构建、分发和启动完成。
5. 服务显示运行中、健康后开始使用；多副本还需健康数量等于总数。

联网时，平台会自动下载所需文件；现场不能联网时，先按下一节准备文件。文件在管理设备MC-001准备，模型在您选中的设备上运行。 首次部署可能等待较久，可在服务列表查看进度。

部署失败时看服务里的失败阶段和原因，处理后按页面允许的“重试部署”操作；不确定时把错误文字提供给支持人员。

现场不能联网时：离线导入模型

1. 在联网Windows电脑打开交付包的“下载工具”文件夹，双击“下载模型资源.cmd”，选择需要的方案，等待显示“下载完成”。工具需要Python 3.11或更新版本；没有安装时，按模型资源使用指南准备。
2. 把整个downloads/方案编号文件夹复制到移动硬盘，插入管理MegaCube。
3. 在“高级管理 → 模型文件 → 离线导入模型”填写这个文件夹在MegaCube上的完整路径，点击“开始导入”，等待成功。
4. 看到“导入成功”后，回到“模型部署”，选择同一模型和方案，再按上面的步骤选择设备、开始部署。

请复制下载工具生成的整个方案文件夹，保留里面的全部文件和子文件夹。下载、空间及导入问题见模型资源使用指南。

3. 使用已经部署的模型

在同页下方找到对应服务，点击“API接入”。按模型类型操作：

使用窗口中实际显示的地址和密钥。办公电脑须能访问对应地址。创建的新Key明文只显示一次，请复制保存；不要把Key公开。程序调用、视频工作流和接口说明见维护手册。

4. 停止、再启动，或换一个模型

在模型服务列表找到对应服务：

停止仍保留设备占用，卸载成功才释放。 卸载后，管理设备上已下载的模型文件和运行软件仍保留，方便以后使用。需要清理管理设备空间时见下一节。

下载、校验阶段可以点击“取消准备”，已下载的文件保留。进入镜像构建、分发或模型加载后，请等待部署结果再停止。停止运行中的服务前，请先完成正在进行的对话、图片或视频生成，直接访问模型地址的任务可能被中断。

5. 管理设备空间不够怎么办

1. 点击“高级管理 → 模型文件”。
2. 找到不再需要的模型，进入“文件详情”。
3. 点击“删除本地文件”，输入当前平台管理员密码后删除。

正在运行或部署模型所需的文件不能删除。删除后再次使用，需要重新下载或导入。列表没显示已有文件时，先看页面显示的“当前扫描目录”，确认各模型的完整目录已放在这里，再点“扫描现有文件”。其他位置的文件不会自动扫描；首次没有下载模型时列表为空正常。

6. 删除不再使用的设备

1. 先在模型服务列表停止并卸载使用这台设备的服务；若有专属分配，先完成回收。
2. 回到“集群总览” → “移除设备”。
3. 勾选要移除的设备，输入当前平台管理员密码。
4. 核对设备编号，点击“移除选中的…台设备”，等待成功。

移除是把设备从平台中移出，不会擦除整台设备磁盘。MC-001正在承载管理软件，日常请保留它。 更换管理设备时请按维护手册迁移。

需要改网页登录密码时，点击侧栏底部“修改密码”。其他维护、设备专属分配和故障处理见软件安装与维护手册。

7. 设备专属分配与回收

需要让其他人员独占使用某台设备时：

1. 打开左侧“设备专属分配”，点击“分配设备”。
2. 选择空闲设备，填写使用者或团队、用途，以及使用者提供的SSH ed25519公钥。只提交公钥，私钥由使用者保管。
3. 核对整机移交提示并确认分配。等待账号开通，再把页面显示的SSH连接方式交给使用者。
4. 使用结束后，在同一页面点击对应设备的“回收”。使用者需结束任务并退出会话，等待平台确认设备可再次分配。

专属账号具有设备管理员权限；分配期间平台不在该设备上部署模型。管理设备MC-001日常请保留平台自用。

回收会保留使用者文件。 如需清理，在本页对应设备的“操作”列点击现有的“清理设备文件”，先查看扫描预览，再确认删除。设备须已回收且无模型、任务或其他占用；需要保留的输出先备份。具体范围见软件安装与维护手册。

8. 查看设备版本和工作负载

在“集群总览”点击设备卡的“设备详情”。顶部直接显示资产资料与维护标记，可修改后保存；下方默认收起，展开后通过“系统版本 / 工作负载”两个页签切换。

• 系统版本：查看设备系统、显卡驱动和网络等软件版本，点击“刷新版本”更新显示。需要技术支持时，可提供这里的信息。
• 工作负载：查看设备上正在运行的任务；出现异常提示时，交给管理员检查。

需要更新驱动或固件、重启设备时，请现场管理员按维护手册的系统维护说明处理，完成后返回版本页刷新核对。

高速网络状态在“高级管理 → 集群网络”查看；模型文件在“高级管理 → 模型文件”管理。设备专属分配、回收和文件处理见第7节。

9. 遇到问题：导出诊断日志

遇到异常时，按问题位置选择一个入口即可：

选择最近24小时，点击“导出并下载”，采集完成后会自动下载新的ZIP。解压后打开“开始阅读.html”，也可在“设备日志”中直接查找对应设备的TXT。将ZIP通过客户批准的渠道发给支持人员；采集不停止模型或修改设备。

平台打不开时： 在故障MegaCube上，打开完整交付文件夹，空白处右键选择“在终端打开”，输入 bash collect-diagnostics.sh 并回车。完成后打开“主文件夹 → megacube-diagnostics”，取出最新ZIP。它只采集这台设备，另一台异常设备需在其本机再采集一次。详细步骤见软件安装与维护手册。

发送时请补充故障发生时间、设备或服务名称、当时的操作。不要发送密码或API Key。详细排查和日志说明见软件安装与维护手册。

查看模型下载进度

准备模型文件时，会显示当前文件容量、累计容量、下载速度（MB/s）和来源。网络短暂中断时会保留断点；若准备失败，按页面允许的方式重试同一方案，可复用已完成文件并继续未完成内容。连接网络或校验文件时，速度可能显示为0；部署进度是整个流程的进度，不等于模型文件已下载的比例。实际速度受现场网络和文件来源影响。