在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像在 AIStudio 镜像中心使用 Dockerfile 自助构建最新版 vLLM 镜像 ，无需访问 DockerHub立即构建
文档中心

Appearance

✨充值控制台

使用共享高性能存储 ​

本节介绍如何在实际工作中使用共享高性能存储，包括挂载、访问、数据传输和常见问题。

前提条件 ​

在使用共享高性能存储前，请确认：

  • 租户已购买并创建文件系统
  • 管理员已创建存储卷
  • 您已被授予存储卷的操作权限（IAM）和挂载权限

注意

如果您是租户超级管理员，无需配置权限即可使用所有存储卷。如果您是普通用户且无法看到存储卷，请联系管理员或参考 故障排除 章节。

挂载共享高性能存储 ​

创建开发机、任务和推理服务的过程中，存储配置区域会自动展示租户下的共享高性能存储目录，同时平台展示建议的挂载点。

alt text

共享高性能存储配置项如下（表中为配置示例）：

文件系统名称存储卷名称与 ID挂载点（容器内访问路径）挂载权限
广东B-默认高性能存储/public (vo-c7kcjqv2tjs5llry)/mnt/public公共读写

注意

请在 UI 上完成挂载点配置。暂不支持在开发机、推理实例、或任务 Worker 内部手动挂载智算云平台的共享高性能存储。

容器内挂载点可自定义，请注意无法使用以下保留路径及其子路径：

  • /
  • /bios
  • /boot
  • /dev
  • /etc
  • /lib
  • /lib32
  • /lib64
  • /libx32
  • /opt
  • /proc
  • /root
  • /run
  • /sbin
  • /srv
  • /sys
  • /usr
  • /var
  • /home
  • /datadisk

访问共享高性能存储 ​

挂载共享高性能存储后，您就可以在开发机、任务 Worker、推理服务实例中访问共享高性能存储。

查看配额 ​

在我们的容器中（包括开发机、任务的 Worker、推理服务实例），执行 df -h 命令会返回应用于当前租户的真实配额信息。

shell
Filesystem      Size  Used Avail Use% Mounted on
testfilestore   2.0T  192G  1.9T  10% /mnt/public
testfilestore   2.0T  192G  1.9T  10% /mnt/resource
testfilestore   2.0T  192G  1.9T  10% /mnt/johndoe

传输数据 ​

如果需要从本地设备传输数据到共享高性能存储，必须通过开发机或 AICoder：

  • AICoder：免费的纯 CPU 实例（Ubuntu）。借助智算云平台提供的 SSH 跳板机，您可通过 ssh -J 方式从公网 SSH 远程登录 AICoder。详细步骤参考 通过 AICoder 传输文件。
  • 开发机：挂载了 1/2/4/8 个 GPU 的 Linux 实例（有 GPU 试用资源才能创建），提供公网 SSH 访问地址。开发机直接提供 SSH 远程登录的公网 IP 地址，缺点是会同时占用显卡资源。详细步骤参考 通过开发机传输文件。

提示

如果仅需要操作共享高性能存储，也可使用 AICoder 进行文件传输。AICoder 为 CPU 实例，不会占用显卡资源。

数据传输工具 ​

目前支持的本地数据传输方案都基于 SSH，默认支持命令行界面下 2 种常用的文件传输方案，即 scp 和 sftp。

如果您在寻找使用图形化界面传输文件的方案：
📖 VS Code 远程开发：为开发机、AICoder 提供本地般的开发体验
📖 如何使用 FileZilla 管理开发机内的文件
📖 在智算云平台上使用 File Browser 管理数据

AICoder 默认已集成 File Browser，支持直接通过网页传输文件。

如果您对断点续传有强烈要求：
📖 使用 rsync 传输数据到开发机

总结：

  • 开发机： scp/sftp（命令行）、filezilla（图形界面）、VS Code（图形界面）、自行安装 File Browser（图形界面）
  • AICoder： scp/sftp（命令行）、内建 File Browser、VS Code（图形界面）

提示

  • 开发机支持 SSH 用户名/密码认证，也支持基于 SSH 密钥的认证。请提前确认可成功 SSH 远程登录开发机。如需帮助，请参考 SSH 远程登录。
  • 由于 AICoder 仅支持基于 SSH 密钥的身份认证，所以必须提前在机器内添加您的 SSH 公钥。
📖 添加 SSH 公钥指南

故障排除 ​

本节帮助您诊断和解决使用共享高性能存储时的常见问题。

诊断流程：无法看到或挂载存储卷 ​

