单人使用 · Laravel 13 · Filament 5 · Redis

把音视频文件,
变成可嵌入的播放地址

一个人用的媒体地址服务:上传、拿地址、播放,就这三步。一把密钥、一份域名白名单,没有多余的账户与租户体系。

正在检测服务状态…

保留下来的能力

只留真正会用到的部分。

⬆

二进制上传

POST 原始字节流,服务端做文件名清洗、扩展名白名单与 MIME 校验,防路径穿越。

🔗

302 播放直链

HMAC-SHA256 签名地址,可设置有效期;到期自动失效,服务端不存 token。

🎬

Range / 206 代理流

完整支持分片请求与后缀 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/uploadx-api-key + Referer上传音视频,返回直链与代理流地址
GET/v1/media/{id}/urlx-api-key + Referer为已有媒体重新签发播放地址
GET/v1/mediax-admin-token媒体库列表
DELETE/v1/media/{id}x-admin-token删除记录与磁盘文件
GET/play/{token}签名 token302 跳转到静态直链
GET/stream/{token}签名 token代理流,支持 Range / 206
GET/healthz公开健康检查(DB / Redis)