# General Translation Platform: 虚拟机镜像
URL: https://generaltranslation.com/zh/docs/platform/locadex/reference/vm-image.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 审校自动化可用的运行时、命令行工具和限制。Locadex 虚拟机镜像参考。

Locadex 运行每个自动化所用的沙箱环境会安装依赖项、运行已配置的命令、更新文件，并准备拉取请求中的更改。

## Runtime [#runtime]

每个沙箱提供程序均运行 Node.js 24，并包含：

* Node.js 24 和 npm。
* Bun 1.3.9。
* Python 3 和 `pip`。

Locadex 在安装项目依赖项时，会使用为自动化选择的软件包管理器。

底层 Linux 镜像因沙箱提供程序而异。请勿依赖于每次运行时都可使用 `apt`、`dnf` 或其他操作系统软件包管理器。

## 环境变量 [#environment-variables]

在 `/org/{orgId}/locadex/secrets` 配置的环境变量会在自动化运行时注入沙箱。请将 `{orgId}` 替换为你的 Organization ID；Secrets 页面当前尚未显示在仪表板侧边栏中。

可用于 API 密钥、token 或命令配置。 (有关访问要求和设置，请参阅[添加环境变量](/docs/platform/locadex/guides/adding-environment-variables)。)

## 命令行工具 [#tools]

每个沙箱均包含：

* `git`
* `wget`
* `curl`
* `tar`
* `unzip`
* Python 3 和 `pip`
* `ripgrep`
* `jq`
* `ca-certificates`
* 用于原生包的 C/C++ 构建工具链

每个 provider 还会全局安装 `biome`、`eslint` 和 `ultracite`。Locadex 无需将这些工具添加到 package 清单或 lockfile 中，即可运行这些 preset 检查。命令调用 `tsc` 时，请使用项目的 TypeScript 依赖项。

## 项目命令 [#commands]

预处理和后处理命令从仓库根目录执行。对于 monorepo，请配置自动化的 **目标目录**，并确保命令指向正确的应用。

项目依赖项不会预装在虚拟机镜像中。当所选软件包管理器无法自动安装项目所需的全部依赖项时，请添加安装或设置命令。 (请参阅[配置 Locadex 自动化](/docs/platform/locadex/guides/configuring-automations#configure-automation)) 。

## 限制 [#limitations]

沙箱环境不包含：

* 浏览器运行时环境。如果端到端测试或构建需要浏览器，请在命令中安装所需的浏览器。
* Docker-in-Docker。命令无法启动同级容器，也无法在沙箱内运行 Docker 守护进程。
* 除所列 preset 外的项目专用全局工具。请通过项目或预处理命令安装这些工具。

请确保命令为非交互式且仅依赖 repository 内的资源，以便同一自动化能在干净的沙箱中运行。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
