# @chegger/node-obscura-aws-lambda 中文文档

规范地址：https://npmcn.com/package/%40chegger/node-obscura-aws-lambda/

版本：0\.2\.6
npm 元数据更新时间：2026-11-05T06:29:24.075Z
中文译文更新时间：2026-11-09T18:26:10.136Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chegger/node-obscura-aws-lambda
原文对照：https://npmcn.com/package/%40chegger/node-obscura-aws-lambda/?lang=original
项目主页：https://github.com/chegger/node-obscura-aws-lambda#readme
源码仓库：https://github.com/chegger/node-obscura-aws-lambda

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：23.8 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-05-05T12:45:48.718Z
- 最新版本发布：2026-11-05T06:29:23.774Z
- 近 30 天下载量：1948（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

AWS Lambda特有节点.js 运行时间包装为Obscura浏览器二进制.

## 安装

```sh
npm install @chegger/node-obscura-aws-lambda
```

也可以使用：`pnpm add @chegger/node-obscura-aws-lambda`、`yarn add @chegger/node-obscura-aws-lambda`、`bun add @chegger/node-obscura-aws-lambda`

## README

# @chegger/node-obscura-aws-lambda (英语)

AWS Lambda 特有节点.js 包装 [淫荡](https://github.com/h4ckf0r0day/obscura) 浏览器 二进制 .

-   **阴道:** 与此软件包相同的版本(参见 `package.json`; 已建标签和校验和已输入 `dist/build-metadata.json`(中文(简体) )
-   **目标运行时间 :** AWS 兰布达 `nodejs24.x` 关于 Linux x64 的

## 安装

```bash
npm install @chegger/node-obscura-aws-lambda
```

## 使用量

```js
const { chromium } = require('playwright-core');
const { startObscura } = require('@chegger/node-obscura-aws-lambda');

async function main() {
  const obscura = await startObscura({ stealth: true });
  const browser = await chromium.connectOverCDP(obscura.endpoint);

  try {
    const context = browser.contexts()[0] || (await browser.newContext());
    const page = await context.newPage();
    await page.goto('https://example.com');
    console.log(await page.title());
  } finally {
    await browser.close();
    await obscura.close();
  }
}

main().catch((error) => {
  console.error(error);
  process.exit(1);
});
```

如果您使用 CDK `NodejsFunction`强迫多克捆绑 所以邮站台阶 在 Linux x64 类似 Lambda 的环境中运行, 包括下载的二进制 在部署文物中:

```ts
const myLambdaFunction = new lambda.NodejsFunction(this, 'MyLambdaFunction', {
  // ...
  runtime: l.Runtime.NODEJS_24_X,
  architecture: l.Architecture.X86_64,
  bundling: {
    forceDockerBundling: true,
    nodeModules: ['@chegger/node-obscura-aws-lambda'],
  },
});
```

## API 密码

### `getBinaryPath()`

返回已安装的 Lambda 特定 Obscura 二进制路径 .

### `startObscura(options?)`

开始 `obscura serve` 并解决当 CDP 端点准备好.

选项 :

-   `port?: number`
-   `host?: string`
-   `stealth?: boolean`
-   `startupTimeoutMs?: number`
-   `extraArgs?: string[]`

回返情况:

```ts
{
  endpoint: string;
  wsEndpoint: string;
  close: () => Promise<void>;
}
```

## 构建 Lambda 艺术

此回向为多克先. 您不需要为主机安装 Rust 建立流动.

```bash
npm run build:artifact
```

该剧本将:

1.  复制上游 `obscura` 来源
2.  在 Amazon Linux 2023 Docker 图像内构建它
3.  软件包 `obscura` 财务报告和审定财务报表 `obscura-worker` 改为: `dist/obscura-x86_64-linux-lambda.tar.gz`
4.  写入校验和并构建元数据

### 试一试已建成的文物

```bash
npm run smoke:test
```

运行 AWS Lambda 节点 24 基础图像中的已建二进制并等待 页:1 `/json/version` 上来.

## 环境变量

运行时间安装 :

-   `OBSCURA_AWS_LAMBDA_RELEASE_TAG` 将软件包释放标记覆盖到 下载。 默认 : `v${package.version}`
-   `OBSCURA_AWS_LAMBDA_DOWNLOAD_BASE_URL` 覆盖二进制下载基础 URL
-   `NODE_OBSCURA_AWS_LAMBDA_SKIP_DOWNLOAD=1` 跳过二进制下载 安装

构建脚本 :

-   `OBSCURA_UPSTREAM_REPO` 覆盖上游 Obscura git repo
-   `OBSCURA_UPSTREAM_TAG` 覆盖上游 Obscura 标记 。 默认 : `v${package.version}`
-   `OBSCURA_CARGO_FEATURES` 超过货运特性。 默认 : `stealth`
-   `OBSCURA_LAMBDA_DOCKER_TAG` 覆盖本地 Docker 构建器图像标签
-   `OBSCURA_LAMBDA_ARCHIVE` 覆盖烟雾测试所用的归档路径
-   `OBSCURA_LAMBDA_SMOKE_IMAGE` 覆盖 Lambda 基准图像 烟雾测试

## 释放

软件包版本和上游 Obscura 标签通过 `package.json`。 。 。 .

```bash
npm run version:set -- 0.1.9
git add package.json package-lock.json
git commit -m "Release 0.1.9 with upstream Obscura v0.1.9."
git push origin main
git tag v0.1.9
git push origin v0.1.9
```

然后CI构建了Lambda二进制,创建了"GitHub"发行版,并发布到npm.

## 许可证

麻省理工这个包装包。 它的下部仍然是Apache-2.0 上游项目.

## 常见问题

### @chegger/node-obscura-aws-lambda 是什么？

AWS Lambda特有节点\.js 运行时间包装为Obscura浏览器二进制\.

### 如何安装 @chegger/node-obscura-aws-lambda？

在项目目录运行 npm install @chegger/node-obscura-aws-lambda，或使用 pnpm add / yarn add / bun add。

### @chegger/node-obscura-aws-lambda 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @chegger/node-obscura-aws-lambda 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @chegger/node-obscura-aws-lambda 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @chegger/node-obscura-aws-lambda 可以商用吗？

@chegger/node-obscura-aws-lambda 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chegger/node-obscura-aws-lambda 的下载量有多少？

根据 npm 官方下载统计，@chegger/node-obscura-aws-lambda 在 2026/10/10 – 2026/11/08 这 30 天内被下载 1,948 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chegger/node-obscura-aws-lambda 还在维护吗？

最新版本 0\.2\.6 发布于 2026/11/05（4 天前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/05/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。