NodeBBS 支持通过 Docker volume 挂载 的方式自定义网站 Logo 与图标,适用于 镜像部署 与 源码部署。
一、创建配置文件
在项目根目录下创建 config.yml 文件,并添加如下内容:
services:
web:
volumes:
# 网站图标(浏览器标签页)
- ./web/favicon.ico:/app/apps/web/public/favicon.ico
# 网站 Logo
- ./web/logo.svg:/app/apps/web/public/logo.svg
# Apple Touch Icon(iOS 添加到主屏幕图标)
- ./web/apple-touch-icon.png:/app/apps/web/public/apple-touch-icon.png
二、准备图标文件
在项目根目录下创建 web 目录,并将以下文件放入该目录中:
favicon.ico:网站浏览器图标,推荐分辨率 256x256logo.svg:网站 Logoapple-touch-icon.png:iOS 添加到主屏幕时显示的图标,推荐分辨率 180x180
文件名需与配置中保持一致
三、重启服务
在项目目录中执行:
npx nodebbs
根据提示选择 重启服务 即可生效。
四、缓存说明
更换 Logo 或图标后,浏览器可能存在缓存:
- 可尝试 强制刷新(Ctrl / Cmd + Shift + R)
- 或等待片刻后自动生效
📌 说明
- 本方法同时适用于 Docker 镜像部署 和 源码部署
- 如在使用过程中遇到问题,欢迎在本帖中回复反馈
