拇指云文件 · 对接指引

DO + PostgreSQL

IIS

去重存储

访问日志

一、系统架构

• file.muzhiyun.com：平台主站。承载对接指引、三个上传接口（Up.do / Up_mp.do / Up_PDF.do）与完整文档。
• f.muzhiyun.com：预览分发站。提供历史那种"加密长串"预览地址，兼容旧链接；新上传的预览 URL 也指向它。
• 两域名绑同一文件夹，预览 URL 形态保持不变，旧分享链接依旧可用。

二、上传方法

三个接口共用同一套鉴权：请求头 X-XSRF-TOKEN: Bearer <token>。令牌为三段式伪 JWT：签名 = md5(header + <签名盐> + payload)，业务校验 = md5(sid + uid + exp + <业务盐>)，并校验过期时间 exp。签名盐与业务盐为服务端私密配置，由平台与业务系统线下约定，不在本公开文档中披露。

1) 图片（base64）— Up.do

POST https://file.muzhiyun.com/Up.do
Header: X-XSRF-TOKEN: Bearer <token>
Form:  img  = data:image/jpeg;base64,/9j/4AAQ...  (含 data URI 前缀)
        name = example.jpg

返回：
{
  "ok":       1,
  "msg":      "d1{sid}d{uid}{md5}.{ext}",   // 短串（建议存储，与参考服务器一致）
  "key":      "d1{sid}d{uid}{md5}.{ext}",   // 同 msg
  "file":     "{md5}.{ext}",                // 纯物理文件名（磁盘上的文件名）
  "file_key": "<完整加密长串>",              // = url 去掉域名部分
  "url":      "https://f.muzhiyun.com/<完整加密长串>",
  "dup":      0                             // 1=命中已存在文件，未重复落盘
}

2) 图片（多格式）— Up_mp.do

同上，扩展名自动从 base64 头识别，支持 jpg/png/gif/bmp/webp/ico。

3) 文档 / 通用文件 — Up_PDF.do

POST https://file.muzhiyun.com/Up_PDF.do
Header: X-XSRF-TOKEN: Bearer <token>
Form:  file = (二进制文件)
        name = report.pdf

支持类型见服务端 config ALLOWED_TYPES（pdf/doc/docx/xls/xlsx/ppt/pptx/txt/csv/zip/mp3/mp4 ...）
上限 100MB

三、预览 / 下载方法

上传成功返回的 url 即完整预览地址，直接 <img src> 或浏览器打开即可：

https://f.muzhiyun.com/<加密长串>          # 原图/原文件预览

# 缩图（仅图片）：s=目标宽度
https://f.muzhiyun.com/<加密长串>?s=300

# 触发下载（Content-Disposition: attachment）
https://f.muzhiyun.com/<加密长串>?act=download

四、数据表结构

本站不提供查询后台，但所有上传与访问均会写入以下数据表，供业务系统自行对接统计。

mzy_files（文件主表）

mzy_files_log（访问日志）

五、需要你改的配置（服务端 config.do）