演示模式：面向 eSIM 运营商的参考店铺。价格为实时价格，支付已关闭。 运行你自己的运营商 →
Travel eSIM · demo
中文

你自己的枢纽

目录

把你的 eSIM 报价放进 AI 智能体联邦有两种方式，每种都只需一条命令。

./onboard.sh          # 联邦节点：接纳你的枢纽会上架你的报价
./onboard.sh --hub    # 你自己的枢纽：它自己上架你的报价，并与其他枢纽联邦

本页讲第二种：你自己的枢纽能带来什么、不能带来什么，命令逐步做了什么，以及一笔交易如何经过它。

1. 节点还是枢纽

联邦节点（aimarket node）你自己的枢纽（aimarket hub）
你的域名上运行什么一个发布你已签名报价的小服务一个完整的 AIMarket 枢纽：目录、搜索、路由、收据
谁上架你的报价接纳你的枢纽你的枢纽，始终如此；以及接纳它的枢纽
如果某个枢纽移除了你你就不在那个枢纽里了你仍在自己的枢纽里，也仍在其他所有接纳你的枢纽里
智能体如何找到你通过某个枢纽通过任何上架你的枢纽，或直接访问 https://<你的域名>/ai-market/v2/search 和 MCP https://<你的域名>/ai-market/mcp
智能体在你的域名上能找到什么你的报价你的报价，以及你的枢纽爬取到的整个联邦目录
收据由路由这次调用的枢纽签名你的枢纽为它路由的每次调用签名
需要备份什么data/node/（节点的密钥）data/hub/（密钥、数据库、设置、管理员令牌）
维护套件之外无需额外维护需要保持更新的枢纽（hub/Dockerfile 中的 aimarket-hub 版本）

想快速开始、自己这边什么都不改，就选节点。如果你希望无论某个枢纽如何决定都能保持上架、想给智能体一个属于你的搜索和 MCP 地址，或想运营自己的目录，就选枢纽。你可以先用节点，之后再换成枢纽：命令会保留你域名的身份（第 6 节）。

flowchart LR
    subgraph N["联邦节点"]
        A1["AI 智能体"] --> H1["某个枢纽，例如 modelmarket.dev"]
        H1 -- "爬取，路由询价" --> NN["你的节点"]
        NN --> R1["你的卖家节点 /agents"]
    end
    subgraph O["你自己的枢纽"]
        A2["AI 智能体"] --> H2["联邦中的任意枢纽"]
        A2 -- "或直接找你" --> OH["你的枢纽"]
        H2 -- "爬取，路由询价" --> OH
        OH --> R2["你的卖家节点 /agents"]
    end

2. 这里的“有保障”是什么意思

3. 命令

在服务器上、套件目录中运行：

./onboard.sh --hub

它只询问缺少的内容：你的域名、店铺名称、报价 ID 以及批发商密钥（隐藏输入，写入 secrets/，从不打印）。其余一切它自己完成，而且可以重复运行。一次运行的节选：

1. The server
  ✓ docker compose 2.29.7
2. Your settings (.env)
  ✓ esim.example.com · My Travel eSIM · esim-mytravel · demo mode (sells nothing yet)
  ✓ esim.example.com resolves to 203.0.113.10
3. Keys (secrets/, typed in hidden)
  ✓ secrets/esimaccess_access_code
  ✓ secrets/esimaccess_secret_key
4. Folders
  ✓ data/ and secrets/ belong to the containers' user (1000)
5. Store, seller node and HTTPS
  ✓ seller node: 1728 offers, 205 countries
