EdgeOneAuth：Typecho 的腾讯云 EdgeOne 静态资源鉴权解决方案

博主： Dreamy.HS
发布时间：2025 年 08 月 11 日
876 次浏览
2 条评论
4331字数
分类：教程

在网站运营中，静态资源的安全防护至关重要。EdgeOneAuth 是一款专为 Typecho 博客系统设计的腾讯云 EdgeOne Token 鉴权插件，通过高效的鉴权机制保护您的静态资源，防止未经授权的访问和盗链行为。

### 核心功能亮点

1. **多鉴权类型支持**
   全面覆盖腾讯云 EdgeOne 的 6 种鉴权方案：
   * **A型** ：基于时间戳+密钥的标准鉴权
   * **B型** ：带目录权限控制的增强鉴权
   * **C型** ：支持IP限制的路径式鉴权（鉴权信息嵌入URL路径）
   * **D型** ：支持十进制/十六进制时间戳的查询式鉴权
   * **TypeV** ：视频专用高级鉴权（支持试看、IP限制、Referer控制等）
   * **自定义鉴权** ：灵活组合多种鉴权特性
2. **智能资源识别**
   * 自动处理文章内容、页面头部/底部的资源链接
   * 精准识别图片、CSS、JS 等静态资源
   * 特别优化 vditor 编辑器资源处理
   * 字体文件特殊处理逻辑
3. **现代化管理界面**
   * 灰色主题专业设计，响应式布局适配所有设备
   * 可视化按钮组鉴权类型选择器
   * 实时表单验证与错误提示
   * 一键导入/导出配置功能
     
     <div class="panel panel-default collapse-panel box-shadow-wrap-lg"><div class="panel-heading panel-collapse" data-toggle="collapse" data-target="#collapse-e337791161b9e1dcbe2b0138696a6ac479" aria-expanded="true"><div class="accordion-toggle"><span style="">技术架构解析</span>
