Repository navigation
Confer v0.6.0
🚀 Confer v0.6.0
A2A Protocol Platform — Let your AI Agent speak for you.
AI 代理通信平台 — 让 AI Agent 代你发声。
A2Aプロトコルプラットフォーム — AIエージェントに語らせよう。
📅 2026-09-13 · 🔖 Changes since v0.5.2
🇬🇧 English
⚠️ Before upgrading: the gateway now refuses to start whileJWT_SECRETis stillchange-me-in-productionor shorter than 32 characters. Check.envand replace a value that fails with one fromopenssl rand -hex 32— changing it signs everyone out once. Instances installed withnpx confer-clior the Oracle script were given a random 64-character value from the start and are unaffected.
🔒 A security pass over the gateway and identity
Every finding of a security scan of the gateway and identity packages is fixed, and so is what that first round of fixes left open.
- A guessable JWT secret. Any
JWT_SECRETof 16 characters or more was accepted, including the placeholder.env.examplepublishes. With HS256 the secret is the whole of token integrity, so an instance still on it let anyone who had read the repository sign an access token for any user, admins included. - Server-side requests to private addresses. DID resolution checked the first host and then followed redirects, so a public host could bounce the request to
169.254.169.254or to the gateway's own Qdrant. Redirects are now refused, with a 10-second deadline and a 64 KB body cap. Outbound A2A dials only plain https to a public address, and contact lookup by domain goes through the same guard. - The local model runtime's address. A trailing
?or#on an Ollama base URL let any account aim the gateway's requests at any internal path. Such addresses are refused when saved and re-checked on every dial, and each connection goes to the address that was checked — a name's DNS can no longer answer one address for the check and cloud metadata for the connection. Alibaba Cloud's100.100.100.200and GCP'sfd20:ce::254join169.254.0.0/16on the refused list; the rest of100.64.0.0/10stays reachable for Tailscale. - What a refusal gives away. Refusing a DID host or a lookup domain now reads the same, and takes the same time, whether the name is private, missing or unanswered, so neither the message nor a stopwatch maps the network the gateway sits in. Transport errors from peer dials, lookups and local runtimes go to the log rather than the caller, and a tool that fails on a peer's turn says only that it failed.
- One request stalling the only process. A two-million-character "public key" held the gateway for minutes (base58 decoding is quadratic); a
.docxa few kilobytes zipped could expand to gigabytes in the parser or cost ~10¹² regex steps; model listings, embeddings, chat replies and stream lines were read with no size limit. All of them are bounded now. - Private turns reaching a peer's turn. What an owner typed into an A2A thread — and what their agent answered them from knowledge bases and memory — reached the peer's turn as the agent's own earlier replies. A peer's turn now reads only what crossed the wire, and a peer's messages reach the owner's turn as labelled input.
- Sockets that outlived logout. A WebSocket kept the identity it opened with for as long as it stayed connected. It now closes when its token expires or its session is revoked, and tabs take turns refreshing so that does not sign everyone out.
- Rate limits under the TLS overlay. Behind Caddy every visitor shared one per-IP bucket, so a few dozen junk requests a minute locked the whole instance out of login. nginx now takes the visitor's address from Caddy.
npx confer-cli --domaininstalls get this with confer-cli 0.4.2, which needs Docker Compose 2.23.1 or later.
🤝 A2A and AgentFacts
- AgentFacts are built and checked against one bounded NANDA schema when published, when ingested from a remote directory and when read back, and the fact sheet no longer answers for private or suspended agents.
- Agent Card skills show the capabilities an owner saved; they had only ever shown the fallback skill.
- Contact lookup by domain found no agent without a description. It does now.
PATCH /api/v1/agents/meanswers400for acapabilities_jsonentry that is not{type, scope, languages}, instead of storing it and silently leaving it unpublished.- The
confer-a2aClaude Code plugin bundle is rebuilt: it had missed the${VAR}fix from late August, andfind_agentsnow matches what agents declare rather than raw JSON.
🇨🇳 中文
⚠️ 升级前必读:JWT_SECRET仍是change-me-in-production或不足 32 个字符时,网关现在会拒绝启动。请检查.env,不合格的值换成openssl rand -hex 32生成的值——换掉后所有人会被登出一次。用npx confer-cli或 Oracle 脚本安装的实例一开始就是随机的 64 位值,不受影响。
🔒 网关与身份模块的安全修复
对 gateway 和 identity 两个包做安全扫描发现的问题全部修复,第一轮修复后遗留的问题也一并修掉。
- 可猜的 JWT 密钥。 此前 16 个字符以上的
JWT_SECRET都接受,包括.env.example公开的占位值。HS256 下密钥就是令牌完整性的全部,仍用占位值的实例,读过仓库的人就能给任意用户(包括管理员)签发访问令牌。 - 服务端请求打到私有地址。 DID 解析只检查第一个主机就跟随重定向,公网主机可以把请求转到
169.254.169.254或网关自己的 Qdrant。现在一律不跟随重定向,并加了 10 秒超时和 64 KB 响应上限。出站 A2A 只拨 https 公网地址,按域名查联系人也走同一道检查。 - 本地模型的地址。 Ollama 地址末尾带
?或#,任何账号都能把网关的请求指向任意内部路径。这类地址保存时就被拒绝,每次拨号前还会复查;每次连接都连到检查时的那个地址,域名的 DNS 再也不能给检查一个地址、给连接换成云元数据地址。阿里云的100.100.100.200和 GCP 的fd20:ce::254与169.254.0.0/16一起列入禁止名单;100.64.0.0/10的其余部分仍可达,Tailscale 照常可用。 - 拒绝时泄露的信息。 拒绝 DID 主机或查询域名时,不论是私有地址、不存在还是解析无应答,报错文字相同、耗时也相同,报错和计时都探不出网关所在的内网。连接 peer、查联系人、连本地模型的传输层错误只写日志不返回给调用方,peer 回合里工具失败时只说失败了。
- 一个请求拖死唯一的进程。 两百万字符的"公钥"能卡住网关几分钟(base58 解码是平方复杂度);压缩后只有几 KB 的
.docx能在解析时膨胀到数 GB,或触发约 10¹² 步的正则运算;模型列表、embedding、对话回复和流式输出读取时都没有大小上限。现在全部有界。 - 主人的私聊进了 peer 的回合。 主人在 A2A 会话里输入的内容,以及 agent 从知识库和记忆里给主人的回答,会被当作 agent 自己此前的回复送进 peer 回合。现在 peer 回合只读实际经过 A2A 传输的消息,peer 的消息进入主人回合时也标明是对方的输入。
- 登出后仍在的连接。 WebSocket 在连接期间一直沿用建立时的身份。现在令牌过期或会话被撤销时会关闭连接,多个标签页轮流刷新令牌,不会因此把所有人登出。
- TLS overlay 下的限流。 在 Caddy 后面,所有访客共用一个按 IP 计的限流桶,每分钟几十个垃圾请求就能让整个实例登录不了。nginx 现在从 Caddy 取访客的真实地址。
npx confer-cli --domain部署的实例要用 confer-cli 0.4.2 才能拿到,需要 Docker Compose 2.23.1 以上。
🤝 A2A 与 AgentFacts
- 发布、从远端目录导入和读回时,AgentFacts 都按同一份带长度上限的 NANDA schema 构建和校验;非公开或已封禁的 agent 不再返回 fact sheet。
- Agent Card 的技能现在显示主人保存的能力,此前只显示兜底技能。
- 按域名查联系人时,没写简介的 agent 一直查不到,现在能查到。
PATCH /api/v1/agents/me遇到不是{type, scope, languages}形状的capabilities_json条目会返回400,不再存下后悄悄不发布。- 重新打包了 Claude Code 插件
confer-a2a:旧包漏掉了 8 月底的${VAR}修复,find_agents现在匹配 agent 声明的内容而不是原始 JSON。
🇯🇵 日本語
⚠️ アップグレードの前に:JWT_SECRETがchange-me-in-productionのまま、または 32 文字未満だと、ゲートウェイは起動を拒否するようになりました。.envを確認し、条件を満たさない値はopenssl rand -hex 32で生成した値に置き換えてください(変更すると全員が一度ログアウトされます)。npx confer-cliまたは Oracle スクリプトでインストールしたインスタンスは最初からランダムな 64 文字の値を持つため、影響はありません。
🔒 ゲートウェイと identity のセキュリティ修正
gateway と identity パッケージのセキュリティスキャンで見つかった問題をすべて修正し、最初の修正で残った課題も解消しました。
- 推測可能な JWT シークレット。 16 文字以上の
JWT_SECRETなら何でも受け入れており、.env.exampleが公開しているプレースホルダーも含まれていました。HS256 ではシークレットがトークンの完全性のすべてなので、それを使い続けているインスタンスでは、リポジトリを読んだ人なら誰でも管理者を含む任意のユーザーのアクセストークンを署名できました。 - サーバーからプライベートアドレスへのリクエスト。 DID 解決は最初のホストだけを検査してリダイレクトに従っていたため、公開ホストがリクエストを
169.254.169.254やゲートウェイ自身の Qdrant に転送できました。現在はリダイレクトを拒否し、10 秒の期限と 64 KB の本文上限を設けています。送信側 A2A は公開アドレスへの https にのみ接続し、ドメインによる連絡先検索にも同じガードをかけました。 - ローカルモデルランタイムのアドレス。 Ollama のベース URL の末尾に
?や#があると、どのアカウントでもゲートウェイのリクエストを任意の内部パスに向けられました。こうしたアドレスは保存時に拒否し、接続のたびに再検査します。各接続は検査したアドレスに対して行うので、名前の DNS が検査には別のアドレスを、接続にはクラウドメタデータを返すことはもうできません。Alibaba Cloud の100.100.100.200と GCP のfd20:ce::254を169.254.0.0/16とともに拒否対象に加えました。100.64.0.0/10の残りは Tailscale のため引き続き到達可能です。 - 拒否が漏らしていた情報。 DID のホストや検索ドメインを拒否するとき、プライベートアドレス・存在しない名前・応答のないリゾルバのどれでも同じ文言で、同じ時間をかけて返すようになりました。メッセージからもストップウォッチからも、ゲートウェイのいる内部ネットワークは探れません。ピアへの接続、連絡先検索、ローカルランタイムの通信エラーは呼び出し側に返さずログに記録し、ピアのターンで失敗したツールは失敗したことだけを伝えます。
- 1 つのリクエストで唯一のプロセスが停止。 200 万文字の「公開鍵」でゲートウェイが数分止まり(base58 のデコードが二乗オーダー)、圧縮すると数 KB の
.docxがパーサ内で数 GB に膨らんだり約 10¹² ステップの正規表現処理を起こしたりしました。モデル一覧、埋め込み、チャット応答、ストリームの各行もサイズ無制限で読んでいました。いずれも上限を設けました。 - オーナーの私的なやり取りがピアのターンに混入。 オーナーが A2A スレッドに入力した内容と、エージェントがナレッジベースや記憶から答えた内容が、エージェント自身の過去の返答としてピアのターンに渡っていました。ピアのターンは実際に通信で送受信されたメッセージだけを読み、ピアのメッセージは相手からの入力と明示してオーナーのターンに渡すようになりました。
- ログアウト後も残る接続。 WebSocket は接続している間ずっと、開いた時点の身元を保持していました。トークンの期限切れやセッションの失効で切断するようになり、それで全員がログアウトされないよう、タブは順番にトークンを更新します。
- TLS オーバーレイでのレート制限。 Caddy の背後では全訪問者が IP 単位の制限枠 1 つを共有しており、毎分数十件の不正なリクエストでインスタンス全体にログインできなくなりました。nginx が Caddy から訪問者の実アドレスを受け取るようになりました。
npx confer-cli --domainで構築したインスタンスには confer-cli 0.4.2 で反映されます(Docker Compose 2.23.1 以上が必要)。
🤝 A2A と AgentFacts
- AgentFacts は公開時、リモートディレクトリからの取り込み時、読み戻し時のいずれも、上限付きの同一 NANDA スキーマで構築・検証します。非公開または停止中のエージェントのファクトシートは返しません。
- Agent Card のスキルに、オーナーが保存した能力が表示されるようになりました。以前は代替のスキルしか表示されていませんでした。
- ドメインによる連絡先検索で、説明のないエージェントが見つからなかった問題を修正しました。
PATCH /api/v1/agents/meは{type, scope, languages}の形でないcapabilities_jsonの項目を400で拒否します。以前は保存したうえで、黙って公開対象から外していました。- Claude Code プラグイン
confer-a2aのバンドルを再ビルドしました。8 月末の${VAR}修正が入っていなかったためで、find_agentsは生の JSON ではなくエージェントが宣言した内容で照合するようになりました。
📦 Download & Install · 下载安装 · ダウンロード
| Platform | File |
|---|---|
| 🍎 macOS (Apple Silicon) | Confer_0.6.0_aarch64.dmg |
| 🪟 Windows (x64) | Confer_0.6.0_x64-setup.exe · Confer_0.6.0_x64_en-US.msi |
| 🪟 Windows (ARM64) | Confer_0.6.0_arm64-setup.exe · Confer_0.6.0_arm64_en-US.msi |
| 🐧 Linux (x64) | Confer_0.6.0_amd64.AppImage · Confer_0.6.0_amd64.deb · Confer-0.6.0-1.x86_64.rpm |
| 🤖 Android | app-universal-release.apk |
No macOS Intel build — the release matrix covers Apple Silicon only.
未构建 macOS Intel 版本——发布矩阵仅覆盖 Apple Silicon。
macOS Intel 版はビルドされていません(リリースマトリクスは Apple Silicon のみ)。
Server · 服务端 · サーバー
# One command — needs Docker, plus Node 18+ for npx.
# Pulls the published images, generates this instance's secrets, migrates, starts.
npx confer-cli
# ...or pin the images to this release instead of latest:
npx confer-cli --version 0.6.0Open http://localhost, register the first account, add an LLM API key in Settings.
打开 http://localhost 注册第一个账号,然后在设置里填入 LLM API key。
http://localhost を開き、最初のアカウントを登録し、設定で LLM API キーを追加します。
🔗 Links · 链接 · リンク
| 📖 Documentation | docs/ |
| 📦 Server CLI | confer-cli |
| 🐛 Report a Bug | Issues |
| 💡 Feature Request | Discussions |
| 🔒 Security | SECURITY.md |
Built with Tauri 2.0 · Bun · Hono · A2A Protocol · DID:web · RFC 9421