6. Your own hub (aimarket hub)
  ✓ listed hub-hello/hub.ping@v1 free (signed receipt — what other hubs' sandbox runs)
  ✓ listed hub-hello/hub.hello@v1 at $0.004/call (local, executable, yours)
  ✓ listed esim-mytravel/esim.quote@v1 free → https://esim.example.com/agents/quote/invoke
  ✓ the hub lists esim.quote@v1 of esim-mytravel, signed with your seller node's key
  ✓ the federation reads you at https://esim.example.com/.well-known/ai-market.json
7. The admission check other hubs will run on you
  verdict: pass
8. Join the federation
  Knock on https://modelmarket.dev now? [Y/n]

./onboard.sh --check 不做任何改动，只报告哪些已就绪。--no-announce 跳过宣布；--announce 不询问直接宣布。如果 80 和 443 端口已被 nginx 占用，命令会提议把套件放在它后面，具体见运营者指南的“快捷方式”。

4. 命令做了什么

供想了解或想手动操作的人参考。第 1 至 5 步与节点相同，用来部署店铺和卖家节点（运营者指南第 4 至 7 步）。然后：

枢纽的身份。 如果该域名之前运行过联邦节点，它的密钥会移入枢纽，于是认识你域名的枢纽会继续信任它（第 6 节）：

cp -p data/node/node_signing_key data/hub/hub_signing_key      # 仅当枢纽还没有密钥时

枢纽，只需一次。 quickstart 把枢纽的设置保存到 data/hub/aimarket.env（包括生成的管理员令牌），创建签名密钥（Ed25519 和后量子的 ML-DSA-65），并上架 hub.ping@v1：免费，它用你的枢纽签名的收据作答，也正是其他枢纽的准入沙箱会调用的能力。它还上架 hub.hello@v1，一个付费的问候，用来证明付费调用可以工作，并在你的枢纽上创建一个带 0.05 美元测试余额的买家密钥；命令不会把这个密钥显示在屏幕上。

docker compose --profile hub build hub
docker compose --profile hub run --rm hub quickstart --name "$STORE_NAME" --url "https://$DOMAIN"

在枢纽上上架你的报价。 每次询价时枢纽都会调用你的卖家节点，并用从节点本身读取的密钥核对回答上的签名：

PUB=$(curl -s "https://$DOMAIN/agents/healthz" | sed -n 's/.*"provider_pubkey":"\([^"]*\)".*/\1/p')
docker compose --profile hub run --rm hub add esim.quote@v1 \
  --url "https://$DOMAIN/agents/quote/invoke" --product "$PRODUCT_ID" \
  --name "Travel eSIM offers" \
  --description "Travel eSIM offers for a country: data, days and price in USDC; the answer names the order URL, paid over x402" \
  --input-schema @/spec/quote-input.schema.json --provider-pubkey "$PUB"

切换。 Caddy 把联邦路径（/.well-known/ai-market.json、/ai-market/*、/a2a、/mcp、/.well-known/agent-card.json）转发给枢纽而不是节点：

echo "FEDERATION_UPSTREAM=hub:9083" >> .env
docker compose --profile federation stop node
docker compose --profile hub up -d hub
docker compose up -d caddy

检查。 aimarket doctor 从外部对你的枢纽运行其他枢纽将要执行的准入检查，并对每一项未通过的检查说明如何修复：

docker compose --profile hub exec hub aimarket doctor

宣布。 你宣布到的枢纽会在沙箱中自己执行这项检查，通过后就会上架你：

curl -s -X POST https://modelmarket.dev/ai-market/v2/federation/announce -H 'Content-Type: application/json' \
  -d "{\"hub_url\": \"https://$DOMAIN\", \"hub_name\": \"$STORE_NAME\"}"

回答中带有 assay_url，可以在那里查看结论。你可以用同样的方式向任意多个枢纽宣布。

5. 各部分如何组合

flowchart TB
    subgraph D["你的服务器：https://esim.example.com（Caddy，HTTPS）"]
        S["store/ · / — 面向用户的店铺"]
        R["rails/ · /agents/* — 卖家节点：询价、下单（x402）、状态、退款"]
        H["hub/ · /.well-known/ai-market.json、/ai-market/*、/a2a、/mcp — 你的枢纽"]
        H -- "POST /agents/quote/invoke，回答用卖家密钥签名" --> R
    end
    A["AI 智能体"] -- "搜索、询价（免费）" --> H
    A -- "x402：订单，付款到你的钱包" --> R
    A -- "状态、退款（状态令牌）" --> R
    F["其他枢纽：modelmarket.dev 等"] -- "准入检查，然后爬取你签名的清单" --> H
    F -- "来自其买家的路由询价" --> H
    H -- "爬取它们的目录" --> F
    W["eSIM Access / Airalo / eSIM Go / 你的系统"] --- R

一笔经过联邦的交易，智能体是在另一个枢纽上搜索的：

sequenceDiagram
    autonumber
    participant A as AI 智能体
    participant M as modelmarket.dev
    participant H as 你的枢纽
    participant R as 你的卖家节点
    participant C as Base（USDC）
    A->>M: 搜索 intent=esim
    M-->>A: esim-mytravel 的 esim.quote@v1，source_hub https://esim.example.com
    A->>M: 调用 esim.quote@v1 {country: TR}
    M->>H: 路由的调用
    H->>R: POST /agents/quote/invoke
    R-->>H: 报价，已签名（X-Provider-Signature）
    H->>H: 用你的卖家密钥核对签名，签发收据
    H-->>M: 报价 + 你的枢纽的收据
    M-->>A: 报价，下单地址 https://esim.example.com/agents/order
    A->>R: POST /agents/order → 402，然后 PAYMENT-SIGNATURE（EIP-3009）
    R->>C: facilitator 结算：USDC 进入你的钱包
    R-->>A: eSIM + 用你的卖家密钥签名的交付收据
    A->>M: 收据及其交易（可选）
    M->>M: 计入你的上架条目：deliveries_30d

资金从不经过枢纽：智能体通过 x402 直接付款到你的钱包，与节点方式相同。

6. 准入、密钥以及从节点迁移

stateDiagram-v2
    [*] --> pending: 你宣布（announce）
    pending --> checking: 枢纽的沙箱调用你免费的 hub.ping@v1
    checking --> admitted: 签名收据、有效的清单和密钥 → pass
    checking --> pending: review 或 fail：由枢纽运营者决定
    admitted --> listed: 枢纽爬取你的清单
    listed --> listed: 重新爬取；新报价自动出现
    listed --> rejected: 你的密钥变了（可能被接管）
    rejected --> listed: 该枢纽的运营者重新固定你的新密钥

7. 设置

设置位置作用
FEDERATION_UPSTREAM.envhub:9083 把联邦路径转发给你的枢纽；节点方式留空。由命令设置。
HUB_DESCRIPTION.env一句关于你店铺的介绍，显示在其他枢纽、目录和 Alien Monitor 上你的名称旁边（3.15.28 及以上）。
PROXY.envcaddy（套件自带）、nginx（你自己的，由命令配置）或 external（你自己的，由你配置）。由命令设置。
AIMARKET_HUB_URL、AIMARKET_HUB_NAMEdocker-compose.ymlhttps://<DOMAIN> 和 STORE_NAME：你的枢纽在其签名的每个文档中的地址和名称。
AIMARKET_SUPPLY_REQUIRE_RESPONSE_SIGdocker-compose.yml1：卖家节点的每个回答都必须带有签名。
AIMARKET_TRUSTED_PROXIESdocker-compose.ymlCaddy 所在的网络：枢纽能看到每个调用者的真实地址，用于限流。
AIMARKET_ROUTING_FEE_BPSdata/hub/aimarket.env你的枢纽在其积分通道上路由其他枢纽能力的交易时收取的费用（默认 1%）。你自己的 eSIM 销售款全额进入你的钱包。
AIMARKET_ORACLE_FAMILY_URLdata/hub/aimarket.envoff（由 quickstart 设置）：你的枢纽自己为发布者评分，不依赖任何人。
aimarket-hub 版本hub/Dockerfile更新方式：docker compose --profile hub build --pull hub && docker compose --profile hub up -d hub。

枢纽还有很多其他设置（积分、他人的上架、支付通道）：见运行你自己的枢纽。销售 eSIM 不需要其中任何一项。

8. 版本

9. 局限

GitHub 上的套件 →