安装包加速

适用范围与前置条件

• 安装包加速是模板级能力，既可以在创建模板时开启，也可以对已就绪的存量模板执行一键开启。

• 一键开启会创建一个新的派生模板，不会修改原模板，也不会影响已经创建的实例。

• 当前只在部分地域开放。如果控制台没有显示安装包加速开关或一键入口，说明当前地域未开放。

• 只会处理平台配置的下载域名白名单中的 GET 请求。

• 不支持通配符域名；不在白名单内的域名会正常直连，不会被加速。

• 动态接口、登录请求、非 GET 请求，以及未进入白名单的域名不会通过 P2P 代理处理。

工作原理与加速效果

开启安装包加速后，您无需修改安装命令、手动配置代理、导入证书或修改域名解析。系统会自动处理符合条件的下载请求。

• 相同依赖包在集群内已有缓存时，可以从缓存或 P2P 节点获取，减少重复回源。

• 多个实例同时下载相同依赖包时，可以共享已下载的数据块。

• 第一次下载、冷缓存或没有可用节点时，仍可能需要从原始源站下载。

• 加速效果受源站限速、网络质量、依赖包大小和缓存命中情况影响。

支持加速的下载源

默认支持加速的下载源涵盖以下常见类型：

开启安装包加速

安装包加速可以在创建模板时开启，也可以对已有模板一键开启。从已开启的模板创建的实例会自动继承加速能力。

继承规则

安装包加速是模板级能力，其继承行为如下：

• 模板开启后，从该模板创建的实例自动开启。

• 从已开启的模板衍生出的新模板会继续继承该能力。

• 当前不支持在衍生模板中关闭该能力。即使传入 enablePackageAccelerate: false，已继承的能力也不会被移除。

• 如果需要未开启加速的模板，请从原始镜像或未开启加速的源重新创建。

不同创建路径的行为如下：

对于较旧或不兼容的存量模板，系统会自动降级：构建流程继续执行，不会因为加速组件缺失或版本不兼容而失败，但生成的模板可能不会获得安装包加速能力。

API 与 E2B 兼容

安装包加速支持以下开启方式：

• Dashboard API 请求体：enablePackageAccelerate

• SDK / 扩展 Header：X-EAS-Enable-Package-Accelerate

• Dashboard runtime env：ENABLE_PACKAGE_ACCELERATE

• E2B ENV step：ENABLE_PACKAGE_ACCELERATE

开关解析优先级如下（从高到低）：

1. 地域开关

2. 已继承开启

3. 请求体 enablePackageAccelerate

4. X-EAS-Enable-Package-Accelerate Header

5. Dashboard runtime env

6. 第一个 E2B ENV step

7. false（默认值）

• 只读取第一个 ENV step，后续同名 ENV 不生效。

• 开关值统一使用 true/false。

确认加速已生效

curl -sS "https://<sandbox-api-host>/templates/<templateID>" \
  -H "X-API-KEY: <group-token>"

{
  "templateID": "my-template",
  "features": ["packageAcceleration"]
}

使用注意事项

• 不要手动设置 http_proxy、https_proxy、CA 证书或 /etc/hosts，系统会在开启能力后自动处理。

• 安装包加速只影响依赖包下载，不改变业务代码执行逻辑。

• 如果包管理器使用了私有源、代理源或未配置的镜像域名，这些下载不会进入加速范围。

• 首次下载可能没有明显加速；重复下载或并发下载相同依赖时更容易看到收益。

• 从已开启加速的模板创建的实例会自动继承能力，当前不支持在衍生模板中关闭。

常见问题