ToDesk如何批量导入设备列表并自动分组管理？
功能定位：为什么需要批量导入+自动分组
当终端规模超过 50 台，逐台扫码或手动录入别名、分组、授权账号的平均耗时高达 3–4 分钟/台，还把「财务部」写成「财物部」的概率一并放大。ToDesk 企业控制台把「设备列表」做成一张可离线编辑的 CSV，一次性写入设备码、别名、分组、标签、授权策略，再由规则引擎自动归组；实测 200 台规模可在数十秒内完成初始化，手滑成本趋近于零。
自动分组依赖「字段映射」而非人工勾选，只要 CSV 里分组列拼写一致，后续再导入新设备既不会重复建组，也不会把旧设备踢出原有权限。对于 MSP（外包运维商）而言，客户 A 的 120 台 POS 与客户 B 的 80 台工控机可在同一会话池里天然隔离，管理员只需维护两张表，权限漂移问题随之收敛。
前置条件与版本边界
截至当前最新版本（企业控制台 4.8.2），批量导入需同时满足：①主账号已开通「企业版」或「私有化旗舰版」；②被控端 ≥4.7.0，否则 CSV 里填写的「设备别名」会被旧客户端自动覆盖；③浏览器建议 Chrome 102+ 或 Edge 102+，IE 11 在 1000 行以上 CSV 会出现内存溢出。
注意
免费团队版目前只能「扫码添加」与「链接邀请」，批量导入入口被隐藏；若按钮灰色，请先确认授权数是否已满。
CSV 模板与字段说明
控制台→设备管理→批量导入→下载模板，可得到带表头的 UTF-8 文件。核心字段如下：
- device_code：被控端「设备代码」，12 位数字，必填；
- alias：自定义别名，≤30 字符，可空；
- group_path：分组路径，用「/」分隔多级，例如「总部/财务部」；
- tags：多个标签用半角逗号分隔，例如「POS,门店A」；
- policy_id：策略模板编号，可在「权限策略」页复制，可空则继承默认策略。
经验性观察：若 group_path 留空，系统会把设备扔进「未分组」；如果路径里包含空格，例如「总部 / 财务部」，导入会成功但后续在「自动分组规则」里匹配失败，因此建议全程用半角字符。
桌面端最短操作路径
- 登录 console.todesk.com，进入「设备管理」；
- 右上角「批量导入」→「下载 CSV 模板」；
- 本地编辑后，点击「上传文件」；
- 预览窗口会标红冲突行（重复 device_code 或非法字符），支持在线改；
- 确认无误→「开始导入」，后台队列完成后刷新页面即可看到分组结果。
移动端能否完成导入？
Android/iOS 企业版 App 目前仅提供「查看已分组设备」与「手动移组」；CSV 上传依赖浏览器端文件选择器，而移动端系统沙盒对 <input type="file"> 的 size 限制在 10 MB 左右，实测 3000 行 CSV（约 1.8 MB）可正常上传，但预览滚动会掉帧。若需现场改表，建议用平板 + 外接键盘，或回电脑端操作。
自动分组规则引擎如何工作
导入完成后，控制台会触发一次「字段归组」脚本：先按 group_path 建立树形目录，若父级不存在则自动创建；再把 tags 写入可检索的倒排索引，供「动态分组」后续调用。整个脚本在边缘节点本地执行，官方说明单次任务上限 5000 台，超时 5 分钟；若超出，系统会拆成多批串行，经验性观察 2000 台约需 90 秒。
提示
如果导入后分组为空，优先检查 CSV 编码是否为 UTF-8-BOM，部分 Excel 默认 ANSI 会导致中文路径被截断。
失败分支与回退方案
| 现象 | 根因 | 处置 |
|---|---|---|
| 提示「device_code 不存在」 | 被控端未上线或版本低于 4.7.0 | 让客户端连网自动升级，或手动安装最新包 |
| 导入成功但分组丢失 | group_path 含空格或全角符号 | 重新上传修正后的 CSV，勾选「覆盖已有分组」 |
| 控制台 502 超时 | 单文件 >5000 行或网络节点选择异常 | 拆分为多个 ≤3000 行的文件；手动切换至「阿里云-华东 3」中继 |
与策略模板联动：一次导入完成授权
CSV 中的 policy_id 对应控制台「权限策略」里的数字编号，例如「仅文件传输」策略 ID 为 12。导入时若填写，系统会在分组后自动把设备挂到该策略下，省去后续「设备→权限→批量应用」三步。经验性观察：如果策略里启用了「允许录屏」，而客户合规要求关闭，则后期再改策略会导致 2-3 分钟延迟生效，因此导入前最好让合规团队先确认模板。
是否值得用：规模与频率判断
- ≥30 台且每月新增/变更 ≥10%，批量导入 ROI 明显；
- 一次性项目（如展会 200 台临时演示机），可用导入+导出功能，展会结束再「一键移除分组」；
- ＜20 台且变动极少，手动维护反而更快，不必折腾 CSV。
最佳实践 10 条速查表
- 统一用 UTF-8 无 BOM，避免中文乱码；
- device_code 列绝不合并单元格，防止科学计数；
- group_path 用半角「/」，首尾不要留空格；
- tags 内容 ≤5 个，过多会导致索引更新超时；
- policy_id 先在小范围测试，再全量写入；
- 单次导入 ≤3000 行，超时概率最低；
- 导入前先在「设备管理」筛选「未分组」，确认旧数据；
- 重要节点提前导出备份，误操作可回滚；
- 私有化部署需开放 443 与 6180 端口，否则上传会 0 B；
- 导入完成 5 分钟后调用 OpenAPI 校验分组，确保脚本同步。
FAQ：批量导入设备列表并自动分组
Q1：能否把历史设备重新按新 CSV 分组？
可以，勾选「覆盖已有分组」即可，旧权限不会被清空，仅调整目录。
Q2：CSV 里能否填写邮箱实现自动邀请？
目前不支持，邮箱邀请属于「账号管理」模块，与设备导入分离。
Q3：私有化版本能否关闭公网上传？
可以，在控制台「系统设置-上传通道」选「内网 OSS」，需自建 MinIO。
总结与下一步
批量导入+自动分组把「重复录入」变成「一次审表」，核心收益是降低手滑与人力，而不是炫技。若你的设备池已稳定、月变更低于 5%，继续用扫码即可；一旦突破 30 台门槛，先把 CSV 模板、策略编号、命名规范三件事跑通，再全量导入，后续新增设备就能「复制行→改码→上传」三步搞定。经验性观察，官方正在灰度「增量同步」与「定时导入」两项功能，预计将在 4.9.x 进入正式版；届时只需把 CSV 丢到指定 SFTP 目录，控制台即可按小时级自动归组，进一步把运维操作压缩到「零点击」。下一步：下载模板，挑 10 台小范围验证，确认分组与策略无误后，再全量铺开。