解决Puppeteer无法访问Docker Swarm内部网络URL的问题

可能的原因与对应解决方案 #

1. 禁用Chromium沙箱 #

Docker容器默认权限不足以运行Chromium的沙箱机制，这会导致页面加载异常或超时。启动Puppeteer时添加以下参数：

const browser = await puppeteer.launch({
  executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
  args: [
    '--no-sandbox',
    '--disable-setuid-sandbox'
  ]
});

2. 调整页面加载的超时与等待策略 #

默认的page.goto会等待页面完全加载（waitUntil: 'load'），如果内部服务页面存在未完成的异步请求或资源加载缓慢，会触发超时。可以修改等待条件或延长超时时间：

// 仅等待DOM加载完成
await page.goto('http://srv-captain--mynodehost/app/mypage.html', {
  waitUntil: 'domcontentloaded',
  timeout: 30000 // 延长至30秒
});

// 或等待网络空闲（500ms内无新请求）
await page.goto('http://srv-captain--mynodehost/app/mypage.html', {
  waitUntil: 'networkidle2',
  timeout: 30000
});

3. 确保内部域名解析正常 #

Chromium的DNS解析逻辑和Node.js HTTP客户端存在差异，可能导致内部服务域名无法正确解析。可以尝试两种方式：

• 直接使用容器内部IP：找到静态服务容器的内部IP，替换URL中的域名
• 强制域名解析规则：启动Chromium时添加--host-resolver-rules参数指定映射：

const browser = await puppeteer.launch({
  executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
  args: [
    '--no-sandbox',
    '--host-resolver-rules="MAP srv-captain--mynodehost 172.18.0.5"' // 替换为实际内部IP
  ]
});

4. 禁用Chromium代理设置 #

若Chromium默认启用了代理，会导致内部网络请求无法正常发送。添加参数禁用代理：

const browser = await puppeteer.launch({
  executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
  args: [
    '--no-sandbox',
    '--no-proxy-server'
  ]
});

5. 开启Chromium调试日志定位问题 #

如果以上方法无效，可开启Chromium日志输出，排查具体加载错误：

const browser = await puppeteer.launch({
  executablePath: process.env.PUPPETEER_EXECUTABLE_PATH,
  args: [
    '--no-sandbox',
    '--enable-logging=stderr',
    '--v=1' // 可调整数值提高日志详细程度
  ],
  dumpio: true // 将Chromium输出转发到Node.js进程日志
});

查看容器日志，定位具体故障点（如DNS解析失败、连接被拒绝等）。

内容的提问来源于stack exchange，提问作者drmrbrewer