在n8n中集成playwright-mcp时，Docker网络配置是确保浏览器自动化服务正常通信的关键环节。核心问题在于如何让运行在Docker容器内的n8n能够访问宿主机上运行的playwright-mcp MCP服务器。以下是详细的配置方案和实践指南。 ### 1. Docker网络模式选择与配置 当n8n运行在Docker容器中时，默认的网络隔离会导致`localhost`指向容器自身而非宿主机。因此，需要使用特殊的地址来访问宿主机服务。 | 网络场景 | 推荐方案 | 访问地址 | 说明 | |---------|---------|---------|------| | **默认桥接网络** | 使用Docker内部DNS | `host.docker.internal` (macOS/Windows) | Docker Desktop提供的特殊主机名，自动解析到宿主机IP | | **Linux原生Docker** | 使用网关IP或自定义网络 | `172.17.0.1` (默认网关) 或创建自定义网络 | 需要确定Docker网桥的网关地址 | | **Docker Compose** | 共享网络或自定义网络 | 服务名(如`playwright-mcp`) 或自定义网络IP | 将服务置于同一网络，可直接通过服务名访问 | **关键配置示例：** ```yaml # docker-compose.yml 示例 - 创建共享网络 version: '3.8' services: n8n: image: n8nio/n8n ports: - "5678:5678" networks: - automation-net # 其他配置... playwright-mcp: build: . ports: - "8931:8931" networks: - automation-net # 其他配置... networks: automation-net: driver: bridge ``` ### 2. playwright-mcp服务器启动配置 启动playwright-mcp服务器时，需要确保它监听正确的网络接口： ```bash # 在宿主机启动playwright-mcp，监听所有网络接口 npx @playwright/mcp@latest --port 8931 --host 0.0.0.0 # 验证服务可访问性 curl http://localhost:8931/mcp # 宿主机本地测试 curl http://host.docker.internal:8931/mcp # 从容器内部测试 ``` > **注意**：使用`--host 0.0.0.0`参数至关重要，这允许服务器接受来自任何IP地址的连接，包括Docker容器的连接[ref_6]。 ### 3. n8n中的MCP凭证配置 在n8n工作流编辑器中配置MCP凭证时，URL地址需要根据Docker网络环境进行调整： 1. **进入n8n凭证管理** - 点击左侧菜单"Credentials" - 选择"Add Credential" - 搜索并选择"MCP" 2. **配置连接参数：** | 参数 | Docker Desktop环境 | Linux Docker环境 | Docker Compose环境 | |------|-------------------|-----------------|-------------------| | **Server URL** | `http://host.docker.internal:8931` | `http://172.17.0.1:8931` | `http://playwright-mcp:8931` | | **Authentication** | 通常无需认证 | 同上 | 同上 | | **Connection Timeout** | 建议30秒 | 建议30秒 | 建议30秒 | ```javascript // n8n中MCP节点的配置示例（通过代码查看） { "resource": "MCP", "operation": "executeCommand", "credentialId": "your-mcp-credential-id", "serverUrl": "http://host.docker.internal:8931", "command": "browser.newPage", "parameters": { "url": "https://example.com" } } ``` ### 4. 网络连通性测试工作流 创建一个专门的测试工作流来验证网络连接： ```javascript // n8n工作流JSON片段 - 网络测试节点 { "nodes": [ { "name": "HTTP Request - 测试MCP连接", "type": "n8n-nodes-base.httpRequest", "position": [250, 300], "parameters": { "url": "http://host.docker.internal:8931/mcp", "method": "GET", "responseFormat": "json" } }, { "name": "IF节点 - 检查响应", "type": "n8n-nodes-base.if", "position": [450, 300], "parameters": { "conditions": { "string": [ { "value1": "={{$json['version']}}", "operation": "notEmpty" } ] } } } ] } ``` ### 5. 常见问题排查与解决方案 #### 问题1：连接超时或拒绝连接 **症状**：n8n报错"Connection refused"或"Timeout" **解决方案**： ```bash # 1. 检查playwright-mcp是否在运行 ps aux | grep playwright-mcp # 2. 检查端口监听情况 netstat -tuln | grep 8931 # 3. 从容器内部测试连接 docker exec -it n8n-container curl http://host.docker.internal:8931/mcp # 4. 调整防火墙规则（如果需要） sudo ufw allow 8931/tcp ``` #### 问题2：DNS解析失败 **症状**：无法解析`host.docker.internal` **解决方案**： ```bash # 1. 检查容器内的DNS配置 docker exec -it n8n-container cat /etc/resolv.conf # 2. 使用IP地址替代主机名 # 获取宿主机在Docker网络中的IP ip addr show docker0 | grep inet # 3. 或者在docker run时指定hosts docker run --add-host=host.docker.internal:host-gateway n8nio/n8n ``` #### 问题3：跨域问题（CORS） **症状**：浏览器控制台显示CORS错误 **解决方案**： ```bash # 启动playwright-mcp时启用CORS npx @playwright/mcp@latest --port 8931 --host 0.0.0.0 --cors # 或者在n8n的HTTP Request节点中添加CORS头 { "headers": { "parameters": [ { "name": "Origin", "value": "http://localhost:5678" } ] } } ``` ### 6. 生产环境最佳实践 1. **使用Docker Compose编排**： ```yaml # 完整的生产级docker-compose.yml version: '3.8' services: n8n: image: n8nio/n8n:latest container_name: n8n-automation restart: unless-stopped ports: - "5678:5678" environment: - N8N_PROTOCOL=http - N8N_HOST=localhost - N8N_PORT=5678 - N8N_METRICS=true volumes: - n8n_data:/home/node/.n8n networks: - automation-network playwright-mcp: image: playwright/mcp:latest container_name: playwright-mcp-server restart: unless-stopped ports: - "8931:8931" environment: - PLAYWRIGHT_MCP_HOST=0.0.0.0 - PLAYWRIGHT_MCP_PORT=8931 networks: - automation-network networks: automation-network: driver: bridge ipam: config: - subnet: 172.20.0.0/16 volumes: n8n_data: ``` 2. **安全加固措施**： - 使用内部网络，不暴露MCP端口到公网 - 启用TLS加密通信 - 实施API密钥认证 - 配置IP白名单限制 3. **监控与日志**： ```bash # 查看容器日志 docker logs n8n-container --tail 100 docker logs playwright-mcp-server --tail 100 # 监控网络连接 docker network inspect automation-network ``` 通过以上配置，可以确保n8n与playwright-mcp在Docker环境中稳定通信。关键点在于正确理解Docker的网络模型，选择合适的网络策略，并进行充分的连通性测试。在生产环境中，建议使用Docker Compose进行服务编排，并实施相应的安全措施[ref_4][ref_6]。