使用subprocess执行s3fs挂载S3桶报错：fuse: device not found

问题背景 #

手动在终端执行s3fs <bucket_name>:/<bucket_folder> /home/<username>/s3-bucket -o umask=022 -o allow_other能正常挂载S3桶，但通过JupyterHub登录触发的Python subprocess脚本执行该命令时，报错fuse: device not found, try 'modprobe fuse' first。

核心原因 #

手动终端执行的权限/环境与JupyterHub启动的subprocess环境存在差异：

• FUSE模块未在系统启动时自动加载，且普通用户无权限手动加载该模块
• s3fs需要root权限才能访问FUSE设备，而subprocess以普通用户身份执行时缺少对应权限

解决方案 #

1. 确保FUSE模块开机自动加载 #

• 先手动加载FUSE模块验证：

  sudo modprobe fuse
  

• 编辑/etc/modules-load.d/fuse.conf文件（不存在则创建），添加一行内容：

  fuse
  

  配置后系统每次启动都会自动加载FUSE模块，无需手动执行modprobe。

2. 给s3fs设置setuid权限 #

普通用户默认无法直接操作FUSE设备，给s3fs二进制文件添加setuid权限，使其运行时临时获得root权限：

sudo chmod u+s /usr/bin/s3fs

提示：可通过which s3fs命令确认s3fs的实际路径，若路径不同需替换上述命令中的路径。

3. （可选）配置sudo免密执行modprobe（若前两步无效） #

如果FUSE模块偶尔仍未加载，可让subprocess先执行modprobe fuse，但需给JupyterHub用户配置sudo免密权限：

• 使用visudo编辑sudoers文件（避免语法错误）：

  sudo visudo
  

• 添加以下内容（替换<username>为JupyterHub对应的系统用户名）：

  <username> ALL=(ALL) NOPASSWD: /sbin/modprobe fuse
  

• 修改Python脚本，先加载模块再执行挂载：

  # 先加载fuse模块
  modprobe_cmd = ["sudo", "/sbin/modprobe", "fuse"]
  subprocess.run(modprobe_cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=True)
  # 执行s3fs挂载命令
  bash_command = f"s3fs <bucket-name>:/<bucket-folder> /home/{system_username}/s3-bucket -o umask=022 -o allow_other".split()
  result = subprocess.run(bash_command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, universal_newlines=True)
  

验证 #

完成配置后重新登录JupyterHub，检查挂载目录是否能正常访问S3桶内的文件。

内容的提问来源于stack exchange，提问作者smorenoq