novalon-website/docs/CDN_QUICK_START.md

CDN快速配置指南

5分钟快速配置CDN

本指南帮助您快速为novalon.cn配置CDN加速。

前置准备

• ✅ 腾讯云账号
• ✅ 已备案域名: novalon.cn
• ✅ 腾讯云API密钥 (SecretId和SecretKey)

快速配置步骤

1️⃣ 创建COS存储桶 (2分钟)

# 登录腾讯云控制台
open https://console.cloud.tencent.com/cos

# 创建存储桶
名称: novalon-cdn-[您的APPID]
地域: 成都 (ap-chengdu)
访问权限: 公有读、私有写

2️⃣ 配置CDN加速域名 (2分钟)

# 进入CDN控制台
open https://console.cloud.tencent.com/cdn

# 添加域名
加速域名: cdn.novalon.cn
业务类型: CDN网页小文件
源站地址: novalon-cdn-[APPID].cos.ap-chengdu.myqcloud.com
回源协议: HTTPS

3️⃣ 配置DNS解析 (1分钟)

# 在新网DNS管理后台添加CNAME记录
记录类型: CNAME
主机记录: cdn
记录值: cdn.novalon.cn.cdn.dnsv1.com

4️⃣ 上传静态资源 (1分钟)

# 配置环境变量
export CDN_DOMAIN=https://cdn.novalon.cn
export COS_SECRET_ID=您的SecretId
export COS_SECRET_KEY=您的SecretKey
export COS_BUCKET=novalon-cdn-[APPID]
export COS_REGION=ap-chengdu

# 运行部署脚本
npm run deploy:cdn

验证配置

# 检查CDN域名解析
nslookup cdn.novalon.cn

# 测试静态资源访问
curl -I https://cdn.novalon.cn/_next/static/chunks/main.js

# 预期响应
HTTP/2 200
server: tencent-cdn
x-cache-lookup: Cache Hit
cache-control: public, max-age=31536000, immutable

常见问题

Q: CDN域名无法访问?

• 检查DNS解析是否生效
• 确认CDN域名审核通过
• 验证COS存储桶权限

Q: 静态资源404?

• 确认已运行npm run deploy:cdn
• 检查COS存储桶中是否存在文件
• 验证文件路径是否正确

Q: 如何回滚?

• 移除next.config.ts中的assetPrefix配置
• 重新构建并部署应用

下一步

• 📖 查看详细配置文档: CDN_CONFIGURATION.md
• 🔧 配置HTTPS证书
• 📊 设置监控告警
• 🚀 优化缓存策略

技术支持

如遇问题，请联系:

• 邮箱: ops@novalon.cn
• 文档: 项目文档