nilsramsperger查看 Docker Hub 原文页
自动构建
一个用于快速启动NodeBB论坛的简单Docker镜像,内置Redis数据库(AOF持久化),支持数据持久化和配置管理,适合快速部署轻量级论坛。
9 次收藏下载次数: 0状态:自动构建维护者:nilsramsperger仓库类型:镜像最近更新:
nilsramsperger/nodebb
镜像概述
nilsramsperger/nodebb是一个用于快速部署NodeBB论坛的Docker镜像,基于GitLab自动构建。该镜像内置Redis数据库,采用AOF持久化模式(虽非最快但能最大程度减少意外关闭时的数据丢失),默认不含插件,所有论坛数据存储在容器内的Redis中。
保持更新
NodeBB镜像的新版本会对应仓库中的标签。可通过***关注@***获取更新通知。
可用标签
latest(最新稳定版)v2.8.12v2.8.11v2.8.10v2.8.9v2.8.8v2.8.7v2.8.6v2.8.5v2.8.2v2.8.1v2.8.0
注意:其他标签为实验性版本,可能无法正常运行,建议使用
latest或特定版本标签。
核心功能与特性
- 快速部署:无需复杂配置,一键启动NodeBB论坛
- 内置Redis:集成Redis数据库,采用AOF持久化确保数据安全
- 数据持久化:通过卷挂载实现配置、数据和上传文件的持久化存储
- 环境变量配置:支持自定义公共URL和时区
- 版本管理:提供多个稳定版本标签,支持版本回滚
使用场景
- 个人或小型社区快速搭建轻量级论坛
- 开发/测试环境中快速部署NodeBB实例
- 需要简单维护的中小型论坛系统
使用方法
创建容器
bashdocker 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配置文件
启动容器
bashdocker start myNodeBB
首次启动时,NodeBB会进入Web安装界面:
- 创建管理员账户并完成基础设置
- 务必将数据库类型切换为Redis,点击"Install NodeBB"
- 安装完成后点击"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执行类似操作
版本更新
- 备份卷数据(见备份步骤)
- 停止并删除当前容器:
bash
docker stop myNodeBB && docker rm myNodeBB - 使用创建容器命令重新创建(会自动拉取最新镜像)
- 启动容器:
docker start myNodeBB,容器将自动运行nodebb upgrade完成数据库迁移
重启说明
由于NodeBB通过app.js启动,管理面板中的重启功能已禁用,需通过重启容器实现:
bashdocker restart myNodeBB
故障排除
问题:WebSocket连接持续断开并无限重试
解决方案:config.json中的公共URL和端口设置不正确。创建容器时通过-e url="http://127.0.0.1:4567"指定正确的公共URL。
问题:Web安装界面提示数据库连接失败,或容器无限重启
解决方案:可能使用了已存在的卷导致权限问题。建议使用全新的命名卷,或确保Redis对卷有读写权限。
问题:更新后论坛损坏
解决方案:
- 删除当前容器:
docker rm myNodeBB - 使用备份恢复卷数据
- 创建指定版本容器(例如恢复到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"错误
解决方案:
- 确保仅启用quill编辑器或markdown+默认编辑器(不要同时启用)
- 重启容器:
docker restart myNodeBB
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 nodebb 镜像标签
docker pull docker.xuanyuan.run/nilsramsperger/nodebb:<标签>
DockerHub 原生拉取命令
docker pull nilsramsperger/nodebb:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务