nilsramsperger/nodebb
nilsramsperger
自动构建
一个用于快速启动NodeBB论坛的简单Docker镜像，内置Redis数据库（AOF持久化），支持数据持久化和配置管理，适合快速部署轻量级论坛。
9 次收藏下载次数: 0状态：自动构建维护者：nilsramsperger仓库类型：镜像最近更新：3 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这段话即可：
请先阅读并遵守：https://xuanyuan.cloud/agents.md
未读文档前不要生成 pull 命令或排错方案。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
nilsramsperger/nodebb
A simple Docker image for quick-launching a NodeBB forum.
Description
This repo contains the files for the automatic build of the Docker image nilsramsperger/nodebb hosted on https://gitlab.com/nilsramsperger/docker-nodebb.
The NodeBB comes with no plugins and the forum data is stored in a http://redis.io within the container. The Redis is configured for http://redis.io/topics/persistence. Not the fastest but the least chance for data loss on unexpected shutdowns.
Stay up to date
New releases of the NodeBB image come with a corresponding tag in the repo. You can follow me on *** (@***) to be notified about updates.
Tags
latestv2.8.12v2.8.11v2.8.10v2.8.9v2.8.8v2.8.7v2.8.6v2.8.5v2.8.2v2.8.1v2.8.0
Be advised, any other tags are for experimental purpose and might not be runnable.
Best stick to latest or a specific version tag.
Setup
Create the container
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
In this case the container named myNodeBB and is bound to local port 4567.
The three volumes are linked to the named volumes nodebb-data, nodebb-files and nodebb-config.
Change things as you like.
Start the container
docker start myNodeBB
On first run, NodeBB will start it's web installer interface. There you can create your admin account and set things up. Switch the database to Redis and click "Install NodeBB". When everything is done, click "Launch NodeBB". The container will restart and the browser switch to the forum.
Environment Variables
Public URL
If your NodeBB forum is accessible via a public URL, it needs to be told about that.
Otherwise some features might break.
WebSockets for example.
Tell NodeBB about it's public URL by setting the url environment variable on container creation.
Example: -e url=https://www.myforum.com:8080
Timezone
Per default, the container uses UTC as timezone.
If you want to specify a different timezone, add timezone as ENV on container creation.
Example: -e timezone=Europe/Brussels
Volumes
/etc/nodebbcontains NodeBB'sconfig.json/var/lib/rediscontains the Redis data/opt/nodebb/public/uploadscontains NodeBB uploads like avatars
Backup and restore
Save the contents of the three volumes for creating a backup. To restore, copy the contents back.
Update to latest version
If you want to update your NodeBB to the latest version, make backups of the volumes first.
After that just stop and remove your current container.
Then recreate it with the create command from the install section.
On startup, the container will run a nodebb upgrade and thus prepare the database for the new version of NodeBB.
Restarting
Since NodeBB is started via the app.js, restarting from admin panel is disabled.
If you want to, just restart the container.
Troubleshooting
Problem
The NodeBB web-client notifies about broken web socket connections and tries to reestablish infinitely.
Solution
The public URL and port in the config.json are not set correctly.
When creating the container, you can set the public URL via -e url="http://127.0.0.1:4567".
Problem
The web installer tells the database connection cannot be established and/or the container is restarting infinitely.
Solution
May be you are using preexisting named volumes or host volumes. If so, make sure redis can access them. Anyway, fresh named volumes is the preferred way.
Problem
Something went wrong while updating to a newer version of NodeBB. Now the forum is broken.
Solution
- Delete the container.
- Restore the volumes, using the backups you created before updating.
- Create a new container using the
createcommand from the install section with a fixed image version.- Append the version number of the previously used image to the image name.
- For example:
nilsramsperger/nodebb:v1.13.0
Problem
NodeBB shows an "invalid-event" error after performing updates and installation of the quill editor plugin. An example is documented here:
- https://community.nodebb.org/topic/***/cannot-write-post-or-reply-after-1-15-1-16/4
- https://github.com/nilsramsperger/docker-nodebb/pull/10
Solution
It is not quite sure, what actually caused the problem. The following actions solved the issue:
- Make sure only quill or markdown and default composer are active.
- Restart server and container
更多相关 Docker 镜像与资源
以下是 nilsramsperger/nodebb 相关的常用 Docker 镜像，适用于 不同场景 等不同场景：
- elestio/nodebb Docker 镜像说明（Nodebb 容器镜像，适合 elestio 维护的 Nodebb 工作负载部署）
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 nodebb 镜像标签
docker pull docker.xuanyuan.run/nilsramsperger/nodebb:<标签>
DockerHub 原生拉取命令
docker pull nilsramsperger/nodebb:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"
