EAS Hosting 简介

EAS Hosting 支持你在应用配置中的 expo.web.output 里配置的全部三种输出模式：

• single：将你的 Expo 应用导出为单页应用，仅输出一个 index.html
• static：将你的 Expo 应用导出为 静态生成的 Web 应用
• server：支持 服务器函数 和 API 路由，以及静态页面

当使用 server 输出模式时，EAS Hosting 完全支持 API 路由（以 +api.ts 结尾的文件）。你可以在 EAS 仪表板 中监控 API 路由的崩溃、日志和请求。

EAS Hosting 基于 Cloudflare Workers 构建，它运行在 V8 JavaScript 引擎上。它使用 V8 isolate，而不是完整的 Node.js 进程。Node.js 兼容模块可用，但有一些限制。有关受支持模块的完整列表，请参阅 worker runtime reference。

付费套餐提供 自定义域名。每个项目都可以为生产部署分配一个自定义域名。支持顶级域名和子域名。

EAS Hosting 的部署是不可变的。每个部署都会获得一个唯一的预览 URL。你可以创建 别名，为部署分配自定义名称（例如 staging 或 production）。由于部署是不可变的，你可以通过使用 eas deploy:alias --prod --id=<deploymentId> 将别名重新分配给之前的部署 ID，立即回滚。

EAS Hosting 在 EAS 仪表板 中提供内置监控：

• 崩溃：查看来自 API 路由的未捕获错误，并按相似性分组
• 日志：来自 API 路由的所有 console.log、console.info 和 console.error 输出
• 请求：请求元数据，包括状态、浏览器、区域和持续时间

API 路由可以返回 Cache-Control 指令，EAS Hosting 会使用这些指令在其全球 CDN（内容分发网络）上缓存响应。静态资源默认的浏览器缓存时间为 3600 秒。有关详情，请参阅 Caching 参考文档。

EAS Hosting 使用 deploy 作业类型与 EAS Workflows 集成。你可以在工作流配置中添加一个部署作业。例如：

jobs:
  deploy_web:
    type: deploy
    environment: production
    params:
      prod: true

你也可以部署到特定别名，或者基于分支有条件地设置 production：

jobs:
  deploy:
    type: deploy
    params:
      prod: ${{ github.ref_name == 'main' }}

有关更多信息，请参阅 使用 EAS Workflows 进行 Web 部署。