阿里云 ECS 安装 Playwright 下载超级慢

阿里云 ECS 安装 Playwright 下载超级慢，核心原因是：Playwright 默认从微软 Azure CDN（国外）下载浏览器二进制，国内服务器直连速度极慢（通常几十 KB/s）。

一、最快方案：使用国内镜像（推荐）

设置环境变量 PLAYWRIGHT_DOWNLOAD_HOST，强制从阿里云/淘宝 NPMMirror 国内镜像下载，速度可提升 10~50 倍。

Linux / macOS（阿里云服务器）

# 临时生效（当前终端）
export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright/

# 安装（只装Chromium，更快）
playwright install chromium
# 或装全部
# playwright install

永久生效（推荐）

echo 'export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright/' >> ~/.bashrc
source ~/.bashrc

Windows（CMD/PowerShell）

$env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright/"
npx playwright install chromium

二、第二方案：只装需要的浏览器（减少体积）

Playwright 默认装 Chromium + Firefox + WebKit（约 300MB），你通常只需要 Chromium：

# 只装Chromium（最快）
playwright install chromium

# 只装Firefox
# playwright install firefox

三、第三方案：手动下载（镜像仍慢时）

1. 从镜像下载对应版本 .zip（Linux 为例）：

   https://npmmirror.com/mirrors/playwright/chromium/1091/chromium-linux.zip
   

   （版本号 1091 要和你 playwright --version 匹配）

2. 上传到阿里云服务器，解压到：

   # Linux 路径
   ~/.cache/ms-playwright/chromium-1091/
   
   # 解压
   unzip chromium-linux.zip -d ~/.cache/ms-playwright/chromium-1091/
   

3. 再执行：

   playwright install chromium  # 会跳过下载
   

四、第四方案：代理加速（有海外代理时）

# 临时设置代理
export HTTPS_PROXY=http://你的代理IP:端口
export HTTP_PROXY=http://你的代理IP:端口

playwright install chromium

五、常见问题排查

• 超时失败：加长超时

  export PLAYWRIGHT_DOWNLOAD_CONNECTION_TIMEOUT=600000  # 10分钟
  

• 权限不足

  sudo playwright install chromium  # 临时用sudo
  # 或修正目录权限
  sudo chown -R $USER:$USER ~/.cache/ms-playwright/
  

• 镜像404：降级 Playwright 到 1.48.0（镜像最完整）

  npm install playwright@1.48.0 -D
  

六、一键执行（阿里云Linux直接复制）

# 1. 加速源
export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright/
# 2. 加长超时
export PLAYWRIGHT_DOWNLOAD_CONNECTION_TIMEOUT=600000
# 3. 只装Chromium
playwright install chromium