浏览器环境设置

一键安装和验证 Playwright + Chromium 浏览器自动化环境。

快速流程

按顺序执行以下三步：

步骤 1：检查系统兼容性

bash
bash scripts/check-compat.sh

检查项：操作系统、内存（≥2GB，推荐 4GB+）、CPU（≥2核）、磁盘（≥1GB）、Node.js（≥18）、Xvfb 状态。

如果 FAIL > 0，先解决问题再继续。

步骤 2：安装浏览器环境

bash
bash scripts/install-browser.sh <工作目录路径>

自动完成：

• - 安装 Xvfb 虚拟显示器（Linux）+ Chrome 系统依赖
• 安装 Playwright npm 包（全局 + 项目内）
• 下载 Chromium + Chrome Headless Shell
• 创建 scripts/start-xvfb.sh 辅助脚本

步骤 3：验证

bash

无头模式（适合服务器）

bash scripts/verify-browser.sh <工作目录> /tmp/browser-verify.png headless

有头模式（模拟真实用户，需先启动 Xvfb）

bash scripts/verify-browser.sh <工作目录> /tmp/browser-verify.png headed

验证脚本会：打开百度 → 截取屏幕 → 输出标题和热搜第一 → 返回截图路径。

有头模式说明

服务器环境没有物理显示器，需要 Xvfb 创建虚拟显示器：

bash
export DISPLAY=:99
Xvfb :99 -screen 0 1280x900x24 -ac &

之后 Playwright 设置 headless: false，浏览器在虚拟显示器中运行，行为与真实用户完全一致（加载所有扩展、渲染 WebGL、触发真实 DOM 事件）。

Playwright 代码示例

javascript
const { chromium } = require(playwright);

const browser = await chromium.launch({
headless: false, // 有头模式
args: [--no-sandbox] // 服务器环境必需
});
const page = await browser.newPage();
await page.goto(https://www.baidu.com);
await page.screenshot({ path: /tmp/screenshot.png });
await browser.close();

截图发送到飞书

验证脚本生成截图后，可通过飞书 API 上传并发送：

bash

1. 上传图片获取 image_key

IMAGE_KEY=$(curl -s -X POST https://open.feishu.cn/open-apis/im/v1/images \
-H Authorization: Bearer $TENANT_TOKEN \
-F image_type=message \
-F image=@/tmp/browser-verify.png | python3 -c import sys,json; print(json.load(sys.stdin)[data][image_key]))

2. 发送图片消息

curl -s -X POST https://open.feishu.cn/open-apis/im/v1/messages?receiveidtype=open_id \ -H Authorization: Bearer $TENANT_TOKEN \ -H Content-Type: application/json \ -d {receiveid:id>,msgtype:image,content:{\imagekey\:\$IMAGE_KEY\}}