使用 Docker Compose 部署 MCP 隧道

此路径要求主机具有 OIDC 身份提供商（例如云虚拟机元数据服务器或 SPIFFE）。如果没有，请改用不使用编程访问选项卡。

setup 组件使用 Workload Identity Federation 获取隧道令牌、生成 CA 和服务器证书，并向 Anthropic 注册 CA。

1. 1

   准备部署目录

   mkdir -p mcp-tunnel/{config,data}
   cd mcp-tunnel
   sudo chown 65532:65532 data

   

   容器以非 root UID 65532 运行，需要对 data/ 具有写入权限。

2. 2

   编写 docker-compose.yaml

   该 compose 文件通过 SHA-256 摘要固定镜像，以非 root 身份和只读文件系统运行每个容器，丢弃所有 Linux capabilities，并禁用权限提升。

   cat > docker-compose.yaml <<'EOF'
   services:
     setup:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       entrypoint: ["/setup"]
       command:
         - init
         - --api-url=https://api.anthropic.com
         - --output=dir:/data
         - --token-version=1
       environment:
         - TUNNEL_ID
         - ANTHROPIC_FEDERATION_RULE_ID
         - ANTHROPIC_ORGANIZATION_ID
         - ANTHROPIC_WORKSPACE_ID
         - ANTHROPIC_IDENTITY_TOKEN
       volumes:
         - ./data:/data
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       profiles: ["setup"]
   
     cloudflared:
       image: cloudflare/cloudflared@sha256:6b599ca3e974349ead3286d178da61d291961182ec3fe9c505e1dd02c8ac31b0
       command: tunnel --no-autoupdate run --url http://localhost:8080
       environment:
         - TUNNEL_TOKEN
       # 共享代理的 netns，以便通过 localhost:8080 访问它。
       network_mode: "service:mcp-proxy"
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   
     mcp-proxy:
       image: us-docker.pkg.dev/anthropic-public-registry/images/mcp-proxy@sha256:efb27b299d627e4134815663cb8896641eeaee025d734c0f695582b4df38f013
       volumes:
         - ./config/mcp-proxy.yaml:/etc/mcp-gateway/config.yaml:ro
         - ./data:/data:ro
       restart: unless-stopped
       user: "65532:65532"
       read_only: true
       security_opt:
         - no-new-privileges:true
       cap_drop:
         - ALL
       stop_grace_period: 30s
       logging:
         options:
           max-size: "10m"
           max-file: "3"
   EOF

   

   如果您使用的是示例 MCP 服务器，请将其作为服务追加：

   cat >> docker-compose.yaml <<'EOF'
   
     hello-mcp:
       image: python:3.13-slim
       working_dir: /app
       volumes:
         - ./hello_server.py:/app/hello_server.py:ro
       command: sh -c "pip install --quiet mcp && python hello_server.py"
       restart: unless-stopped
   EOF

   
3. 3

   配置隧道

   设置标识符。不设置 TUNNEL_ID 可让 setup 组件创建隧道；设置它则附加到来自 Console 的现有隧道：

   # export TUNNEL_ID=tnl_...   # 设置此项以连接到现有隧道
   export ANTHROPIC_FEDERATION_RULE_ID=fdrl_...
   export ANTHROPIC_ORGANIZATION_ID=00000000-0000-0000-0000-000000000000

   

   如果您的联合规则的作用域是组织默认工作区以外的工作区，还需设置 ANTHROPIC_WORKSPACE_ID=wrkspc_...；否则 setup 组件使用默认工作区。自动创建的隧道会创建在该工作区中。

   将 ANTHROPIC_IDENTITY_TOKEN 设置为来自此主机身份提供商的 OIDC JWT。请按照适用于您提供商的 WIF 指南注册颁发者、设置规则的 subject 并签发令牌；规则的 audience 必须与您签发时请求的 audience 匹配。

   运行 setup 组件：

   docker compose run --rm setup

   

   setup init 对 data/ 是幂等的：重新运行它会复用已存储在其中的隧道 ID 和 CA，绝不会创建第二个隧道。仅当 data/ 为空或 TUNNEL_ID 已更改时，才会生成并注册新的 CA；在这种情况下，适用两个活动证书的上限，因此如果两个槽位都已占用，请先在 Console 中吊销一个。

   如果出错，请参阅 Setup 组件身份验证失败。

   获取您的隧道域名并将其导出以供后续步骤使用：

   export TUNNEL_DOMAIN=$(sudo cat data/tunnel-domain)
   echo "$TUNNEL_DOMAIN"

   
4. 4

   编写代理配置

   tunnel_domain 是必需的：代理使用它从传入的主机名中剥离域名后缀，然后在 routes 中查找子域名。routes 是从子域名到上游 URL 的扁平映射，而不是列表。

   cat > config/mcp-proxy.yaml <<EOF
   listen_addr: ":8080"
   log_level: info
   shutdown_timeout: 30s
   tunnel_domain: ${TUNNEL_DOMAIN}
   tls:
     cert_file: /data/tls.crt
     key_file: /data/tls.key
   routes:
     echo: http://hello-mcp:9000
   EOF

   

   echo: 路由指向示例 MCP 服务器；请将其替换为（或添加）您自己的路由。有关所有可用字段，请参阅代理配置参考。

5. 5

   启动部署

   export TUNNEL_TOKEN=$(sudo cat data/tunnel-token)
   docker compose up -d

   