Hexo 会把文章和主题生成静态文件,发布到阿里云时,常见做法是放进对象存储 OSS,或上传到云服务器 ECS 并由 Nginx 提供访问。OSS 适合以静态内容为主的个人博客,日常维护较少;ECS 配置空间更大,适合已有服务器,或还要运行其他服务的情况。
下面以“本地生成 Hexo 页面、OSS 托管、CDN 加速”为例说明部署流程,也会介绍 ECS 的基本做法。阿里云控制台和计费规则可能调整,具体配置以当前页面提示为准。使用境内节点提供网站服务时,还要按要求完成备案及相关接入手续。
部署前准备
- 本地 Hexo 项目:项目能正常运行,执行 hexo clean 和 hexo generate 后,可以生成 public 文件夹。
- 阿里云账号:用于创建 OSS Bucket;计划使用 CDN 时,还需要开通相应服务并配置域名。
- 网站域名:准备好要绑定的域名,并确认域名解析和网站接入所需手续。
- 部署工具:可以使用阿里云命令行工具、SDK,或支持 OSS 的同步工具。选择哪种工具不影响整体流程,但要确认它的上传和删除规则。
先在本地检查文章、主题和链接,再开始配置云端。这样遇到问题时,可以分别判断是 Hexo 构建、文件上传,还是域名和缓存设置出了差错。
方案一:使用 OSS 托管 Hexo 网站
检查 Hexo 站点配置
打开项目中的 _config.yml,核对 url 和 root。使用独立域名时,url 应填写最终访问地址,例如 https://blog.example.com。如果网站直接部署在域名根目录,root 通常设置为 /;如果博客放在子路径下,就要按实际路径填写,并确认主题生成的 CSS、图片等资源链接也使用了正确路径。
保存配置后执行:
hexo clean
hexo generate
查看 public,确认里面有首页、文章页面、样式、脚本和图片。若本地预览时首页正常,文章链接却打不开,先检查永久链接和主题配置,不要急着上传文件。
创建 Bucket 并设置静态网站
在阿里云 OSS 控制台创建 Bucket。选择地域时,可以结合目标用户和后续 CDN 规划考虑。权限按实际需要设置,避免为了省事开放不必要的写入权限。若使用 OSS 静态网站托管功能,在静态页面设置中指定默认首页,通常是 index.html,并按需要配置错误页面。
静态网站托管与直接使用 Bucket 访问域名不是同一项配置。绑定自定义域名时,要按照阿里云当前支持的接入方式操作;还要使用 HTTPS 或 CDN 的话,需要同时确认域名验证、证书和回源地址。只在 DNS 中添加一条指向 Bucket 的记录,并不能保证所有访问方式都已经配置好。
上传 public 目录中的文件
上传的是 public 目录里的文件内容,应让 index.html 等网站文件位于 Bucket 对应的站点根目录。不要把整个 Hexo 项目上传上去:源文章、主题配置和依赖目录不是网页运行所需,还会增加存储负担,并可能暴露不该公开的配置。
第一次部署可以手动上传,确认目录结构无误后再使用同步工具更新。设置工具时,仔细检查本地路径和远端路径,避免文件被放进 public/public 这样的多余目录。开启删除同步前,先确认它会删除哪些云端文件,以免一次误操作清空站点。AccessKey 也不要明文写进公开仓库,应使用安全的凭据管理方式,并限制密钥权限。
绑定域名并配置 HTTPS
使用 CDN 时,先在控制台添加加速域名,配置 OSS 回源并完成归属验证,再根据页面提示到域名服务商处添加解析记录。记录类型和目标地址会因接入方式而异,照控制台提供的配置填写。随后为域名配置 SSL 证书,检查 HTTPS 是否能正常访问,并按需设置 HTTP 跳转到 HTTPS。
上线后不要只看首页。还要打开文章详情页、图片、归档或搜索页面,并检查浏览器控制台是否有资源请求失败。如果页面能打开但样式或图片缺失,先核对 root、上传目录层级和主题资源路径;刚更新过文件的,也要留意 CDN 是否还在返回旧缓存。
方案二:部署到阿里云 ECS
已有 ECS 的用户,可以把 public 上传到服务器,再通过 Nginx 配置静态站点。通常需要安装 Nginx、创建站点目录、上传生成文件,并将 Nginx 的站点根目录指向该目录,同时设置默认首页为 index.html。之后配置域名解析和 HTTPS,并在安全组中放行网站实际使用的端口。
ECS 可以与其他应用共用,配置也更灵活,但系统更新、防火墙、Web 服务、备份和故障恢复都需要自行维护。只为发布静态博客时,通常没有必要多承担这些工作;如果使用 ECS,不要把管理端口、数据库或不需要的服务直接暴露到公网。
个人博客的一次更新流程
假设小林把 Hexo 博客放在 OSS,域名是 blog.example.com,并通过 CDN 提供访问。发布新文章时,他先在本地执行 hexo clean 和 hexo generate,预览页面排版,再把 public 中的文件同步到 Bucket。上传完成后,他检查首页、新文章链接、图片和 HTTPS 状态;确认文件正常,再按需要刷新 CDN 缓存。
有一次更新后,新文章能打开,首页却还是旧内容。文件已经上传到 OSS,问题出在 CDN 缓存。刷新对应内容后,页面恢复正常。遇到类似情况,可以分开检查本地生成结果、OSS 文件、域名解析和 CDN 缓存,不必一开始就重新构建整个网站。
常见问题与上线检查
- 访问 404:确认 Bucket 根目录是否直接包含 index.html,并检查静态网站首页设置和回源路径。
- CSS 或图片无法加载:核对 url、root、主题资源路径和上传目录层级;如果刚改过 CDN 配置,也要检查缓存。
- HTTPS 证书报错:确认证书覆盖当前访问的域名,并检查 CDN 或源站的证书配置是否生效。
- 本地正常、线上异常:确认上传的是最新生成的 public 内容,再检查 CDN 是否仍缓存旧文件。
上线前检查域名解析、备案要求、HTTPS、首页和文章链接、图片资源,以及文件备份方式。Hexo部署到阿里云需要本地生成、云端托管、域名接入和缓存更新彼此配合。对静态个人博客来说,先用 OSS 建立简单的发布流程,通常比长期维护一台服务器省事;已有 ECS 或需要运行其他服务时,再考虑服务器方案。