【免費下載鏈接】nasikoDeveloper Control Plane for your AI Agents項目地址https://gitcode.com/gh_mirrors/na/nasiko點擊查看免費下載Nasiko 是一個面向 A2A 協(xié)議 Agent 的開發(fā)者控制平面Developer Control Plane以單個控制平面進程完成 Agent 的部署、路由、代理、密鑰托管與可觀測性。本文基于倉庫根目錄的 README.md 展開覆蓋 Docker-only 快速啟動、Rust 開發(fā)者路徑、CLI 常用命令、Coding Agents 與 LLM Router 集成并結(jié)合 docker-compose.yml、config/src/lib.rs 與 justfile 等倉庫文件補充實現(xiàn)證據(jù)讀完后可獨立完成一套本地 Nasiko 平臺搭建與 Agent 部署。一、Nasiko 是什么把 Agent 運維問題收斂到一個進程當(dāng)運行的 Agent 數(shù)量超過兩三個運維問題會迅速涌現(xiàn)誰在調(diào)用誰每個 Agent 持有什么密鑰一次調(diào)用花了多少錢失敗原因是什么Nasiko 的定位是單一控制平面進程single control-plane process位于所有 Agent 之前一次性回答上述問題。它的核心機制包括終結(jié) TLS、對每個請求做身份認證并自行代理所有 Agent 間流量——Agent 永遠不對外暴露每一跳都是限流、ACL 與追蹤的檢查點語言無關(guān)Agent 可以用 Python、Rust、Go 或 TypeScript 編寫只要說 A2A 協(xié)議即可接入無專有 Agent 格式、無鎖定內(nèi)置組件智能路由引擎、MCP Gateway、LLM Router、內(nèi)嵌 OCI 鏡像倉庫、Flow Guards、加密 Secrets 引擎等。這一單進程、無獨立網(wǎng)關(guān)的設(shè)計直接體現(xiàn)在工作區(qū)成員劃分上Cargo.toml 將server、orchestrator、mcp-gateway、llm-router、oci、flow、secrets、agent-proxy、auth、observability、runtime等 crate 放在同一個 workspace 中各自對應(yīng)一個控制平面內(nèi)部能力。二、核心能力一覽README 的功能表完整列出了平臺能力以下按原文繼承并補充源碼位置佐證能力說明部署任意 A2A Agentnasiko deploy一條命令完成構(gòu)建、推送到內(nèi)嵌 registry、運行無需外部鏡像倉庫對應(yīng) oci/ crate智能路由引擎三級流水線embedding 相似度初篩 → 對話上下文重排 → LLM 最終選擇對應(yīng) orchestrator/ crate單入口、恒代理Agent 不對外可達所有 Agent 間調(diào)用經(jīng)服務(wù)端代理對應(yīng) agent-proxy/ 與 server/src/agent_proxy.rsMCP Gateway一個固定 URL 向所有 Agent 提供合并的、按權(quán)限過濾的 Composio 工具集與自定義 MCP 服務(wù)器視圖Agent 不持有憑證對應(yīng) mcp-gateway/ crateLLM RouterAgent 拿到OPENAI_BASE_URL 短期身份令牌而非真實密鑰provider/model/key 在服務(wù)端解析對應(yīng) llm-router/ crate全鏈路可觀測每次分發(fā)與代理跳發(fā)出真實 OTel span形成端到端 tracetoken 用量與成本從gen_ai.*屬性自動采集對應(yīng) observability/ crateFlow GuardsRedis 支撐的級聯(lián)限制深度、扇出、token 預(yù)算、超時、環(huán)檢測阻止失控 Agent 循環(huán)對應(yīng) flow/ crate加密 Secrets每 Agent 密鑰 AES-256-GCM 靜態(tài)加密僅在部署時注入對應(yīng) secrets/ crate訪問控制用戶-Agent 所有權(quán)/授權(quán) 與 Agent-Agent 白名單獨立地門控每次代理調(diào)用內(nèi)嵌 OCI Registry自托管、S3 支撐、層去重nasiko push/nasiko deploy不依賴外部倉庫CLI 優(yōu)先、無鎖定nasiko new、run、chat、deploy自帶 LLM provider三、架構(gòu)單進程控制平面 三類支撐服務(wù)Nasiko 是單進程——沒有獨立網(wǎng)關(guān)。所有 Agent 間調(diào)用都經(jīng)服務(wù)端代理回來服務(wù)端是唯一執(zhí)行 flow 限制、ACL 與可觀測性的咽喉點。持久化狀態(tài)存放在Postgres、Redis和S3RustFS可觀測性通過Tempo / Loki / OTel Collector提供可選。README 給出的架構(gòu)總圖如下mermaid對 Agent 的每個請求要么由路由引擎分發(fā)、要么被通用代理——兩條路徑都發(fā)源于服務(wù)端內(nèi)部。Agent 永不接收直接的公開請求也不持有真實 API key 或工具憑證而是回連 LLM Router 與 MCP Gateway。從 docker-compose.yml 可以印證這套架構(gòu)的落地形態(tài)postgrespgvector/pg16 鏡像供向量檢索、redis:7-alpine、rustfsS3 兼容存儲9000 端口、otel-collector0.119.0、tempo:2.6.1、loki:3.3.2以及server服務(wù)本身。幾個值得注意的實現(xiàn)細節(jié)server使用depends_on: condition: service_healthy等待 Postgres 與 Redis 健康檢查通過后才啟動——這正是 READMERequirements中要求 Compose V2 插件的原因V1 不支持service_healthy條件server掛載/var/run/docker.sock以便用 bollard 管理 Agent 容器對應(yīng) runtime/ 中的 DockerRuntimecompose 中顯式覆寫DATABASE_URL、REDIS_URL、S3_ENDPOINT等連接 URL 為 Docker 服務(wù)名并注入MCP_GATEWAY_PUBLIC_URL: http://server:8080/api/mcp與LLM_GATEWAY_BASE_URL——即 Agent 容器內(nèi)如何回連網(wǎng)關(guān)的具體地址所有服務(wù)接入名為nasiko的共享網(wǎng)絡(luò)DOCKER_AGENT_NETWORK: nasiko使服務(wù)端能通過容器 IP 直達 Agent 容器。四、環(huán)境要求Requirements組件最低版本說明Docker Engine Compose V2Compose V2 插件docker compose命令而非舊版獨立docker-composev1 二進制docker-compose.yml 使用擴展語法depends_on: condition: service_healthyDocker-only 路徑無需其他東西Rust1.85stable工作區(qū)目標(biāo)為edition 2024見 Cargo.toml 中edition 2024在 Rust 1.85 穩(wěn)定——僅 CLI / Path B 開發(fā)者路徑需要Docker-only 路徑不需要A2A 協(xié)議精確要求 Specv1.0上游最新v1.0.1Linux FoundationNasiko 在每個請求上強制A2A-Version: 1.0頭舊版本如 0.2.x、0.3.0的 Agent 會被-32009 VersionNotSupported拒絕見 docs/A2A_PROTOCOL.md。任何說 v1.0 的 Agent 均可接入與實現(xiàn)語言無關(guān)源碼級佐證版本頭的硬編碼可以在 CLI 中找到例如 cli/src/commands/chat.rs 中.header(A2A-Version, 1.0)示例 Agent如 agents/assistant-agent/main.py與 TUIcli/src/commands/tui/event.rs同樣注入該頭錯誤碼語義定義在 docs/A2A_PROTOCOL.md-32009對應(yīng) VersionNotSupportedHTTP 層映射為 406。五、快速啟動 — Docker-only無需 Rust最快路徑只需要 Docker帶 Compose。服務(wù)端在 Docker 內(nèi)從源碼自行編譯。1. 克隆并配置git clone https://gitcode.com/gh_mirrors/na/nasiko cd nasiko cp .env.example .env編輯.env至少設(shè)置OPENAI_API_KEY— OpenAI key路由引擎使用并注入 AgentADMIN_PASSWORD— 引導(dǎo)管理員賬號的密碼.env.example 本身就是帶完整注釋的配置手冊按Required / Optional / Credential三級組織必填項如SECRETS_ENCRYPTION_KEYAES-256-GCM 密鑰openssl rand -base64 32生成、JWT_SECRET、S3 憑證須與 compose 中的rustfs服務(wù)完全一致nasiko/nasiko123/us-east-1/ bucketnasiko可選項如AGENT_JWT_SECRETLLM Router 短期令牌簽名密鑰、COMPOSIO_API_KEY、SEED_AGENTS、可觀測性端點等。2. 啟動平臺docker compose up -d這會構(gòu)建 server 鏡像并啟動完整棧Postgres · Redis · RustFS (S3) · OTel Collector · Tempo · Loki · nasiko-server。首次構(gòu)建需數(shù)分鐘Docker 內(nèi)編譯 Rust后續(xù)構(gòu)建很快打開http://localhost:8080進入 Dashboard用ADMIN_USERNAME/ADMIN_PASSWORD登錄默認admin/changeme。日常運維命令docker compose logs -f server # 跟蹤服務(wù)端日志 docker compose down # 停止全部 docker compose up -d --build # 拉取新變更后重建六、按操作系統(tǒng)的部署指南兩條受支持路徑路徑依賴適用對象A. Docker-only僅 Docker只想跑平臺的任何人B. Source / RustRust just貢獻者、開發(fā)者、熱重載Path A — Docker-only分系統(tǒng)要點Windows安裝 Docker Desktop 并等待引擎就緒然后在 PowerShell/Git Bash 中Copy-Item .env.example .env編輯后docker compose up -d打開 http://localhost:8080 登錄。macOS安裝 Docker Desktop for Maccp .env.example .env后同上。host.docker.internal在 Docker DesktopmacOS/Windows上默認可解析Agent 無需額外設(shè)置即可到達 MCP 網(wǎng)關(guān)。Linux安裝 Docker 引擎 Compose 插件將用戶加入docker組sudo usermod -aG docker $USER newgrp docker后執(zhí)行標(biāo)準步驟。注意原生 Docker不提供host.docker.internal——若 Agent 報[Errno -2] Name or service not known需用--add-host host.docker.internal:host-gateway啟動 Docker或把MCP_GATEWAY_PUBLIC_URL設(shè)為網(wǎng)橋 IP。工具鏈安裝CLI / Path B 用Windowswinget install --id Rustlang.Rustup -e安裝 Rust隨后cargo install just cargo-watch如需構(gòu)建原生 Windows 二進制MSVC 工具鏈接ring等 crate 失敗時再裝 VS C Build Tools——僅構(gòu)建 CLI 并不需要 C Build Tools走的是純 Rust 工具鏈。macOSxcode-select --installC 工具鏈/鏈接器→ rustup 安裝腳本 →cargo install just cargo-watch。Linux (Debian/Ubuntu)sudo apt install -y build-essential pkg-config libssl-dev→ rustup →cargo install just cargo-watch。裝完統(tǒng)一驗證rustc --version cargo --version just --version docker --version docker compose versionPath B — 開發(fā)者 / Rust 路徑依賴 Rustrustup、justcargo install just與 Docker。# 1. 只啟動基礎(chǔ)設(shè)施Postgres, Redis, RustFS, OTel 棧 just infra # 2. 配置服務(wù)端環(huán)境變量 cp server/.env.example server/.env # 編輯 server/.env - 至少設(shè)置 OPENAI_API_KEY # 3. 原生運行服務(wù)端熱重載 just dev # ...或不帶熱重載 just run服務(wù)端運行在 http://localhost:8080just dev依賴 cargo-watch倉庫內(nèi)通過cargo watch -x run -p nasiko-server --bin nasiko-server實現(xiàn)見 justfile 第 50–54 行改動即自動重建。常用開發(fā)命令與 justfile 逐條對應(yīng)just check # cargo check --workspace just clippy # lint零警告策略 just test-unit # 快速、無外部依賴的單元測試無需基礎(chǔ)設(shè)施 just test # 單元 集成測試先運行 just infrajust test實際拆為兩階段test-unit覆蓋nasiko-auth、nasiko-secrets、nasiko-config等 11 個 crate 的單元測試test-server以--test-threads1串行運行服務(wù)端集成測試。從源碼構(gòu)建二進制cargo build --release -p nasiko # CLI 二進制 cargo build --release -p nasiko-server # 服務(wù)端二進制七、CLI — 安裝與使用CLI 需要從源碼構(gòu)建獨立的cli/crate構(gòu)建/部署 Agent 鏡像還需要 Docker。安裝# 從倉庫根目錄 cargo install --path cli/ # ...或構(gòu)建獨立二進制 cargo build --release -p nasiko確保在PATH中Cargo 的bin目錄~/.cargo/bin。部署你的第一個 Agentnasiko connect http://localhost:8080 nasiko auth login # 用 ADMIN_USERNAME / ADMIN_PASSWORD 登錄 nasiko new openai my-agent cd my-agent # 從模板腳手架 nasiko deploy . # 構(gòu)建、推送、部署 nasiko chat Hello there # 與 Agent 對話消息須含空格 # 或用 --agentnasiko chat --agent my-agent Hello除 CLI 外也可以在 Dashboard 上直接部署 Agent——上傳源碼、從 GitHub 導(dǎo)入或從制品 registry 拉取。常用 CLI 命令命令說明nasiko connect url注冊并切換到某個控制平面nasiko auth login向當(dāng)前集群認證nasiko new [template] [name]腳手架一個新 Agent 工程nasiko build/nasiko run構(gòu)建 Agent 鏡像 / 構(gòu)建 本地運行nasiko push/nasiko deploy image推送鏡像 / 構(gòu)建-推送-部署到集群nasiko upload [source]上傳源碼由服務(wù)端構(gòu)建本地?zé)o需 Dockernasiko ps列出運行中的 Agentnasiko logs agent -f流式跟蹤 Agent 日志nasiko stop/start/restart/scale nAgent 生命周期nasiko rm --name agent終止并注銷 Agent位置參數(shù)id僅接受 UUIDnasiko chat agent交互式或一次性 A2A 對話nasiko secrets set配置加密的每 Agent 密鑰nasiko mcp管理 MCP Gateway 連接器與工具權(quán)限nasiko observe可觀測性會話、trace、span、統(tǒng)計、FinOpsnasiko maf多 Agent 流工作流創(chuàng)建/運行/查看nasiko registry瀏覽制品 registrynasiko githubGitHub 集成status/repos/connect/disconnect/clonenasiko --help可按工作流順序查看完整命令列表。八、Coding Agents 與 LLM RouterNasiko 可以管理已安裝在本機的編碼 Agent CLI——記錄其行為、代理其 LLM 調(diào)用或兩者都做兩者是相互獨立的開關(guān)。支持Claude Code、Codex、Cursor CLI、OpenCode。會話上報Session reportingnasiko agents discover # 每個 Agent 的 DETECTED / CONNECTED / VERSION / CONFIG nasiko agents install agent # 安裝會話上報 hook nasiko agents uninstall agent nasiko agents sync # 將排隊的會話輪次事件刷到控制平面nasiko connect/nasiko use/nasiko auth login也會自動觸發(fā)安裝但僅針對尚無安裝記錄的 Agent——絕不會把已安裝的 Agent 靜默重綁到新集群重綁須顯式nasiko agents install agent。每個 Agent 會獲得一個 Stop/session-idle hook。已完成的輪次先本地排隊于~/.nasiko/integrations/queue/再投遞到POST /telemetry/coding-agent/events/batch因此控制平面短暫不可達不丟數(shù)據(jù)永久失敗的投遞如集群被刪除/改名后落入~/.nasiko/integrations/rejected/可安全刪除。攝入的輪次立即可作為聊天會話查看nasiko sessions、nasiko history id。Trace、token 數(shù)與成本還依賴CODING_AGENT_OTLP_ENDPOINT見下文。對應(yīng)的服務(wù)端實現(xiàn)位于 server/src/coding_agent_telemetry.rs 與 server/src/coding_agent_otlp.rs持久化模式見 migrations/0017_coding_agent_telemetry_events.sql。把 LLM 調(diào)用路由到 Nasikonasiko connect claude --config llm-config-name nasiko connect codex --config llm-config-name nasiko connect opencode --config llm-config-name nasiko disconnect agent # 回滾 settings/plugin 變更 nasiko status agent # 查看當(dāng)前綁定connect claude/connect codex把 Agent 的apiKeyHelper與*_BASE_URL指向 Nasiko于是每個請求通過POST /api/agents/{id}/llm-token鑄造一個短期 JWT。Claude Code 將該憑證放在x-api-key頭而非Authorization路由兩者都接受。connect opencode則安裝一個 JS 插件~/.config/opencode/plugins/nasiko-llm-router.js注冊nasikoprovider 并將nasiko/router設(shè)為新OpenCode 會話的默認模型——OpenCode 在會話創(chuàng)建時就把模型固定在自己的數(shù)據(jù)庫里所以恢復(fù)舊會話不會走路由需開新會話或顯式選擇 Nasiko Router。入站協(xié)議與出站 provider 完全解耦nasiko connect claude --config my-openai-config即可把 Claude Code 的 Anthropic 格式流量路由到 OpenAI。這一雙向翻譯能力在 llm-router/src/inbound/anthropic/openai/gemini 各一個解析器與 llm-router/src/providers/openai/anthropic/gemini/openrouter 出站實現(xiàn)中成對實現(xiàn)。~/.claude/settings.json與 OpenCode 配置是每用戶、全局的文件。連接某個 Agent 會影響本機上所有 Claude Code / OpenCode 進程而不只是當(dāng)前項目。LLM 配置管理nasiko llm-config create --name name --provider provider --model model nasiko llm-config list nasiko llm-config update name [--provider ...] [--model ...] nasiko llm-config set-default name nasiko llm-config attach name --agent agent # 掛接到已部署 Agent nasiko llm-config detach --agent agent nasiko llm-config get agent # 查看某 Agent 解析后的路由配置 nasiko llm-config providers # 合法 provider/model 取值 定價配置中的model字段是路由生效的必需項——未設(shè)置時list顯示provider/?。相關(guān)服務(wù)端配置變量作用AGENT_JWT_SECRET為每請求的短期路由 JWT 簽名。留空 ? 每個路由請求被 401 拒絕fail-closedCODING_AGENT_OTLP_ENDPOINT遙測 outbox worker 的 OTLP/HTTP JSON 基址服務(wù)端自動追加/v1/traces與/v1/logs。未設(shè)置則攝入回執(zhí)保持 pending、不啟動 workercoding-agent trace 到不了 Tempo/Loki九、環(huán)境變量總覽一切配置經(jīng)單一Config結(jié)構(gòu)體由環(huán)境變量驅(qū)動config/src/lib.rs約 500 行缺失的必需鍵在啟動時快速失敗。通過docker compose運行時基礎(chǔ)設(shè)施 URLDATABASE_URL、REDIS_URL、S3_ENDPOINT、OTel/Tempo/Loki、Agent 網(wǎng)絡(luò)由 docker-compose.yml 自動設(shè)置。全部變量及說明見 .env.example。變量用途默認值OPENAI_API_KEY路由 Agent 的 LLM provider可選sk-...SECRETS_ENCRYPTION_KEYBase64 32 字節(jié) AES-256-GCM 密鑰必填A(yù)DMIN_USERNAME/ADMIN_PASSWORD引導(dǎo)管理員賬號admin/changemeJWT_SECRETJWT 簽名密鑰必填S3_BUCKET/S3_ACCESS_KEY/S3_SECRET_KEY/S3_REGIONOCI registry 的 S3 存儲由 compose 設(shè)置AGENT_RUNTIME容器運行時OSS 中為dockerdockerDATABASE_URL/REDIS_URL/S3_ENDPOINT基礎(chǔ)設(shè)施連接由 compose 設(shè)置COMPOSIO_API_KEYComposio 平臺MCP 工具集可選SEED_TOOLKITS啟動時自動注冊的 Composio 工具集可選MCP_GATEWAY_PUBLIC_URL注入 Agent 的 MCP 網(wǎng)關(guān)公網(wǎng) URL由 compose 設(shè)置SEED_AGENTS啟動時自動部署的空格分隔鏡像列表可選AGENT_JWT_SECRET為 coding-agent LLM-router 請求令牌簽名nasiko connect必填CODING_AGENT_OTLP_ENDPOINTcoding-agent 遙測 outbox 的 OTLP/HTTP JSON 端點未設(shè)置worker 禁用ROUTER_MODEL/EMBEDDING_MODEL路由引擎模型見config/NASIKO_FLOW_MAX_DEPTH/NASIKO_FLOW_MAX_FAN_OUT/NASIKO_FLOW_MAX_TOKENSFlow-guard 級聯(lián)限制見config/源碼中這些鍵如何被解析可直接在 config/src/lib.rs 查證例如flow_max_depth、flow_max_fan_out、flow_max_tokens為 FlowGuard 的級聯(lián)上限embedding_model默認text-embedding-3-smallopenai_api_key未設(shè)置時跳過 Stage 1 向量初篩mcp_gateway_public_url未設(shè)置時部署期不注入 MCP 環(huán)境變量。十、項目結(jié)構(gòu)server/ 控制平面Axum 路由、認證、Agent 代理、構(gòu)建 worker、內(nèi)嵌 UI orchestrator/ 路由引擎語義化 Agent 選擇初篩、重排、選擇 mcp-gateway/ MCP 網(wǎng)關(guān)連接器、工具聚合、每 Agent 權(quán)限、OAuth llm-router/ provider 無關(guān)的 OpenAI 兼容出站代理Agent LLM 調(diào)用 runtime/ ContainerRuntime trait DockerRuntimebollard auth/ AuthService trait OSS 實現(xiàn)JWT 登錄、RBAC 鉤子 flow/ FlowGuard反 DoS 級聯(lián)限制 實時流事件 secrets/ Agent 密鑰靜態(tài) AES-256-GCM 加密 oci/ 內(nèi)嵌 OCI Distribution v2 registryS3 支撐、層去重 observability/ OTel 初始化、Tempo/Loki 客戶端、DB 模型定價 agent-proxy/ Agent ID - 運行容器端點解析 github/ GitHub OAuth 源碼部署的倉庫導(dǎo)入 types/ A2A 協(xié)議 registry 類型 config/ 單一環(huán)境變量驅(qū)動 Config 結(jié)構(gòu)體 utils/ 共享工具 cli/ nasiko 二進制Agent 開發(fā)者 CLIureq 同步 HTTP agents/ 示例與 seed Agent各自獨立 A2A 容器 migrations/ Postgres 遷移sqlx啟動時自動執(zhí)行 ui/ 前端vanilla JS web components內(nèi)嵌于服務(wù)端二進制 docs/ 設(shè)計文檔架構(gòu)、協(xié)議、約定十一、故障排查一條命令快速修復(fù)問題一條命令CLI 編譯失敗link.exe not found/cc not foundWindows走 Docker-only 路徑或winget install Microsoft.VisualStudio.2022.BuildTools --override --wait --quiet --add Microsoft.VisualStudio.Workload.VCTools --includeRecommended后重開終端CLI 編譯失敗dlltool ... Invalid bfd targetwinget install MSYS2.MSYS2并把C:\msys64\mingw64\bin放到C:\MinGW之前或改用 MSVCsource .env時報: command not foundsed -i s/\r$// server/.env啟動報invalid SECRETS_ENCRYPTION_KEYsed -i.bak s/^SECRETS_ENCRYPTION_KEY.*/SECRETS_ENCRYPTION_KEY$(openssl rand -base64 32)/ .env端口 9000/4317/4318address already in use停掉 Docker DesktopWindows 下wsl --shutdown再docker compose up -dDocker socketpermission deniedsudo usermod -aG docker $USER newgrp dockerWSLext4.vhdx: path not foundwsl --unregister Ubuntu wsl --install -d UbuntuAgent 上傳后500 agents_owner_id_fkey登出重登或docker compose down -v docker compose up -d后重新登錄服務(wù)端連不上 Postgresdocker compose up -d并等待healthyAgentName or service not knownLinux Docker用--add-host host.docker.internal:host-gateway重建啟動時SEED_TOOLKITS is set but COMPOSIO_API_KEY is not預(yù)期且無害——.env.example中SEED_TOOLKITS默認啟用設(shè)COMPOSIO_API_KEY才能真正注冊或注釋掉SEED_TOOLKITS消音分系統(tǒng)要點Windowslink.exe not found/linker cc not found未裝 MSVC C Build Tools可走 Docker-only 路徑或安裝帶 Desktop development with C 工作負載的 VS Build Toolsdlltool ... Invalid bfd target壞掉的 32 位 MinGW 無法構(gòu)建 64 位裝 MSYS2 或切 MSVCCRLF 破壞 bashsourcesed -i s/\r$// server/.envinvalid SECRETS_ENCRYPTION_KEY ... Invalid paddingopenssl rand -base64 32重新生成雙 Docker 引擎沖突保留一個wsl --shutdown后重啟WSL 內(nèi) Docker socket 權(quán)限sudo usermod -aG docker $USERagents_owner_id_fkey500舊庫的陳舊登錄 token登出重登或docker compose down -v后全新登錄。macOSlinker cc not found→xcode-select --installpermission denied ... Docker daemon→ 啟動 Docker Desktop 并等待引擎就緒端口占用 →lsof -i :9000定位占用進程。LinuxDocker socket 權(quán)限 →sudo usermod -aG docker $USER后重新登錄或newgrp docker構(gòu)建 CLI 缺工具鏈 →sudo apt install -y build-essential pkg-config libssl-devAgent[Errno -2]→ 原生 Docker 不提供host.docker.internal按 Path A 的 Linux 注記處理或把MCP_GATEWAY_PUBLIC_URL設(shè)為網(wǎng)橋 IP首次cargo構(gòu)建極慢屬正常整 workspace 編譯建議本地盤克隆而非掛載/9p 文件系統(tǒng)。全平臺啟動時failed to connect to Postgres→ 基礎(chǔ)設(shè)施未就緒docker compose up -d或just infra后等 healthydocker: command not found→ 安裝/啟動 DockerDashboard 加載不出 → 確認docker compose ps中server為Up再打開 http://localhost:8080。十二、延伸閱讀與許可設(shè)計文檔集中在 docs/A2A_PROTOCOL.md協(xié)議與錯誤碼、A2A_REGISTRY_DESIGN.md、AGENT_LIFECYCLE.md、MCP_GATEWAY_DESIGN.md、CLI_DESIGN.md、BOOTSTRAP_AND_NETWORKING.md、CONTROL_PLANE_UI.md、ORGANIZATION.md 等貢獻流程本地環(huán)境、代碼規(guī)范、PR 流程見 CONTRIBUTING.md其中同樣聲明了A2A-Version: 1.0請求頭為必需項許可Apache-2.0見 LICENSE。贊分享【免費下載鏈接】nasikoDeveloper Control Plane for your AI Agents項目地址https://gitcode.com/gh_mirrors/na/nasiko點擊查看免費下載相關(guān)推薦Dify 開源自托管部署與核心功能全景從 Docker Compose 快速上手到源碼級架構(gòu)解析Dify 開源自托管部署與核心功能全景從 Docker Compose 快速上手到源碼級架構(gòu)解析 本文以 Dify 倉庫官方繁體中文 README 為骨架完人工智能大模型LLMOpsAI 應(yīng)用RAGAI Agent低代碼Crossplane 云原生控制平面項目全景、源碼架構(gòu)與版本演進解讀Crossplane 云原生控制平面項目全景、源碼架構(gòu)與版本演進解讀 Crossplane 是一個無需編寫代碼即可構(gòu)建云原生控制平面的開源框架也是 CNCF云原生后端PyCaret 4.0 自托管 ML 平臺快速上手Docker Compose 部署、控制平面架構(gòu)與端到端訓(xùn)練部署實戰(zhàn)PyCaret 4.0 自托管 ML 平臺快速上手Docker Compose 部署、控制平面架構(gòu)與端到端訓(xùn)練部署實戰(zhàn) PyCaret 4.0 是一個開源的、上一篇ParlAI 預(yù)訓(xùn)練 Transformer 模型庫實戰(zhàn)從 ConvAI2 實時對話到多任務(wù)微調(diào)下一篇終極黑蘋果實戰(zhàn)指南7個專業(yè)步驟在普通PC上完美運行macOS系統(tǒng)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考