使用Browserless Chrome Docker+Watir无法修改下载目录求助

核心矛盾分析 #

用Browserless Chrome Docker配合Watir做无头下载时，改不了下载目录的核心问题集中在本地与容器路径隔离、Remote WebDriver配置传递逻辑，以及Browserless自身的功能限制上，以下是具体排查思路：

1. 修正路径映射（最常见原因）

你代码里写的#{Rails.root.to_s}/tmp是本地主机路径，但Docker容器无法直接访问本地目录，必须通过挂载把本地目录映射到容器内部，同时代码要改用容器内的路径：

• 修改Docker启动命令，挂载本地Rails tmp目录到容器内对应路径：

  docker run -p 3000:3000 -v #{Rails.root.to_s}/tmp:/app/tmp browserless/chrome:latest
  

• 调整Ruby代码中的下载目录为容器内路径：

  @download_directory = "/app/tmp"
  

2. 开启Browserless的下载支持

Browserless默认可能禁用了下载功能，启动容器时需要显式开启：

• 启动命令添加--enable-downloads参数，还可通过环境变量指定默认下载路径：

  docker run -p 3000:3000 -v #{Rails.root.to_s}/tmp:/app/tmp -e DEFAULT_DOWNLOAD_PATH=/app/tmp browserless/chrome:latest --enable-downloads
  

3. 调整Remote WebDriver的配置格式

Remote模式下，Watir传递Chrome配置时，需要把prefs和args包裹在chromeOptions节点下（部分WebDriver版本有此要求），修改代码中的options结构：

options = {
  chromeOptions: {
    prefs: {
      'download' => {
        'default_directory' => '/app/tmp',
        'prompt_for_download' => false,
        'directory_upgrade' => true,
      }
    },
    args: ['--headless', '--no-sandbox']
  }
}

@browser = Watir::Browser.new(:chrome, options: options, url: "#{chrome_url}/webdriver")

4. 验证容器内目录的写入权限

挂载后的目录在容器内可能权限不足，导致Chrome无法写入：

• 临时开放本地#{Rails.root}/tmp目录权限（比如设为777测试）
• 或者启动容器时指定用户权限，比如添加--user root参数（仅测试用，生产环境谨慎使用）：

  docker run -p 3000:3000 -v #{Rails.root.to_s}/tmp:/app/tmp --user root browserless/chrome:latest --enable-downloads
  

5. 查看Browserless日志定位错误

启动容器后观察控制台输出，或用docker logs <container-id>查看日志，重点关注是否有"permission denied"或"directory not found"类报错。

内容的提问来源于stack exchange，提问作者Jorge Najera T