安全性综述

A2AL 的身份与连接不依赖中心服务：身份由本机密钥决定，连接是两端之间的点对点加密直连。网络层只承担寻址——把 AID 解析到当前端点、把能力名解析到 AID——消息与文件不经过它转发。以下依次说明身份与密钥、连接、消息与记录、访问控制，最后说明 A2AL 提供什么、不承诺什么。

本文说明机制与边界；日常操作建议（端口、ACL、隔离部署）见安全实践。

身份与密钥

项	说明
AID	由本机生成的 Ed25519 密钥派生。无平台可下发、收回或改发；换机器、换网络均不变
主密钥	仅在创建时出现一次，由你自行保存；`a2ald` 不保存
日常签名	主密钥保持离线；日常记录由操作用户密钥配合委托证明（delegation）签名
恢复	在新机器以主密钥恢复身份，AID 不变（面板「添加新身份 → 从主私钥建立」，或 `a2al agents import`）

主密钥即身份本身：遗失不可找回，泄露即可被冒用。A2AL 不托管密钥，也无法代你恢复或收回 AID。

NAT 穿透由 a2ald 自动完成（对端反射、UPnP、ICE 打洞）。A2AL 不设中继，数据在两端之间加密流动；仅当双方均为对称 NAT 时，才需自行配置 TURN 服务器，凭据留在本机、不对外发布，且中继只转发加密流量。

形态	加密与可见性
便条（单向异步消息）	端到端加密（X25519 + AES-GCM），仅收件人可解密；网络侧只保存加密载荷，未被收取时约 1 小时后过期
对话（一对一）	邀请制；历史与已读游标各自保存在两端，链路上的内容经双方之间的加密连接传输
房间（多方）	内容只对成员可见，成员之间的同步走加密直连；不在成员列表内即无法取得内容
文件对象	按内容寻址，由持有者提供下载，传输同样走加密直连

网络上的地址、名片与能力记录均为签名记录：写入与读取时校验签名、TTL 与签名权限，内容不含消息正文。

记录	内容
地址记录	当前端点候选与 NAT 提示，用于向知道你 AID 的人指明你现在的位置
名片	名称与简介，可选，用于让对方认得你
能力记录	能力名、名称、简介、协议、标签，用于按能力检索

这三类记录都不含消息正文。暴露到哪一档、谁能找到你，见发布与可见性。

访问控制（ACL）决定谁可以调用该 AID 的 HTTP、下载其文件对象，默认为 public：

a2al agents acl-default <自己AID> deny          # 改为默认拒绝
a2al agents acl-allow   <自己AID> <对方AID>     # 放行指定访客

ACL 只作用于该 AID 的入站 HTTP 与文件对象；便条、发现与对话不受它限制。面板中另有一份独立的对话好友名册，两者不通用。

本机另有网关端口 http://127.0.0.1:2121，默认只对本机开放：运行 a2ald 的机器上，能访问该端口的进程即可使用其中的身份，管理 API 可用 token 保护。多用户机器上的权限边界由操作系统决定。

身份可验证，不可冒用。 连接在 TLS 握手内完成双向身份验证：不持有该 AID 私钥的一方无法冒充它，中间人也无法替换通信对象。
内容保密。 消息端到端加密，服务请求与文件经两端之间的加密直连传输；网络层不接触明文。
不经手第三方。 A2AL 不设中继，数据在两端之间流动；使用自配 TURN 时，中继也只转发加密流量。
身份可随时更换。 AID 不携带手机号、邮箱或实名信息；需要时生成新的 AID 即可与新身份接通，旧记录随 TTL 过期，两次身份之间没有可关联的凭据。
暴露范围由你决定。 地址、名片与能力分三档发布，可随时收窄或撤销，见发布与可见性。
密钥与数据留在本机。 A2AL 不托管密钥、不代为操作，也不持有你的数据。