如何检查我的存储操作权限？ ​

  1. 联系租户管理员，或访问 身份管理 > 用户页面。

    身份管理-用户

  2. 查看您的用户详情，切换到权限管理标签页。

  3. 确认是否有「存储-存储卷」相关权限，特别是「获取存储卷列表」。

如何检查我的存储挂载权限？ ​

  1. 联系租户管理员查询您对目标存储卷的挂载权限。

  2. 挂载权限需在高性能存储 > 存储卷管理 > 管理挂载权限中配置。

    高性能存储

注意

普通用户可能无法自行查看挂载权限配置。如遇权限问题，请联系租户管理员。

提示

管理员可参考 快速入门：为团队配置共享高性能存储 完成权限配置。

常见问题 ​

共享高性能存储的性能如何？ ​

答：共享高性能存储性能可达每单位 30k IOPS，上限 1 亿文件（以 10TB 为单位）。

如何挂载共享高性能存储到我的服务？ ​

答：当前仅支持在创建开发机、任务、推理服务时通过 UI 创建挂载点。

为什么创建开发机、推理服务、任务时看不到存储卷？ ​

在创建容器实例（开发机、任务、推理服务）时，如果在存储配置中看不到存储卷，需要满足两个条件：

  1. 存储操作权限（IAM 层面）：非管理员用户默认只能看到自己创建的存储卷。如果需要查看和挂载他人创建的存储卷，用户必须拥有这些存储卷的操作权限。
  2. 存储卷挂载权限：对存储卷至少有只读权限。挂载权限为「无」时，用户无法在下拉列表中看到该卷。

提示

请参考上方的 诊断流程 排查问题，或联系租户管理员检查权限配置。详细配置步骤请参考 快速入门：为团队配置共享高性能存储。

为什么挂载后无法写入数据？ ​

可能原因：

  • 您对该存储卷的挂载权限为「只读」，而非「读写」
  • 在创建实例时选择了「只读」挂载模式

解决方法：联系租户管理员将您的挂载权限从「只读」改为「读写」。

存储卷可以跨可用区使用吗？ ​

不可以。存储卷仅可被同一可用区的容器实例（开发机、任务、推理服务、AICoder）挂载。例如，广东 B 可用区的存储卷只能挂载到使用广东 B 算力的实例。

共享存储里放东西别人也能看见吗？如果不想别人看到某些文件，应该怎么办？ ​

这取决于存储卷的权限配置。智算云平台通过双层权限模型控制存储访问。默认新建存储卷 不会 自动对所有人可见。

是否能看见取决于：

  1. 存储卷操作权限：管理员可以为不同用户/用户组配置不同的操作权限（我的、指定资源、所需文件系统下所有）。如果某用户的操作权限为「我的」，该用户在创建实例时完全看不到非本人创建的存储卷，也就无法访问其中的文件。
  2. 存储卷挂载权限：管理员可以为不同用户/用户组配置不同的挂载权限（读写、只读、无）。如果某用户的挂载权限为「无」，该用户在创建实例时完全看不到这个存储卷，也就无法访问其中的文件。

保护私有文件的建议做法：

  1. 创建专用存储卷：联系管理员创建个人专用存储卷（如 /private-username），并仅为您配置操作和挂载权限。这样可以从平台层面彻底隔离，其他用户连挂载都无法实现。
  2. 使用云盘：对于按量付费开发机，可以使用云盘作为专属存储，云盘非共享存储，仅限所属开发机访问。

如何让他人可以看到我放在共享存储里的文件？ ​

要让团队成员访问您在共享存储中的文件，需要确保以下几点：

Step 1 确认文件在正确的存储卷中

  • 确认文件已上传到团队约定共享的存储卷（例如 ID 为 vo-db2mlm7jmq55l5kh，路径为 /shared 的存储卷），而非您的私有存储卷。

Step 2 确认其他成员有存储卷访问权限

联系租户管理员确认团队成员已配置：

  1. 操作权限（IAM）：能在平台 UI 中看到该存储卷
  2. 挂载权限：对存储卷至少有「只读」权限（如需让他们修改文件，设置为「读写」）

权限配置详见 快速入门：为团队配置共享高性能存储。

Step 3 通知团队成员挂载路径

告知团队成员在创建开发机/任务/推理服务时：

  • 在存储配置区域选择对应的存储卷（例如 ID 为 vo-db2mlm7jmq55l5kh，路径为 /shared 的存储卷）
  • 设置容器内的挂载点。建议挂载用于共享的存储卷时，约定使用一致的挂载路径（例如 /mnt/shared）。
  • 在容器内的文件访问路径即为：/mnt/shared/

注意

如果团队成员仍然无法访问，请按照 诊断流程 排查权限问题。