Azure Linux数据科学虚拟机JupyterHub新用户默认示例文件配置

我刚好处理过Azure DSVM上JupyterHub的这个问题，其实有几个直接的配置方式可以移除默认示例或者替换成你自己的内容，下面一步步来：

1. 从系统用户模板入手（最基础的方式） #

Linux系统里，新用户的home目录内容默认是从/etc/skel目录复制过来的，DSVM的JupyterHub默认示例文件大概率也是从这里来的：

• 先备份原模板以防出错：

  sudo cp -r /etc/skel /etc/skel_backup
  

• 删除你不需要的默认示例文件夹（比如DSVM自带的notebooks目录）：

  sudo rm -rf /etc/skel/notebooks
  

• 把你的自定义示例文件/文件夹复制到/etc/skel下：

  sudo cp -r /path/to/your/custom/content /etc/skel/
  

2. 配置JupyterHub的Spawner钩子（更灵活的自定义） #

如果系统模板的方式不够灵活，你可以直接修改JupyterHub的配置，通过预生成钩子来控制用户初始化时的文件：

• 打开JupyterHub的主配置文件：

  sudo nano /etc/jupyterhub/jupyterhub_config.py
  

• 添加以下自定义逻辑（可以根据需求调整）：

  def customize_user_environment(spawner):
      import subprocess
      import os
      user_home = spawner.user.home
      
      # 移除默认的示例文件
      default_notebooks = os.path.join(user_home, "notebooks")
      if os.path.exists(default_notebooks):
          subprocess.run(["rm", "-rf", default_notebooks], check=True)
      
      # 复制你的自定义示例到用户目录
      custom_templates = "/path/to/your/custom/templates"
      if os.path.exists(custom_templates):
          subprocess.run(["cp", "-r", f"{custom_templates}/.", user_home], check=True)
  
  # 绑定这个钩子到Spawner的预生成事件
  c.Spawner.pre_spawn_hook = customize_user_environment
  

• 保存配置后，重启JupyterHub服务生效：

  sudo systemctl restart jupyterhub
  

3. 验证修改效果 #

创建一个新测试用户，登录JupyterHub后检查用户home目录：

• 默认的示例文件应该已经被移除
• 你的自定义内容会出现在用户目录中

注意：如果是已经存在的用户，修改不会自动生效，只对新创建的用户有效。如果要修改已有用户的环境，需要手动处理他们的home目录。

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