nodebb

nilsramsperger/nodebb Docker 镜像

自动构建

一个用于快速启动NodeBB论坛的简单Docker镜像,内置Redis数据库(AOF持久化),支持数据持久化和配置管理,适合快速部署轻量级论坛。

9 次收藏下载次数: 0状态:自动构建维护者:nilsramsperger仓库类型:镜像最近更新:
下载命令
点击查看

nilsramsperger/nodebb

镜像概述

nilsramsperger/nodebb是一个用于快速部署NodeBB论坛的Docker镜像,基于GitLab自动构建。该镜像内置Redis数据库,采用AOF持久化模式(虽非最快但能最大程度减少意外关闭时的数据丢失),默认不含插件,所有论坛数据存储在容器内的Redis中。

保持更新

NodeBB镜像的新版本会对应仓库中的标签。可通过***关注@***获取更新通知。

可用标签

  • latest(最新稳定版)
  • v2.8.12
  • v2.8.11
  • v2.8.10
  • v2.8.9
  • v2.8.8
  • v2.8.7
  • v2.8.6
  • v2.8.5
  • v2.8.2
  • v2.8.1
  • v2.8.0

注意:其他标签为实验性版本,可能无法正常运行,建议使用latest或特定版本标签。

核心功能与特性

  • 快速部署:无需复杂配置,一键启动NodeBB论坛
  • 内置Redis:集成Redis数据库,采用AOF持久化确保数据安全
  • 数据持久化:通过卷挂载实现配置、数据和上传文件的持久化存储
  • 环境变量配置:支持自定义公共URL和时区
  • 版本管理:提供多个稳定版本标签,支持版本回滚

使用场景

  • 个人或小型社区快速搭建轻量级论坛
  • 开发/测试环境中快速部署NodeBB实例
  • 需要简单维护的中小型论坛系统

使用方法

创建容器

bash
docker create --name myNodeBB --init --restart always -p 4567:4567 \
  -v nodebb-data:/var/lib/redis \
  -v nodebb-files:/opt/nodebb/public/uploads \
  -v nodebb-config:/etc/nodebb \
  nilsramsperger/nodebb

参数说明:

  • --name myNodeBB:容器名称为myNodeBB
  • --init:启用init进程
  • --restart always:容器退出时自动重启
  • -p 4567:4567:将容器4567端口映射到主机4567端口
  • 三个卷挂载:
    • nodebb-data:存储Redis数据
    • nodebb-files:存储上传文件(如头像)
    • nodebb-config:存储NodeBB配置文件

启动容器

bash
docker start myNodeBB

首次启动时,NodeBB会进入Web安装界面:

  1. 创建管理员账户并完成基础设置
  2. 务必将数据库类型切换为Redis,点击"Install NodeBB"
  3. 安装完成后点击"Launch NodeBB",容器将重启并自动进入论坛页面

环境变量配置

公共URL

若论坛通过公共URL访问,需设置url环境变量以确保WebSocket等功能正常:

bash
-e url=https://www.myforum.com:8080

时区

默认使用UTC时区,可通过timezone环境变量自定义:

bash
-e timezone=Europe/Brussels  # 示例:欧洲/布鲁塞尔时区

卷说明

卷路径用途
/etc/nodebb存储NodeBB配置文件config.json
/var/lib/redis存储Redis数据库数据
/opt/nodebb/public/uploads存储用户上传文件(头像、附件等)

备份与恢复

备份

保存三个卷的内容即可完成备份:

bash
# 示例:备份到本地目录
docker run --rm -v nodebb-data:/source/data -v $(pwd):/backup docker.xuanyuan.run/alpine tar -czf /backup/nodebb-data.tar.gz -C /source/data .
docker run --rm -v nodebb-files:/source/files -v $(pwd):/backup docker.xuanyuan.run/alpine tar -czf /backup/nodebb-files.tar.gz -C /source/files .
docker run --rm -v nodebb-config:/source/config -v $(pwd):/backup docker.xuanyuan.run/alpine tar -czf /backup/nodebb-config.tar.gz -C /source/config .

恢复

将备份文件恢复到对应卷:

bash
# 示例:从备份恢复
docker run --rm -v nodebb-data:/target/data -v $(pwd):/backup docker.xuanyuan.run/alpine sh -c "rm -rf /target/data/* && tar -xzf /backup/nodebb-data.tar.gz -C /target/data"
# 对nodebb-files和nodebb-config执行类似操作

版本更新

  1. 备份卷数据(见备份步骤)
  2. 停止并删除当前容器:
    bash
    docker stop myNodeBB && docker rm myNodeBB
    
  3. 使用创建容器命令重新创建(会自动拉取最新镜像)
  4. 启动容器:docker start myNodeBB,容器将自动运行nodebb upgrade完成数据库迁移

重启说明

由于NodeBB通过app.js启动,管理面板中的重启功能已禁用,需通过重启容器实现:

bash
docker restart myNodeBB

故障排除

问题:WebSocket连接持续断开并无限重试

解决方案:config.json中的公共URL和端口设置不正确。创建容器时通过-e url="http://127.0.0.1:4567"指定正确的公共URL。

问题:Web安装界面提示数据库连接失败,或容器无限重启

解决方案:可能使用了已存在的卷导致权限问题。建议使用全新的命名卷,或确保Redis对卷有读写权限。

问题:更新后论坛损坏

解决方案:

  1. 删除当前容器:docker rm myNodeBB
  2. 使用备份恢复卷数据
  3. 创建指定版本容器(例如恢复到v1.13.0):
    bash
    docker create --name myNodeBB --init --restart always -p 4567:4567 \
      -v nodebb-data:/var/lib/redis \
      -v nodebb-files:/opt/nodebb/public/uploads \
      -v nodebb-config:/etc/nodebb \
      nilsramsperger/nodebb:v1.13.0
    

问题:更新并安装quill编辑器插件后出现"invalid-event"错误

解决方案:

  1. 确保仅启用quill编辑器或markdown+默认编辑器(不要同时启用)
  2. 重启容器:docker restart myNodeBB

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 nodebb 镜像标签

docker pull docker.xuanyuan.run/nilsramsperger/nodebb:<标签>

DockerHub 原生拉取命令

docker pull nilsramsperger/nodebb:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告