GBrain 远程 MCP 服务器部署方案全解ngrok、Tailscale 与云主机对比与实战【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrainGBrain 的 MCP 服务器默认以 stdio 传输运行gbrain serve仅供本机 Agent 使用。本文基于 docs/mcp/ALTERNATIVES.md 与 docs/mcp/DEPLOY.md 等配套文档系统讲解如何借助内置 HTTP 传输gbrain serve --http与公网隧道把大脑安全地暴露给其他设备与 AI 客户端并逐项对比 ngrok、Tailscale Serve/Funnel、Fly.io/Railway 三种主流方案的适用场景、成本与安全性。读完本文你将能够按自己的隐私要求与预算选型并完成一套可远程访问、带 OAuth 2.1 认证的 GBrain MCP 服务。前置gbrain serve --http内置 HTTP 传输一切远程部署都建立在同一个前提之上GBrain 自带一个内置 HTTP 传输无需任何额外服务即可让远程客户端通过 MCP 协议访问大脑。gbrain serve --http --port 8787从源码结构看--http在 src/commands/serve.ts 中分发到独立的runServeHttp实现在 src/commands/serve-http.ts该模块组合了 MCP SDK 的mcpAuthRouterOAuth 端点/authorize、/token、/register、/revoke、工具调用端点/mcp、位于/admin的内置 React 管理面板、/admin/events的 SSE 实时活动流以及/health健康检查。它同时支持 PGLite 与 Postgres 两种引擎的 brain是远程部署唯一的正式推荐路径。gbrain serve --http开箱即带以下安全与审计能力详见 docs/mcp/DEPLOY.md 与 SECURITY.mdOAuth 2.1 全套协议客户端凭证client credentials、授权码 PKCE、刷新令牌轮换可选动态客户端注册DCR。Legacy bearer 兼容verifyAccessToken会回退到access_tokens表未带scopes的令牌默认携带readwriteadmin用gbrain auth create --scopes …铸造的令牌则严格按其授予的 scope 生效。默认拒绝的 CORS、双桶限流、请求体大小上限、按请求审计日志mcp_request_log。关键启动参数默认值取自 src/commands/serve.ts参数默认值说明--http关闭启用 HTTP 传输否则为 stdio--port3131监听端口--bind127.0.0.1监听网卡。v0.34.1 起默认仅回环远程访问必须显式--bind 0.0.0.0或指定网卡 IP--public-urlhttp://localhost:port外部可达的公开 URL作为 OAuth issuer 写入发现元数据RFC 8414--token-ttl3600秒访问令牌有效期--enable-dcr关闭开启动态客户端注册RFC 7591--enable-dcr-insecure关闭允许 DCR 客户端使用跳过所有者审批的 client_credentials 授权隐含--enable-dcr--surfacefull工具面verbs仅 7 个记忆动词、starter约 27 个日常操作、full全部操作方案一ngrok 公网隧道推荐ngrok 提供即时的公网隧道。Hobby 档约 $8/月提供永不变化的固定域名这是推荐它的核心理由免费档的 URL 每次重启都会变化会连带打断 Twilio webhook、Claude Desktop 等所有依赖固定地址的集成。# 1. 安装 ngrok brew install ngrok # 2. 启动内置 HTTP 传输 gbrain serve --http --port 8787 # 令牌配置见 docs/mcp/DEPLOY.md # 3. 通过 ngrok 暴露 ngrok http 8787 --url your-brain.ngrok.app完整安装流程含 auth token 配置、固定域名申请、守护进程见 recipes/ngrok-tunnel.md。该配方记录了生产环境中最容易踩的三个坑Claude Desktop 必须走 GUI远程 MCP 服务器只能通过 Settings Integrations 添加claude_desktop_config.json配置会静默失败。免费档 URL 是临时的每次重启都会变需要看门狗脚本自动拉起 ngrok并在无固定域名时回写 Twilio webhook。一个域名对应一个本地端口ngrok http port会把所有路径转发到单一端口若要同一域名同时路由/mcp与/voice到不同端口需要 ngrok 流量策略或本地反向代理。配方的看门狗模式watchdog是生产部署的要点通过 cron 每 2 分钟检查pgrep -f ngrok.*http未运行则自动重启并可用curl -sf http://localhost:4040/api/tunnels校验隧道健康状态。验证隧道后Claude Code 可用claude mcp add gbrain -t http https://your-brain.ngrok.app/mcp -H Authorization: Bearer YOUR_GBRAIN_TOKEN直接接入。方案二Tailscale Serve / Funneltailnet 私有或公网Tailscale 提供永久的 MagicDNS 名称与自动 TLS免费档可用。两种模式仅一字之差但暴露范围完全不同特性tailscale servetailscale funnel可达范围仅你的 tailnet公网适用场景自己的设备不对外暴露必须主动连入的云连接器ChatGPT、Claude.ai是否占用公网暴露面否是# 1. 安装 Tailscale brew install tailscale # 2. 以 Tailscale 呈现的 HTTPS issuer 启动 gbrain默认 127.0.0.1 绑定即可 gbrain serve --http --port 8787 --public-url https://your-machine.your-tailnet.ts.net # 3a. 仅 tailnet 内访问 tailscale serve --bg 8787 # 3b. 公网访问 tailscale funnel 8787 # 你的 brain 现在位于 https://your-machine.your-tailnet.ts.net/mcp注意tailscale serve模式下--public-url已设置但未传--bind时启动会打印 WARN这是预期行为——Tailscale Serve 会把流量转发到 loopback因此保持默认回环绑定是正确的。这一点在 docs/mcp/DEPLOY.md 的「Tailnet / LAN-only」一节有专门说明。如果你需要纯 HTTP、仅 bearer、无任何 TLS 的局域网端点可以不传--public-url直接绑定 tailnet/LAN 网卡gbrain serve --http --port 3131 --bind 100.x.y.z # 或 --bind 0.0.0.0该形态下 OAuth issuer 默认回落到http://localhost:3131MCP SDK 接受bearer 校验完全不读取 issuer代价是不提供 OAuth 发现能力因此依赖 OAuth 的客户端如 ChatGPT需要上面的 HTTPS 形态。方案三Fly.io / Railway 云主机7×24 常驻前两种方案都依赖你的笔记本在线。需要 24/7 无停机生产部署时选择云主机Fly.io约 $5-10/月全球边缘节点fly deploy一键部署。Railway约 $5/月git push 触发部署。两者都以 Bun 原生运行 GBrain无需打包、无需 Deno、无冷启动、无超时限制。部署时注意两点生产化配置用GBRAIN_ADMIN_BOOTSTRAP_TOKEN预设管理员令牌非 TTY 启动时生成的令牌会被隐藏避免进入日志存储并显式--bind 0.0.0.0 --public-url https://你的域名。方案对比维度ngrokTailscaleFly.io/Railway成本$8/月Hobby免费$5-10/月固定 URL有Hobby 档有有笔记本关机时仍可用否否是冷启动无无无超时限制无无无完整远程操作面100 操作除localOnly外有有有搭建时间5 分钟10 分钟15 分钟关于「完整远程操作面」需要说明一个重要的安全边界所有 HTTP 请求都受每个令牌 scope 的约束且标记为localOnly: true的操作如sync_brain与file_*系列无论 scope 如何在 HTTP 下都会被直接拒绝。远程 Agent 无法触达本地文件系统面。这一约束可以在 src/core/operations.ts 的操作目录中看到sync 与 files 区域均标注 localOnly。选型决策要点个人跨设备使用、在意零暴露选 Tailscale Serve——只有你的 tailnet 可达公网零暴露面免费。需要接入 ChatGPT / Claude.ai 等云端连接器必须公网可达选 ngrokHobby 固定域名或 Tailscale Funnel。笔记本经常关机但要常驻服务选 Fly.io / Railway。最简方案如果你已在用 Tailscaletailscale funnel与 ngrok 功能等价且免费若未用 Tailscalengrok 上手最快。绑定与 OAuth issuer 的一致性高频故障点远程部署最常见的故障是「隧道起来了但 Agent 报 ECONNREFUSED」根因是--bind与--public-url不匹配--public-url设置了但没传--bind启动时会在 stderr 打印 WARN默认仍只绑定 loopback远程全部被拒。--bind 0.0.0.0但未设置GBRAIN_HTTP_CORS_ORIGIN也会告警浏览器类客户端拿不到 CORS 头直到你配置允许列表。正确姿势以 ngrok 为例gbrain serve --http --port 3131 --bind 0.0.0.0 --public-url https://your-brain.ngrok.app--public-url同时决定 OAuth issuer发现端点位于/.well-known/oauth-authorization-server受保护资源元数据RFC 9728位于/.well-known/oauth-protected-resource/mcp每个 401 都会携带WWW-Authenticate: Bearer resource_metadata该 URL因此 MCP 客户端只需指向https://your-brain.ngrok.app/mcp即可从全新连接中发现令牌端点无需粘贴任何 URL。生产环境加固建议scope 最小化gbrain auth create name --scopes read铸造窄权限令牌取代无 scope 的全权令牌。DCR 默认关闭动态客户端注册默认关闭--enable-dcr才开启。开启后自注册客户端最多只能申请read writeadmin等特权 scope 会被 400 拒绝每个授权码连接仍需管理员在/admin面板审批。令牌生命周期DCR 请求可携带token_ttl_seconds但会被钳制在管理员配置窗口内默认 min 300 秒、max 由你的--token-ttl决定可gbrain config set oauth.dcr_ttl_min_seconds 600放宽。容器内 Postgres 网络隔离OAuth scope 只保护gbrain serve --http路径不保护裸 Postgres——同 Docker 主机上的其他容器若共享默认 bridge 网络可直接开 DB 会话绕过认证。生产环境务必把 Postgres 放到独立用户自定义网络发布宿主机端口时仅绑定 loopback。PID 1 问题若gbrain serve是容器 entrypoint用 tini /--init包装避免孤儿进程堆积ENTRYPOINT [/usr/bin/tini, --, gbrain, serve, --http]。反向代理信任仅在可信代理后设置GBRAIN_HTTP_TRUST_PROXY防止客户端伪造X-Forwarded-For绕过预认证 IP 限流。常见排障速查现象处理missing_auth请求缺少Authorization: Bearer YOUR_TOKEN头invalid_token运行gbrain auth list查看有效令牌客户端显示 needsAuth 但工具调用成功客户端探测/mcp时未带 Authorization 头把规范要求的发现 401 误判为登录失败用whoami输出transport: legacy或gbrain auth test url --token t确认启动报 Issuer URL must be HTTPSMCP SDK 拒绝非 HTTPS 的 OAuth issuer除非 host 是 localhost/127.0.0.1。在 ngrok/Tailscale Serve 后面终止 TLS 并传https://URL或干脆不传--public-url走 bearer-only LAN 形态service_unavailable数据库连接失败检查数据库服务状态各主流客户端的接入指引分别见 docs/mcp/CHATGPT.mdOAuth 2.1 PKCE必须--http、docs/mcp/CLAUDE_CODE.md、docs/mcp/CLAUDE_DESKTOP.md必须 GUI 添加、docs/mcp/CLAUDE_COWORK.md、docs/mcp/PERPLEXITY.md。总结GBrain 的远程部署有一条清晰的决策路径本地 stdio 零配置起步需要跨设备时用gbrain serve --http 隧道。隐私优先选 Tailscale Serve零公网暴露需要接入云连接器选 ngrok Hobby 或 Tailscale Funnel需要常驻服务选 Fly.io/Railway。无论走哪条路内置的 OAuth 2.1、scope 最小化、localOnly硬边界与默认拒绝的 CORS 共同构成了可审计、可隔离的远程访问基线。更多环境变量与可调参数请继续阅读 docs/mcp/DEPLOY.md 与 SECURITY.md。【免费下载链接】gbrainGarrys Opinionated OpenClaw/Hermes Agent Brain项目地址: https://gitcode.com/gh_mirrors/gb/gbrain创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考