AUTO-MAS 安全与隐私完整指南:遥测数据、代码签名与密钥管理详解
AUTO-MAS 安全与隐私完整指南:遥测数据、代码签名与密钥管理详解
AUTO-MAS 是一款面向游戏自动化场景的多脚本多配置统一管理与自动化工具,帮助你在一个界面里管理大量脚本、保存多份用户配置并监看任务日志。正因为它能接触游戏账号、社区登录凭证与各类推送密钥,安全与隐私就显得格外重要。本指南带你快速读懂它如何处理遥测数据、如何加密存储密钥,以及遇到问题时如何安全地报告漏洞。
为什么自动化工具更要重视安全与隐私
AUTO-MAS 会自动读取游戏账号、米游社 / 社区登录 Token、Server 酱 / 飞书 / 企业微信等推送地址,这些信息一旦泄露后果严重。理解它的隐私边界,能帮你放心使用,也让你在分享日志时更有底气。
一、匿名遥测:它到底在收集什么
AUTO-MAS 内置了轻量级匿名遥测,用于上报脱敏后的错误堆栈、启动耗时等性能指标,帮助开发团队定位问题。所有上报都经过多层清洗,不含你的账号、配置内容或本机路径。
遥测开关:默认开启,可一键关闭
- 遥测由配置项
Function.IfEnableTelemetry控制,默认开启;缺失的旧配置按开启处理,损坏的配置则按关闭处理。 - 在设置页「功能」页签里,「匿名遥测」下拉框即可切换为「否」。关闭后,前端与后端会立即停止发送任何数据。
- 开关读取逻辑见 telemetry.py 的
is_telemetry_enabled;前端提示文案在 TabFunction.vue。
💡 开发环境下遥测恒为空操作,不会上报任何数据。
数据脱敏:上报前层层清洗
上报前的每一个事件都会经过 sanitize_event 处理,做到「宁缺毋滥」:
- 移除
user、extra等用户标识字段; - 剥离请求中的
cookies、headers、body等隐私字段; - 将本机绝对路径(如
C:\Users\用户名\...)缩减为文件名,并把用户名段替换为<user>; - 过滤
BrokenPipeError、ConnectionResetError等无行动价值的常见异常,避免噪音。
这套脱敏在后端 telemetry.py 与前端 sentryPrivacy.ts 中逐条对应,确保前后端口径一致。此外,Windows 崩溃时含完整命令行与环境变量的 minidump 被整体禁用,从源头杜绝敏感信息外泄。
二、日志与问题报告的隐私保护
AUTO-MAS 支持一键导出「问题包」协助排查,但在打包日志前会对敏感内容打码,避免密钥随日志流出。
- 后端日志写入时即调用
sanitize_log_message,识别password、token、secret、cookie等字段并替换为***。 - 专门针对推送地址里嵌在 URL 中的令牌:企业微信的
?key=、Server 酱的SendKey、飞书 / Discord / Telegram 的路径令牌等,都按域名规则单独打码。 - 前端打包问题包时,对已落盘的旧日志套用同一组规则再次打码,见 issueReportCore.ts。
这套机制见 security.py,核心是让「日志里的每一个密钥」都变成星号,你再也不用担心误把推送密钥发出去。
三、密钥管理:DPAPI 加密你的账号密码
AUTO-MAS 在 Windows 上使用系统级 DPAPI 加密账号密码、社区 Token 等敏感配置,落盘到配置文件里的都是密文而非明文。
加密原理与存储
- 敏感配置项通过
EncryptValidator标记,例如Info.Password、GameSignAccount.MiyousheToken等,见 config.py。 - 加密走
dpapi_encrypt/dpapi_decrypt,Windows 实现位于 windows/secret.py,采用机器作用域(CRYPTPROTECT_LOCAL_MACHINE)。 - 使用机器作用域意味着同一台机器上的不同 Windows 账户都能解密,避免因换账户导致已存密码读不出。
换账户时的贴心边界处理
万一某份密文本机确实解不开(比如由另一台环境写入),AUTO-MAS 不会把它当成坏数据覆盖掉,而是:
- 落盘时原样保留密文,绝不二次加密把它变成永久乱码;
- 读取时返回占位提示
数据损坏, 请重新设置,引导你重新填写。
这一逻辑由 ConfigBase.py 中的 EncryptValidator 与 getValue 实现,并有 test_config_item_secret.py 专门回归测试,守护「更新后账号密码变成一串密文」这类历史问题。
四、更新与代码来源安全
- 更新下载支持多镜像源轮替,单个来源失败会自动切换,降低被单点污染的风险,见 update.py 与 mirrorRotationService.ts。
- 游戏更新补丁采用「先写临时文件 → 校验和(MD5)通过 → 原子替换」的流程,内容不符会直接失败,避免损坏文件被写入,见 patch.py。
- 启动器校验严格限定官方可执行文件名并叠加签名校验,防止伪造程序被加载,见 endfield_launcher.py。
- 所有对外网络请求都保留 TLS 证书校验,不会为绕过 DNS 错误而关闭证书验证。
五、发现漏洞如何报告
AUTO-MAS 团队仅对 v5 最新稳定版提供安全支持。发现安全问题时:
- 可公开的问题,通过仓库 Issues 提交;
- 不可公开、可能被用于入侵设备的严重漏洞,请通过私有安全公告渠道报告。
具体策略详见 SECURITY.md。
小结
AUTO-MAS 用「默认透明、层层脱敏、机器级加密、来源校验」四道防线,把自动化工具的隐私风险降到最低。你只要记住三点:
- 在设置里按需关闭「匿名遥测」,即可完全停止数据发送;
- 账号密码、社区 Token 在 Windows 上以 DPAPI 密文存储,配置文件泄露不等于密钥泄露;
- 导出问题包或分享日志前,内置打码已替你把推送密钥和凭证抹掉,放心使用。
理解这些机制,能让你在享受多脚本自动化带来的效率提升时,始终握牢自己的数据主权。

