Pan

交大云盘

项	值
平台	pan.sjtu.edu.cn
认证	jAccount 登录；私有 Web API 用 UserToken
数据方向	读 + 写（上传、下载、删除、分享）
难度	中（官方客户端）；高（第三方自动化）
最后验证	2026-10-25
证据等级	B（官方服务页）/ C（社区私有 API）

交大云盘（Pan）是学校私有部署的云存储。官方提供网页端和 PC 客户端，没有公开的第三方开发者 API；社区项目通过 Web 端私有接口和 COS 分片上传实现自动化，但不稳定、也可能违反使用条款。

要点

• 官方能力：个人空间、交大空间、上传与下载、共享、协作、历史版本、文件收集、本地同步；个人默认 1TB。
• 官方没有公开 API 申请流程。网页端和客户端使用 jAccount 登录。
• 社区私有 API 的已知形状：UserToken、/api/v1、COS 分片上传（4MB）、DELETE .../file/...?permanent=0。
• 如果只需同步或备份，使用官方客户端。需要第三方集成时，先确认接口变化风险和条款限制。

---

1. 官方能力

能力	说明
个人空间	默认 1TB；jAccount 登录
交大空间	本人获权访问的团队/部门空间
上传/下载	网页端、PC 客户端
共享/协作	共享链接、权限、协作
历史版本	文件版本
文件收集	收集任务
本地同步	PC 客户端双向同步/单向备份

老云盘 jBox 已于 2025-05-31 下线，新 Pan 已上线。[官方]

---

2. 认证

官方路径

1. 打开 https://pan.sjtu.edu.cn/。
2. 用 jAccount 登录。
3. 进入个人空间/已获权的交大空间。
4. PC 客户端复用同一账号建立同步任务。

没有公开的 OAuth clientId/scope 申请流程。官方服务页只描述用户使用，不描述第三方开发。

社区私有 API

社区项目（如 sjtu-downloader-all-in-one、TboxWebdav）记录的形态：

• 登录后拿 UserToken，后续请求带它。
• Base 形如 /api/v1；空间/目录/文件/上传/删除等端点。
• 分片上传走 COS，4MB 分片；401 时 renew token。
• 删除是移入回收站：DELETE /api/v1/file/{lib}/{space}/{path}?permanent=0；404 可视为幂等成功。
• 目录创建逐级 ensureFolderPath，缓存已创建路径避免重复 PUT。

这些不是官方契约，随时可能变。不要把 UserToken 当长期密钥，不要把它交给模型/日志。

---

3. 能做与不能做

能做（官方）：

• 网页端/客户端管理文件、同步、共享、版本。
• 用官方客户端做个人备份。

能做（社区，风险自负）：

• 把 Canvas/课堂视频下载后直传 Pan。
• 把 Pan 挂成 WebDAV（TboxWebdav）。
• 读取空间信息、目录、上传/删除。

不要做：

• 用别人的 UserToken。
• 批量搬运/公开分享他人的空间内容。
• 把 Pan 当稳定的对象存储给生产服务用（没有 SLA/公开 API）。
• 高频轮询/批量删除。

---

4. 常见问题

1. 没有公开 API：所有第三方实现都是私有 Web API；升级就坏。
2. UserToken 是凭据：泄露可读写云盘；只放加密存储。
3. 401 要 renew：token 过期后重新登录/刷新；不要无限重试。
4. 分片上传 4MB：分片大小/并发/断点续传要按社区实现；不要自己猜。
5. 删除是回收站：permanent=0；真要永久删除要另确认。
6. 路径编码：中文/空格/特殊字符要 URL 编码；不要拼接未转义的 path。
7. 同名文件：上传前查存在性；覆盖/跳过策略要明确。
8. COS 直传：分片 PUT 的签名/headers 由服务端返回；不要复用过期签名。
9. 条款风险：非官方客户端可能违反云盘使用条款；先看服务页/用户协议。
10. 不要当数据库使用：Pan 是文件存储，不适合低延迟对象存储场景；大量小文件读写很慢。

---

5. 建议

• 个人备份/同步：用官方客户端，别自己写。
• 课程资料归档：先下载到本地，再用官方客户端同步；不要在下载器里直接写 Pan。
• 非做不可：把 Pan 适配器隔离成一个模块，所有 URL 集中；失败时降级到「提示用户手动上传」，不要让主流程崩。
• 记录 last_verified；每次 Pan 前端升级后重测。

---

6. 证据与来源

• Pan 服务、jBox 下线、1TB、官方客户端：[官方 2026-10-25，net.sjtu.edu.cn/xxfw/jBoxjdyp.htm]
• 私有 API/COS/4MB/删除/401 renew：[社区] sunalan2025/sjtu-downloader-all-in-one ARCHITECTURE
• WebDAV/UserToken：[社区] 1357310795/TboxWebdav
• 官方手册：[官方] pan.sjtu.edu.cn/pandoc/

变更记录

• 2026-10-25：首版。明确「无公开 API」、社区私有 API 形状与风险。