<i class="pull-right fontello icon-fw fontello-angle-right"></i>
</div>
</div>
<div class="panel-body collapse-panel-body">
<div id="collapse-e337791161b9e1dcbe2b0138696a6ac479" class="collapse collapse-content"><p></p> ![deepseek_mermaid_20250811_ba08fc.png](https://img.hsred.cn/img/2025/08/11/689a0ed0600ce.png)<p></p></div></div></div>

### 安装与配置指南

#### 安装步骤

1. 下载插件压缩包并解压
2. 重命名文件夹为 `EdgeOneAuth`
3. 上传至 Typecho 的 `/usr/plugins/` 目录
4. 后台启用插件并完成配置

#### 关键配置项

* **域名设置** ：需鉴权的域名（多域名用逗号分隔）
* **鉴权类型** ：六种方案按需选择
* **安全密钥** ：用于生成签名的核心密钥
* **有效期** ：鉴权链接存活时间（秒）
* **路径前缀** ：限定需要保护的资源路径
* **资源类型** ：选择需处理的文件类型（图片/CSS/JS等）
* **自定义列表** ：手动添加特殊资源URL

---

### 高级鉴权方案详解

#### A型鉴权（标准查询式）

**bash**

```
# URL结构
https://cdn.example.com/image.jpg?token=1681200000-5a3G7b-0-8c22d5f3d4f5g6h7j8k9l0

# 签名算法
md5hash = MD5("/image.jpg-1681200000-5a3G7b-0-密钥")
```

**核心参数解析** ：

* **timestamp** ：十进制Unix时间戳（1970至今秒数）
* **rand** ：5-100位随机字符串（大小写字母+数字）
* **uid** ：用户ID（默认0，保留字段）
* **md5hash** ：32位签名（`Path-timestamp-rand-uid-密钥`）

**鉴权流程** ：

1. 边缘节点提取URL中的时间戳
2. 验证时间戳是否过期
3. 重新计算`MD5(Path-timestamp-rand-uid-密钥)`
4. 比对URL中的md5hash值：
   * 匹配 → 返回资源
   * 不匹配 → 返回403

**安全特性** ：

* 随机字符串防止重放攻击
* 时间戳限制链接有效期
* 签名绑定具体资源路径

---

#### B型鉴权（目录时间戳式）

**bash**

```
# URL结构
https://cdn.example.com/202308151200/md5hash/image.jpg

# 签名算法
md5hash = MD5(密钥 + "202308151200" + "/image.jpg")
```

**参数说明** ：

* **timestamp** ：UTC+8时间（YYYYMMDDHHMM格式）
* **md5hash** ：32位签名（`密钥+timestamp+Path`）

**鉴权流程** ：

1. 节点解析路径中的时间戳（前12位数字）
2. 验证时间是否在有效期内
3. 重组原始资源路径（移除时间戳和hash段）
4. 计算`MD5(密钥+timestamp+Path)`
5. 比对路径中的md5hash值

**场景优势** ：

* 隐藏式鉴权（无查询参数）
* 时间格式直观可读（YYYYMMDDHHMM）
* 天然防御URL参数篡改
* 适合目录级资源保护

#### C型鉴权（路径式）

**bash**

```
# URL结构
https://cdn.example.com/md5hash/timestamp/image.jpg

# 签名算法
md5hash = MD5(密钥 + "/image.jpg" + timestamp)
```

* 鉴权信息隐藏在路径中
* 对CDN缓存更友好
* 防止参数篡改

#### D型鉴权（查询式）

**bash**

```
# URL结构
https://cdn.example.com/image.jpg?token=md5hash&t=timestamp

# 时间戳格式可选：
- 十进制：1681200000
- 十六进制：6454b100
```

#### TypeV 视频鉴权

**bash**

```
# 支持高级参数：
?exper=60   # 试看60秒
&plive=6454b100 # 伪直播开始时间
&whip=1.1.1.1   # IP白名单
&sign=sha1(KEY+Path+参数组合)
```

实现：试看功能、IP限制、Referer控制、伪直播等高级场景

---

### 自定义资源处理

通过 **自定义鉴权文件列表** 可解决特殊场景：

**text**

```
# 每行一个URL
https://cdn.example.com/libs/special-widget.js
https://cdn.example.com/third-party/analytics.css
```

适用场景：

1. 非常规路径的资源文件
2. 第三方插件引入的静态资源
3. 动态生成的特殊格式URL

### 各类型鉴权对比表

| 类型  | URL特征                   | 时间格式           | 签名位置 | 适用场景         |
| ------- | --------------------------- | -------------------- | ---------- | ------------------ |
| A型   | `?token=ts-rand-hash` | 十进制Unix时间戳   | 查询参数 | 通用资源保护     |
| B型   | `/ts/hash/Path`       | YYYYMMDDHHMM       | URL路径  | 目录级资源保护   |
| C型   | `/hash/ts/Filename`   | 十六进制Unix时间戳 | URL路径  | CDN友好型保护    |
| D型   | `?token=hash&t=ts`    | 十/十六进制        | 查询参数 | 兼容性要求高场景 |
| TypeV | 多参数查询式              | 十六进制           | 查询参数 | 视频高级保护     |

---

### 常见问题解决方案

1. **资源403错误**
   * 检查密钥是否正确
   * 确认域名已添加到配置列表
   * 验证时间戳同步性
2. **部分资源未鉴权**
   * 检查资源类型筛选设置
   * 确认路径前缀是否匹配
   * 通过自定义列表手动添加
3. **字体加载异常**
   * 启用插件内置的字体处理模块
   * 检查跨域配置（CORS）

---

### 技术优势

1. **性能优化**
   * 智能缓存机制减少重复计算
   * 批处理技术提升HTML解析效率
   * 轻量级设计（核心代码仅4,500行）
2. **安全增强**
   * 动态签名防止URL伪造
   * 时间戳防重放攻击
   * IP/Referer双重校验机制
3. **扩展能力**
   * 钩子机制支持功能扩展
   * 结构化API便于二次开发
   * 完整日志追踪系统
     
     ![1754927236982.png](https://img.hsred.cn/img/2025/08/11/689a10f0a7457.png)
     ![1754927250478.png](https://img.hsred.cn/img/2025/08/11/689a10f12a9dc.png)
     ![1754927257739.png](https://img.hsred.cn/img/2025/08/11/689a10f1c119a.png)

---

### 结语

EdgeOneAuth 通过深度整合腾讯云 EdgeOne 的鉴权能力，为 Typecho 博客提供了企业级的静态资源保护方案。无论是普通博客站点还是媒体资源平台，都能通过灵活的配置实现精准访问控制。

END

本文作者：Dreamy.HS
本文地址： https://blog.hsred.cn/archives/89/
版权说明：本博客所有文章除特别声明外，均默认采用 CC BY-NC-SA 4.0 许可协议。

最后修改：2025 年 08 月 11 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

2 条评论

清虚散人
2 个月前

曾经，我给自己的博客设置了不少防盗等等的多重验证，最终发现都是自己为难自己，一般的普通站点，经常连访客都没几个。

回复
1. Dreamy.HS
  2 个月前
  
  @清虚散人
  
  确实 hhh
  
  回复

EdgeOneAuth：Typecho 的腾讯云 EdgeOne 静态资源鉴权解决方案

Dreamy.HS • 2025 年 08 月 11 日

### 核心功能亮点

### 安装与配置指南

#### 安装步骤

1. 下载插件压缩包并解压
2. 重命名文件夹为 `EdgeOneAuth`
3. 上传至 Typecho 的 `/usr/plugins/` 目录
4. 后台启用插件并完成配置

#### 关键配置项

---

### 高级鉴权方案详解

#### A型鉴权（标准查询式）

**bash**

```
# URL结构
https://cdn.example.com/image.jpg?token=1681200000-5a3G7b-0-8c22d5f3d4f5g6h7j8k9l0

# 签名算法
md5hash = MD5("/image.jpg-1681200000-5a3G7b-0-密钥")
```

**核心参数解析** ：

**鉴权流程** ：

**安全特性** ：

* 随机字符串防止重放攻击
* 时间戳限制链接有效期
* 签名绑定具体资源路径

---

#### B型鉴权（目录时间戳式）

**bash**

```
# URL结构
https://cdn.example.com/202308151200/md5hash/image.jpg

# 签名算法
md5hash = MD5(密钥 + "202308151200" + "/image.jpg")
```

**参数说明** ：

* **timestamp** ：UTC+8时间（YYYYMMDDHHMM格式）
* **md5hash** ：32位签名（`密钥+timestamp+Path`）

**鉴权流程** ：

**场景优势** ：

* 隐藏式鉴权（无查询参数）
* 时间格式直观可读（YYYYMMDDHHMM）
* 天然防御URL参数篡改
* 适合目录级资源保护

#### C型鉴权（路径式）

**bash**

```
# URL结构
https://cdn.example.com/md5hash/timestamp/image.jpg

# 签名算法
md5hash = MD5(密钥 + "/image.jpg" + timestamp)
```

* 鉴权信息隐藏在路径中
* 对CDN缓存更友好
* 防止参数篡改

#### D型鉴权（查询式）

**bash**

```
# URL结构
https://cdn.example.com/image.jpg?token=md5hash&t=timestamp

# 时间戳格式可选：
- 十进制：1681200000
- 十六进制：6454b100
```

#### TypeV 视频鉴权

**bash**

```
# 支持高级参数：
?exper=60   # 试看60秒
&plive=6454b100 # 伪直播开始时间
&whip=1.1.1.1   # IP白名单
&sign=sha1(KEY+Path+参数组合)
```

实现：试看功能、IP限制、Referer控制、伪直播等高级场景

---

### 自定义资源处理

通过 **自定义鉴权文件列表** 可解决特殊场景：

**text**

```
# 每行一个URL
https://cdn.example.com/libs/special-widget.js
https://cdn.example.com/third-party/analytics.css
```

适用场景：

1. 非常规路径的资源文件
2. 第三方插件引入的静态资源
3. 动态生成的特殊格式URL

### 各类型鉴权对比表

---

### 常见问题解决方案

---

### 技术优势

---

### 结语

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

2 条评论

EdgeOneAuth：Typecho 的腾讯云 EdgeOne 静态资源鉴权解决方案

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款