dootask/resources/ai-kb/zh/howto/system-setting/e2e-encryption.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
system-setting.e2e-encryption.howto	端到端加密设置	howto	system-setting	admin	zh	端到端加密怎么开 E2EE 怎么设 消息加密在哪开 怎么开 e2e 聊天加密怎么打开 关闭端到端加密			需要系统管理员权限 部署环境变量 SYSTEM_SETTING 不为 disabled	端到端加密只对一组固定的敏感接口生效，不会对历史消息追溯加密 关键词搜索不能搜到加密传输中的密文内容（已落库的文本可被搜索） 不区分私聊 / 群聊：是否走 e2e 取决于接口，而非会话类型 撤回 / 编辑消息的时长限制由 msg_rev_limit / msg_edit_limit 决定，与 e2e 无关	v1.7.90

端到端加密设置

入口

桌面端：左上角头像 →「系统设置」→「系统设置」标签 →「消息相关」→「端到端加密」。

字段名：e2e_message，开关枚举 open / close，默认 close。

开启后影响哪些通道

开启后，下列接口的请求体在客户端用密钥加密后再发给服务端：

• users/login — 登录请求
• users/editpass — 修改密码
• users/operation / users/delete/account — 账号敏感操作
• users/bot/* — 机器人接口
• dialog/msg/* — 所有消息收发（包括私聊、群聊、文件消息等）
• system/license — 授权信息

WebSocket 通道则会在握手后用 PGP 公钥协商一次会话密钥再传输。 未在白名单内的 HTTP 接口（任务、项目、文件元数据等）仍走明文 + HTTPS。

操作步骤

1. 进入「系统设置」→「系统设置」→「消息相关」
2. 「端到端加密」选「开启」或「关闭」
3. 页面底部「提交」保存，立即生效（无需重启）

不支持

• 不能按用户 / 会话粒度单独开关，只能全局开 / 关
• 关键词搜索不会解密传输中的密文；已入库的明文文本仍可搜
• 调试环境（window.systemInfo.debug === "yes"）下不执行 WebSocket 的 PGP 协商（会被跳过）