# CDN快速配置指南

## 5分钟快速配置CDN

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

### 前置准备

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

### 快速配置步骤

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

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

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

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

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

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

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

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

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

```bash
# 配置环境变量
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
```

### 验证配置

```bash
# 检查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](./CDN_CONFIGURATION.md)
- 🔧 配置HTTPS证书
- 📊 设置监控告警
- 🚀 优化缓存策略

### 技术支持

如遇问题，请联系:
- 邮箱: ops@novalon.cn
- 文档: [项目文档](../README.md)