只留真正会用到的部分。
POST 原始字节流,服务端做文件名清洗、扩展名白名单与 MIME 校验,防路径穿越。
HMAC-SHA256 签名地址,可设置有效期;到期自动失效,服务端不存 token。
完整支持分片请求与后缀 Range(bytes=-N),拖拽播放、断点续传开箱即用。
.env 里的 MEDIA_API_KEY 就是唯一凭证,上传时放在 x-api-key 请求头,恒定时间比对。
Referer / Origin 全局白名单,支持 *.example.com 通配,后台可直接改。
文件落在本地 public 盘;Filament 后台可查看、编辑、删除媒体与调整设置。
密钥与白名单都写在服务器 .env,不需要注册、不需要申请 Key。
① 上传文件(带上 Referer)
# 密钥 = .env 里的 MEDIA_API_KEY curl -X POST \ -H "x-api-key: <YOUR_KEY>" \ -H "Referer: https://aliyun.asula.top/" \ -H "Content-Type: audio/mpeg" \ --data-binary @demo.mp3 \ "https://aliyun.asula.top/v1/upload?name=demo.mp3"
② 响应直接给出播放地址
{
"ok": true,
"id": 7,
"direct_url": "https://aliyun.asula.top/play/...",
"proxy_url": "https://aliyun.asula.top/stream/...",
"expires_at": 1794732030
}
③ 嵌入播放器,或按需取 Range
<video src="https://aliyun.asula.top/stream/<token>" controls></video> # 代理流支持分片,适合拖拽与续传 curl -H "Range: bytes=-500" -i "https://aliyun.asula.top/stream/<token>"
管理接口用 x-admin-token 或后台登录会话;播放地址自带签名,无需密钥。
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
| POST | /v1/upload | x-api-key + Referer | 上传音视频,返回直链与代理流地址 |
| GET | /v1/media/{id}/url | x-api-key + Referer | 为已有媒体重新签发播放地址 |
| GET | /v1/media | x-admin-token | 媒体库列表 |
| DELETE | /v1/media/{id} | x-admin-token | 删除记录与磁盘文件 |
| GET | /play/{token} | 签名 token | 302 跳转到静态直链 |
| GET | /stream/{token} | 签名 token | 代理流,支持 Range / 206 |
| GET | /healthz | 公开 | 健康检查(DB / Redis) |