123 Open（开放平台）

千石(okatu-loli)2025年8月5日GuideStorageGuide123 Open大约 3 分钟

123 Open 是 123云盘推出的开放平台接口，可通过密钥鉴权的方式在 Alist 中实现挂载访问。

支持文件浏览、上传、预览、下载、管理等功能，并由 Alist 自动维护 token 生命周期。

需开通付费功能

文件列表等基础功能可免费使用，但直链相关功能（如预览、下载）依赖于付费的开放平台权限。

请前往 123云盘购买「VIP」服务，并在 123开放平台创建应用以获取接口凭证（Client ID 和 Client Key）。

接入说明

要通过 123 Open 将 123云盘资源挂载到 Alist，请先完成以下准备工作：

注意事项

挂载过程中，Alist 将使用 Client ID 和 Client Key 自动获取访问凭证（Token），并在后台自动维护，无需用户干预。

该过程仅在本地进行，不涉及任何外部中转，因此不存在隐私泄露风险。
但请务必妥善保管你的 Client ID 和 Client Key，避免泄露。

直链设置

设置直链空间（用于预览/下载）

请务必完成以下设置

未启用「直链空间」将导致 Alist 无法生成直链或预览链接。

进入 123云盘，按以下步骤操作：

直链空间

功能支持

以下为 123 Open 驱动当前支持的功能：

上传说明

如上传的文件未提供完整哈希，Alist 会自动缓存后计算 MD5 值。

当前暂不支持以下功能：

根目录限制

虽然可以将根目录（ID 为 0）作为挂载目录，但无法在根目录使用直链功能（如预览、视频播放、图片查看等）。

建议将挂载目录设置为已开启直链空间的子文件夹。