数据与安全
本页说明 Keragi 的安全模型、数据存储方式、部署安全建议与风险提示。具体权利义务以《用户协议》《隐私政策》为准；本页不构成法律意见。
1. 安全模型
- 默认端到端加密：私聊、群聊与频道消息在客户端加密后发送；群聊使用客户端管理的 Sender Keys。
- 密钥只在客户端：私钥与会话密钥不会发送到服务端；服务端只中转（必要时盲存）密文，不能解密消息内容。
- 最小化服务端职责：服务端处理账号、设备/公钥、路由与必要的密文同步，但这不等于匿名——服务端仍会处理必要的连接与账号元数据。
- AI 与连接器：AI 接管由客户端根据会话配置决定是否回复。启用第三方 AI 或连接器后，相关会话内容会按你的配置发送给对应服务，其隐私与留存策略由该服务决定，不属于端到端加密的保护范围。
2. 数据存储
Keragi 默认采用 服务端中转、客户端保存：服务端只中转/盲存密文，消息、密钥与历史保存在客户端；删除客户端数据可能导致消息无法恢复或无法解密。
完整的存储位置、解密边界、备份与删除风险见 数据存储（安全视角，与数据库部署配置分开说明）。
3. 服务端安全建议
- 对外服务使用 HTTPS / 反向代理，不要把管理接口直接暴露到不可信网络。
- 首次启动前修改
JWT_SECRET与初始管理员密码；不同部署使用不同密钥，连接器服务器的JWT_SECRET需与主服务器一致。 - 使用防火墙限制端口，按最小权限运行，避免使用 root 账户直接运行宿主。
- 限制
data/与.env的文件权限；备份文件同样要保护，必要时加密后离线保存。 - 定期查看
wasmx.log，及时升级宿主与 WASM 资源包。 - 多服务器部署时，按角色只安装必要的资源，减少暴露面。
4. 客户端安全建议
- 为设备设置锁屏密码/生物识别，保持系统与浏览器更新，避免安装来源不明的插件或软件。
- 不要共享账号、私钥、会话密钥或客户端数据备份。
- 使用公共或共用设备后，退出登录并按客户端指引清理本地数据；清理前先确认不会丢失需要保留的消息。
- 只从官方下载页或 npm 官方包安装客户端与服务端，避免使用第三方修改版本。
5. 风险与免责声明
- 端到端加密不能防御已被控制的终端：恶意软件、键盘记录、弱设备口令、浏览器扩展、截图或收件人主动泄露，都可能导致内容暴露。
- 消息、密钥与历史数据以客户端为最终存储位置。删除客户端数据、设备丢失、系统重置或未做备份，可能导致消息永久丢失或无法解密；服务端无法恢复。
- 启用第三方 AI、连接器或其他外部服务后，相关内容的处理与留存由其提供方负责，不在端到端加密范围内。
- 自部署环境下，服务器的访问控制、网络安全、备份、日志、合规与合法使用由部署运营者负责；我们无法控制自部署环境的安全性。
- 本软件按现状提供。在法律允许的最大范围内，我们不对因使用或无法使用本软件、数据丢失、第三方服务或自部署环境导致的间接、附带或后果性损失承担责任。具体责任限制以《用户协议》为准。
- 本页内容用于说明技术特性与安全建议，不构成法律意见或安全保证；如涉及合规要求，请咨询专业人士。