张翔
107 lines
2.2 KiB
Markdown
107 lines
2.2 KiB
Markdown
# 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)
|