如何在Jupyterlab与Jupyterhub中自定义Logo和Launcher启动器

1. Jupyterhub 移除Logo方案可行性 #

该方案可行，但需要注意两个细节：

• 注意配置项的拼写：正确写法是c.JupyterHub.logo_file（JupyterHub的H为大写），拼写错误会导致配置不生效
• 该配置属于Jupyterhub全局配置，不需要必须放在spawner_class配置项附近，只要写入jupyterhub_config.py的顶层配置段即可，设置为None后重启Jupyterhub服务，默认Logo就会被隐藏。如果后续需要替换自定义Logo，直接把该参数的值改为自定义Logo文件的绝对路径即可。

补充：如果你使用了自定义的Jupyterhub页面模板，需要额外检查模板中是否硬编码了Logo路径，这种情况下单独修改logo_file参数可能不生效，需要同步修改模板内的Logo相关代码。

2. Jupyterlab 禁用Launcher扩展失效的解决方案 #

你之前执行的命令仅对当前用户生效，要在镜像构建阶段全局禁用该扩展，按优先级从高到低可以尝试以下方案：

• 方案1：给扩展禁用命令增加全局生效参数
  Jupyterlab默认的扩展操作仅对当前用户生效，构建镜像时需要指定系统级生效，执行以下命令即可：

jupyter labextension disable @jupyterlab/launcher-extension --level=system

• 方案2：通过配置文件全局禁用（更稳定，推荐）
  在镜像的系统级Jupyter配置目录（通常为/etc/jupyter/）下新建jupyter_lab_config.py文件，写入以下内容：

c.LabApp.disable_extensions = ["@jupyterlab/launcher-extension"]

该方案对Jupyterlab 3.x、4.x版本都适用，不会因为扩展安装方式变化失效。

• 排查方向：如果以上操作后仍然不生效，可以检查镜像内是否存在用户级配置覆盖：比如默认用户目录下的~/.jupyter/labconfig文件夹内存在扩展启用的相关配置，构建镜像时可以删除该目录的相关配置文件，避免优先级冲突。

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