123 Open（开放平台）
2025/8/5GuideStorageGuide123 Open大约 3 分钟
123 Open（开放平台）
123 Open 是 123云盘推出的开放平台接口，可通过密钥鉴权的方式在 Alist 中实现挂载访问。
支持文件浏览、上传、预览、下载、管理等功能，并由 Alist 自动维护 token 生命周期。
需开通付费功能
文件列表等基础功能可免费使用，但直链相关功能（如预览、下载）依赖于付费的开放平台权限。
请前往 123云盘 购买「VIP」服务，并在 123开放平台 创建应用以获取接口凭证（Client ID 和 Client Key）。
接入说明
要通过 123 Open 将 123云盘资源挂载到 Alist，请先完成以下准备工作：
- 已注册并登录 123云盘账户
- 已在 123云盘开放平台 创建应用，获取：
- Client ID
- Client Key
- （可选）开通「VIP」服务，以启用直链等高级功能
注意事项
挂载过程中，Alist 将使用 Client ID 和 Client Key 自动获取访问凭证（Token），并在后台自动维护，无需用户干预。
该过程仅在本地进行，不涉及任何外部中转，因此不存在隐私泄露风险。
但请务必妥善保管你的 Client ID 和 Client Key，避免泄露。
直链设置
请务必完成以下设置
未启用「直链空间」将导致 Alist 无法生成直链或预览链接。
进入 123云盘，按以下步骤操作：
- 找到目标文件夹，点击右键
- 点击 启用直链空间
- 启用后该目录会显示直链图标 🔗
- 进入该文件夹
- 浏览器地址栏中，URL 的末尾即为 Folder ID
- 在 Alist 中填写此 ID 作为挂载目录
功能支持
以下为 123 Open 驱动当前支持的功能：
- 📁 浏览文件/文件夹
- 📥 下载 / 预览（需开启直链）
- 📤 上传文件（支持秒传、分片）
- 🗂️ 新建文件夹
- ✏️ 重命名
- 🗃️ 移动文件/文件夹
- 🗑️ 删除
- 🔐 token 自动获取与刷新
上传说明
如上传的文件未提供完整哈希，Alist 会自动缓存后计算 MD5 值。
当前暂不支持以下功能：
- ❌ 文件/文件夹复制
- ❌ 在线压缩、解压
- ❌ 打包下载
:::
根目录限制
虽然可以将根目录（ID 为 0）作为挂载目录，但无法在根目录使用直链功能（如预览、视频播放、图片查看等）。
建议将挂载目录设置为已开启直链空间的子文件夹。