nodebb/docker

NodeBB 镜像文档

镜像概述

NodeBB是一款基于Node.js构建的现代论坛软件，支持Redis、MongoDB或PostgreSQL数据库，通过WebSocket技术实现即时交互和实时通知。该软件具备社交网络集成、流式讨论等现代特性，同时保持对旧浏览器的兼容性，可通过第三方插件扩展功能。

核心功能与特性

• 实时交互：利用WebSocket技术实现即时消息传递和实时通知
• 多数据库支持：兼容Redis（2.8.9+）、MongoDB（2.6+）和PostgreSQL
• 社交网络集成：支持主流社交平台账号登录与集成
• 插件生态：通过第三方插件扩展功能，满足个性化需求
• 灵活主题引擎：支持自定义主题，内置"Persona"简约主题，支持LESS/CSS样式定制
• 浏览器兼容性：兼顾现代浏览器与旧版浏览器的使用体验

使用场景

• 构建社区论坛平台
• 搭建实时讨论社区
• 企业内部交流平台
• 兴趣爱好交流社区
• 需要实时互动功能的在线社区

系统要求

• Docker环境
• 数据库：MongoDB 2.6+、Redis 2.8.9+ 或 PostgreSQL
• 如需集群部署，需配置Redis
• 如使用Nginx代理，需Nginx 1.3.13+版本

部署与使用方法

Docker Run 示例

bash
# 使用MongoDB作为数据库
docker run -d \
  --name nodebb \
  -p 4567:4567 \
  -e "DB_HOST=mongodb-host" \
  -e "DB_PORT=27017" \
  -e "DB_NAME=nodebb" \
  -v nodebb-data:/usr/src/app/node_modules \
  -v nodebb-uploads:/usr/src/app/public/uploads \
  nodebb/nodebb

Docker Compose 配置示例

yaml
version: '3'

services:
  nodebb:
    image: nodebb/nodebb
    container_name: nodebb
    ports:
      - "4567:4567"
    environment:
      - DB_HOST=mongodb
      - DB_PORT=27017
      - DB_NAME=nodebb
    volumes:
      - nodebb-data:/usr/src/app/node_modules
      - nodebb-uploads:/usr/src/app/public/uploads
    depends_on:
      - mongodb
    restart: always

  mongodb:
    image: mongo:4.4
    container_name: nodebb-mongodb
    volumes:
      - mongodb-data:/data/db
    restart: always

volumes:
  nodebb-data:
  nodebb-uploads:
  mongodb-data:

配置说明

环境变量

数据持久化

• node_modules目录：存储依赖包，建议挂载为卷
• public/uploads目录：存储用户上传文件，建议挂载为卷

安全注意事项

1. 数据库安全：

   • Redis配置：设置bind_address: 127.0.0.1限制本地访问，启用requirepass设置密码
   • 参考Redis安全文档配置安全策略

2. 服务器安全：

   • 使用防火墙（如iptables或ufw）限制开放端口，仅开放必要端口（如80/443和SSH端口）
   • 通过Nginx反向代理NodeBB，避免直接暴露NodeBB端口

升级方法

1. 停止当前容器：docker stop nodebb
2. 拉取最新镜像：docker pull nodebb/nodebb
3. 重新启动容器（使用原参数）：docker start nodebb

许可证

NodeBB采用GNU General Public License v3 (GPL-3) 许可。如需在非自由/限制性环境中使用NodeBB，请联系***获取 sublicense 协议。

相关资源

• 官方演示
• 开发者社区
• 完整文档
• 插件市场
• 主题开发