如何完整导出ToDesk所有远程设备的连接日志？

功能定位：为什么需要“完整导出”

在等保2.0、ISO 27018 等合规框架下，运维团队必须留存远程桌面连接日志以备审计。ToDesk 个人版仅提供单条会话的“本地缓存”，而企业控制台才开放批量导出。理解这一边界，能避免在错误入口浪费时间。

经验性观察：当设备数＞50 台、每月会话＞3 000 条时，手动截图或逐条复制已无法满足审计时效要求，批量导出可将整理时间从“数天”缩短到“数十分钟内”。

前置条件与权限矩阵

账号角色

• 企业主账号：默认拥有“日志管理”模块，可导出全组织记录。
• 部门管理员：需在“权限模板”中显式勾选“日志导出”，否则按钮呈灰色。
• 普通成员：无入口，需提交工单由主账号代导出。

版本与部署方式

截至目前的最新版本（v5.2.0）中，SaaS 租户可直接在 Web 控制台使用“日志导出”；私有化中继客户需确保控制台≥v5.1.8，否则缺少“导出”按钮，只能调用 API。

决策树：三条路线怎么选

操作路径（分平台）

3.1 客户端本地日志（Windows 示例）

1. 主界面右上角「三」→「设置」→「高级」→「打开日志目录」。
2. 在资源管理器地址栏可见 %AppData%\ToDesk\log\（具体路径因版本和安装方式而异，请以实际为准）。
3. 按修改日期排序，复制最新 todesk_service.log 与 todesk_control.log 即可。

边界说明：本地日志仅保留最近 5 MB 循环覆盖，且不含“对端设备名”“所属部门”等组织维度，无法直接用于合规审计，仅适合排障。

3.2 Web 控制台批量导出（SaaS 企业版）

1. 浏览器访问 https://console.todesk.com，使用企业主账号登录。
2. 左侧菜单「日志管理」→「连接日志」。
3. 筛选时间范围（最大跨度 31 天）、部门、设备组。
4. 点击右上角「导出」→ 选择字段（默认已勾选会话ID、本端/对端设备名、起始时间、持续时长、IP、版本号）。
5. 确认后，系统生成 CSV，耗时约数十秒内（因数据量而异）。完成后在「导出记录」页下载，有效期 72 h。

3.3 私有化控制台差异

私有化版本路径相同，但“导出”按钮默认关闭，需超级管理员在「系统设置-安全选项」中打开“允许日志导出”开关，否则界面无入口。

API 自动拉取（可选）

ToDesk 企业版提供 /api/v1/session/export 接口，返回分页 JSON。示例脚本（Python）可在官方 GitHub 仓库找到，需用企业账号的 AccessKey 签名请求。经验性观察：每晚 02:00 拉取前一日数据，并对 sessionEndTime 做本地去重，可将后续审计查询耗时缩短约一半。

例外与取舍：什么场景不该导出

• 临时协助家人修电脑：导出会留下永久审计痕迹，违反最小必要原则。
• 设备已离线超 90 天：SaaS 侧日志默认滚动清理，导出结果为空，需提前开启“冷存储”增值模块。
• 日志含用户隐私（剪贴板、文件传输文件名）且未做脱敏：直接交付第三方审计可能违反 GDPR/PIPL，建议用官方“脱敏导出”模板，或本地脚本剔除敏感列。

验证与观测方法

1. 导出完成后，先校验 CSV 行数是否与控制台页脚“共 X 条”一致，差值应＜0.5 %。
2. 随机抽取 10 条，用 sessionID 在「日志详情」中搜索，确认时间、IP 吻合，排除缺列。
3. 对 IP 列跑一遍 GEO 库，若出现私有网段 10.x/172.x 占比过高，可能中继节点未记录公网地址，需在「系统设置-日志选项」勾选“记录出口 IP”并次日重新导出。

最佳实践清单

场景	推荐做法	频率
等保季度巡检	Web 控制台导出上一季度 CSV → 加密压缩 → 刻录光盘	每季度首日
外包商结算	按“对端设备名=外包商标识”筛选，导出时长列，作为 SLA 依据	每月 5 日
研发排障	仅拉取本地日志，不导出全组织数据，减少隐私暴露	按需

故障排查速查表

现象：导出按钮消失

原因1：角色无权限→让主账号在「权限模板」勾选“日志导出”。
原因2：私有化版本未开启开关→超级管理员在「系统设置-安全选项」启用。

现象：CSV 下载为空

原因1：时间范围超出 90 天且未购买冷存储→缩短范围。
原因2：筛选条件冲突（如同时选“部门A”与“设备组B”无交集）→重置筛选。

FAQ（结构化数据）

收尾与下一步

完整导出 ToDesk 连接日志的核心是选对入口：10 台以内可临时用本地文件，规模场景务必升级企业版，通过控制台或 API 一次性拉取。执行后请立即做“条数+抽样”双重校验，确保审计证据链完整。下一步，建议把导出脚本纳入 CI 定时任务，并结合“脱敏模板”自动清理敏感字段，既满足合规，又降低泄露风险。