用途:诊断并解决阿里云 NAS 挂载失败问题,覆盖 Linux/Windows 系统的 NFS 与 SMB 协议挂载场景。
主要能力:收集挂载点地址、协议、操作系统、报错信息等基础信息;从挂载点域名识别 NAS 类型(含 .extreme. 为极速型,否则为通用型)、地域与文件系统 ID;执行预检查(挂载点状态、账户欠费、文件系统信息);按场景排查 Linux NFS、Windows SMB、Linux SMB、Windows NFS 及容器(K8s/Docker)挂载失败;通过 API 辅助诊断 VPC 一致性、权限组规则、安全组端口放行;输出结构化诊断报告。
使用方式:需先安装并初始化 aliyun CLI,每次诊断前执行 aliyun plugin update。CLI 默认输出 JSON,不要添加 --output json 等格式参数。所有调用必须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-nas-mount-diagnosis/{session-id},session-id 为每次会话生成一次的 32 位小写十六进制字符串,可用 python3 -c "import uuid; print(uuid.uuid4().hex)" 生成。凭据通过 aliyun CLI profile 配置。常用命令包括 aliyun nas describe-file-systems、describe-mount-targets、describe-access-rules,以及 aliyun ecs describe-instances、describe-security-group-attribute、describe-security-groups。Linux NFS 可先运行官方脚本:wget --timeout=30 https://nas-client-tools.oss-cn-hangzhou.aliyuncs.com/linux_client/check_alinas_nfs_mount.py -P /tmp/ 后执行 python2.7 /tmp/check_alinas_nfs_mount.py <mount-target-address>:/ /mnt;Windows SMB 可运行 alinas_smb_windows_inspection.ps1。
适用场景:ECS 上 NAS 挂载报错、子目录挂载 access denied、端口/VPC/权限组/安全组排查、容器挂载失败等。
限制:仅执行只读诊断,不做写操作;运行诊断的机器需能访问阿里云 OpenAPI,远程 ECS 诊断需 SSH 或云助手;需具备相应 RAM 权限;具体权限清单与各场景详细步骤见资料中的 references 文件,本处未完整提供。