用途:诊断并解决 Amazon S3 Files 的常见问题,包括挂载失败、IAM 权限错误、同步异常、冲突解析和性能问题,适用于用户遇到 S3 Files 挂载或读写故障时。
主要能力:按症状分类定位问题——A 客户端安装、B 网络与安全组、C IAM 权限、D 同步、E 冲突解析、F 性能、G 加密/KMS、H VPC DNS;并提供对应检查与修复命令。
使用方式:先验证依赖,要求 aws CLI 支持 s3files 子命令且凭据有效,只检查工具是否存在与版本,验证时不执行破坏性或变更类命令,工具缺失需告知用户,用户决定中止须尊重。执行步骤前应说明,写操作等待用户确认。
典型修复:安装 amazon-efs-utils;安全组需允许 TCP 2049 双向流量,可用 authorize-security-group-ingress 修复,并用 nc -zv 测试连通性;隔离 VPC 无互联网时需 CloudWatch Logs VPC 端点。IAM 方面,挂载需 s3files:ClientMount,写需 s3files:ClientWrite,root 需 s3files:ClientRootAccess(会绕过 POSIX 权限,建议用访问点限定 POSIX 用户)。同步写入约 60 秒完成,可用 getfattr 查看状态,关注 PendingExports 指标。冲突文件会进入 lost+found,以 S3 版本为准。KMS 问题需确认密钥启用且角色有权限;DNS 需 enableDnsHostnames 与 enableDnsSupport 均为 true。ECS 场景应使用 s3filesVolumeConfiguration。可在 s3files-utils.conf 设 logging_level = DEBUG,日志位于 /var/log/amazon/efs/mount.log。
限制:安全上应遵循最小权限,避免使用 FullAccess;无文件系统策略时任意 VPC 客户端可挂载;日志含 S3 键名需限制访问。具体价格、配额数值及官方文档内容暂未提供。