一、方案选型：EdgeOne Pages 的技术优势
在规划海外官网时，技术团队常在传统云服务器（CVM / 轻量应用服务器）与静态站点托管之间权衡。 EdgeOne Pages 采用 Serverless（免服务器）架构，相比传统模式具有以下特点：
- 免运维：无需购买底层服务器实例，省去了操作系统维护与 Web 服务器（如 Nginx）的配置工作。
- 边缘加速：静态资源自动分发至 EdgeOne 全球边缘节点，海外用户就近获取内容，降低首屏加载延迟。
- 集成 CI/CD：与代码仓库深度绑定，推送代码即可自动触发构建与发布，简化开发流程；也支持本地打包 ZIP 包手动上传部署。
- 自带 HTTPS 证书、WAF 基础防护，无需额外配置 CDN。
适用边界：适合 Vue、React、Hugo、Hexo、Next.js (静态导出) 纯静态官网、产品文档；不支持 SSR、PHP 等需要后端运行时的业务。
二、前置准备：账号与代码环境
1. 准备代码仓库
EdgeOne Pages 支持拉取 GitHub、GitLab 源码。请提前在对应平台创建仓库，并将基于 React、Vue、Hugo 或 Hexo 等框架编写的官网源码推送到主分支（如 main）。
Next.js 特别提醒：必须开启静态导出，构建命令输出out目录；原生 SSR 服务端渲染模式不兼容 EdgeOne Pages。
2. 账号开通与权限
部署前需拥有已激活的腾讯云国际版账号。针对海外主体注册或支付限制等常见问题，可联系合作伙伴 翼龙云协助梳理开户准备事项，并咨询港币 / 美金对公转账等支付充值方案。账号就绪后，登录腾讯云国际控制台操作。
3. 配额提醒
项目单存储上限 5GB，单文件、总文件数存在上限，大型静态站点提前评估资源限制。
三、核心实操：EdgeOne Pages 部署流程
创建项目并授权仓库、选择加速区域 登录腾讯云国际版控制台，进入 EdgeOne（边缘安全加速平台）页面，选择左侧菜单中的 “Pages”。点击 “新建项目”。
- 加速区域选择：出海纯海外访问 → 全球可用区（不含中国大陆）（无需备案）；需要国内可访问 → 全球可用区（含中国大陆，域名需 ICP 备案）。 通过 OAuth 授权连接你的 GitHub/GitLab 账号，并选中对应的仓库分支。
配置构建环境 根据项目框架设置构建命令（Build Command）和输出目录（Output Directory）。配置错误会导致访问 404 或构建失败。
| 前端框架 / 生成器 | 构建命令 (Build Command) | 输出目录 (Output Directory) | 备注 |
| React | npm run build | build | |
| Vue (Vite) | npm run build | dist | |
| Next.js（静态导出） | npx next build | out | 必须开启 next.config 静态导出，SSR 不支持 |
| Hugo | hugo | public | |
| Hexo | hexo generate | public |
补充配置：
- Node 版本：如项目需要特定 Node 版本，在项目设置调整构建运行时 Node 版本。
- 环境变量：前端需要的环境变量，在「环境管理」填入，构建阶段注入。
注：若项目包含自定义脚本，请以 package.json 中定义的路径为准。
触发自动化构建 确认配置后点击 “部署”。EdgeOne Pages 会自动分配容器拉取代码并执行构建。你可以在控制台实时查看部署日志。 构建完成后，系统会生成一个 *.edgeone.app 格式的预览域名。
注意：「全球可用区（不含中国大陆）」模式，预览域名国内访问 401 拒绝，仅海外可访问，预览链接具备有效期，正式业务务必绑定自定义域名。
SPA 单页应用必配（history 路由） React/ViteVue 使用 history 模式路由，子页面刷新会返回 404。 进入项目设置 – 规则 / 重写配置，添加回退规则： 对非静态资源的 HTML 导航请求重定向返回/index.html，把路由交给前端 JS 处理。
版本回滚：构建出错，可在部署历史选择旧版本一键回滚。
四、进阶配置：域名与安全
正式上线的官网需绑定自定义域名并启用 HTTPS。
- 绑定自定义域名在项目管理面板选择 “域名管理”，添加你的品牌域名（如 yourbrand.com）。 流程： ①填入域名；②添加 TXT 记录完成域名归属权验证；③添加 CNAME 记录指向 EdgeOne 分配地址；④等待 DNS 全球生效（数分钟48 小时）。
避坑：
- Cloudflare DNS 托管的根域名 com裸域名不支持 CNAME 接入，改用www子域名。
- 提示 “域名已存在其他腾讯云加速产品”，需要在 CDN / 旧 EdgeOne 删除该域名再重试。
- 存在 CAA 解析记录会造成 SSL 证书申请超时，临时调整 CAA 记录后重试。
- SSL 证书配置 DNS 解析生效、域名归属权验证通过后，EdgeOne Pages 会自动为绑定的域名申请并续期免费 SSL 证书。在控制台确认 HTTPS 状态为 “已开启”，即可实现全站加密访问。
- 可选：配置自定义 404 页面、缓存策略。
五、常见问题 FAQ
Q：EdgeOne Pages 适合部署哪些网站？ A：仅适合纯静态站点，跨境品牌官网、产品文档、博客；不支持 PHP、Next.jsSSR 等服务端渲染动态业务。Next.js 务必开启静态导出。
Q：网站海外访问正常，中国大陆打开返回 401？ A：项目加速区域选择了全球可用区（不含中国大陆），该设计专为出海，国内网络直接拒绝访问；如果需要国内访问，切换加速区域，并且域名完成 ICP 备案。
Q：Vue/React 网站跳转正常，刷新子页面出现 404？ A：SPA history 路由缺少回退重写规则；配置重写，不存在静态文件的导航请求返回/index.html，由前端接管路由。
Q：添加自定义域名，证书部署超时？ A：检查域名 CAA 解析记录，部分 CAA 策略阻止第三方申请证书，临时调整后等待证书签发完成。
Q：提示域名已经在其他平台存在？ A：该域名已经绑定在腾讯云 CDN 或者另一个 EdgeOne 站点，需要先删除旧绑定。
Q：构建失败，提示存储超限？ A：项目总存储上限 5GB，文件总数上限 2 万，清理旧部署版本，或者精简打包产物后重新部署。
Q：不想授权 Git 仓库，能否直接上传网站代码？ A：支持，创建项目选择手动上传模式，上传本地打包完成的 ZIP 静态包。
Q：部署之后出错，如何恢复旧版本？ A：进入部署历史，选择历史成功部署记录，执行回滚。
