Jitsi默认虚拟背景替换异常求助：替换后黑屏且无法点击

异常原因 #

• 文件权限错误：替换后的图片权限未设置正确，Jitsi的web服务（以www-data用户运行）无法读取文件，导致显示黑色占位。
• 图片格式/损坏：虽命名为jpg，但实际是CMYK模式JPG、损坏文件或不兼容编码，浏览器解析失败引发黑屏。
• 缓存未清理：浏览器或nginx的静态资源缓存未更新，加载的仍是旧的损坏缓存文件，导致显示异常。

永久添加自定义背景的正确操作 #

方案1：替换现有背景（快速操作） #

1. 进入Jitsi容器：docker exec -it <你的容器名> bash（通常容器名为jitsi-meet-web）
2. 准备合规图片：使用RGB模式的JPG/PNG，分辨率匹配原背景（如1920x1080），文件大小不宜过大。
3. 替换后修正权限：chown www-data:www-data /usr/share/jitsi-meet/images/virtual-background/background-6.jpg
4. 刷新缓存：容器内执行service nginx reload，浏览器按Ctrl+F5强制刷新页面。

方案2：新增背景（不覆盖原有，更稳妥） #

1. 上传自定义图片到容器路径：/usr/share/jitsi-meet/images/virtual-background/，例如命名为custom-bg.jpg，并设置权限：chown www-data:www-data /usr/share/jitsi-meet/images/virtual-background/custom-bg.jpg
2. 修改配置文件/usr/share/jitsi-meet/config.js，找到virtualBackgrounds数组，新增条目：

   virtualBackgrounds: [
       // 保留原有所有背景条目
       {
           name: '我的自定义背景',
           url: 'images/virtual-background/custom-bg.jpg',
           thumbnail: 'images/virtual-background/custom-bg.jpg'
       }
   ],
   

3. 重启nginx生效：service nginx reload，浏览器强制刷新即可看到新背景。

关键：避免容器重启后丢失修改 #

若使用docker-compose部署，容器内的直接修改会随重启消失，需通过挂载本地目录持久化：

1. 本地创建./jitsi-custom目录，放入自定义图片和修改好的config.js
2. 修改docker-compose.yml的web服务volumes配置：

   volumes:
       # 保留原有挂载项
       - ./jitsi-custom/custom-bg.jpg:/usr/share/jitsi-meet/images/virtual-background/custom-bg.jpg
       - ./jitsi-custom/config.js:/usr/share/jitsi-meet/config.js
   

3. 重启容器：docker-compose up -d

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