jbthechamp/nodebb

NodeBB

镜像概述和主要用途

https://nodebb.org 由 Node.js 驱动，可基于 Redis 或 MongoDB 数据库构建。它利用 WebSocket 实现即时交互和实时通知，内置社交网络集成、流式讨论等现代功能，同时确保与旧版浏览器兼容。通过第三方插件可进一步扩展功能。

核心功能和特性

• 技术栈：基于 Node.js 构建，支持 Redis（2.8.9+）或 MongoDB（2.6+）数据库
• 实时交互：采用 WebSocket 技术，实现即时消息传递和实时通知
• 现代功能：内置社交网络集成、流式讨论、多语言支持等
• 主题引擎：高度灵活，支持通过 LESS 或 CSS 自定义样式，基础主题基于 Bootstrap 3，也可使用其他框架
• 插件扩展：丰富的第三方插件生态，可扩展功能
• 兼容性：兼顾现代浏览器与旧版浏览器

使用场景和适用范围

适用于构建各类社区论坛、讨论板、社交平台，尤其适合需要实时交互、现代用户体验和可定制化界面的场景，如技术社区、兴趣小组、企业内部交流平台等。

系统要求

运行 NodeBB 需要以下软件：

• Node.js：版本 4 或更高（https://github.com/nodesource/distributions%EF%BC%89
• 数据库：Redis 2.8.9+ 或 MongoDB 2.6+
• Web 服务器：nginx 1.3.13+（仅当需要通过 nginx 代理请求时）

安装与配置

常规安装

http://docs.nodebb.org/en/latest/installing/os.html

Docker 部署示例

docker run 命令（使用 Redis）

bash
docker run -d \
  --name nodebb \
  -p 4567:4567 \
  -e "DATABASE=redis" \
  -e "REDIS_HOST=redis-server" \
  -e "REDIS_PORT=6379" \
  -e "REDIS_PASSWORD=your-redis-password" \
  docker.xuanyuan.run/nodebb/nodebb:latest

docker-compose 配置（Redis + NodeBB）

yaml
version: '3'

services:
  redis:
    image: docker.xuanyuan.run/redis:alpine
    container_name: redis-server
    volumes:
      - redis-data:/data
    command: redis-server --requirepass your-redis-password
    restart: always

  nodebb:
    image: docker.xuanyuan.run/nodebb/nodebb:latest
    container_name: nodebb
    ports:
      - "4567:4567"
    environment:
      - DATABASE=redis
      - REDIS_HOST=redis-server
      - REDIS_PORT=6379
      - REDIS_PASSWORD=your-redis-password
    depends_on:
      - redis
    restart: always

volumes:
  redis-data:

安全配置

确保 NodeBB 和数据库服务器的安全性，请注意以下几点：

1. Redis 安全：

   • 默认 Redis 监听所有网络接口，存在安全风险，建议设置 bind_address 为 127.0.0.1，仅允许本地访问
   • 使用 requirepass 设置密码（建议使用长密码）
   • 熟悉 http://redis.io/topics/security

2. 服务器防火墙：

   • 使用 iptables 限制开放端口，在 Ubuntu 中可通过 ufw 简化配置
   • 例如：若通过代理访问 NodeBB，仅开放 80 端口（及可能的 22 端口用于 SSH 访问）

升级说明

详细的升级步骤请参考 https://docs.nodebb.org/en/latest/upgrading/index.html

如何参与贡献

• 开发者：可查看源代码并提交 pull 请求，http://community.nodebb.org/category/7/nodebb-plugins 是了解代码库的良好起点
• 设计师：http://community.nodebb.org/category/10/nodebb-themes%EF%BC%81%E4%B8%BB%E9%A2%98%E7%B3%BB%E7%BB%9F%E6%94%AF%E6%8C%81%E6%89%A9%E5%B1%95%E5%9F%BA%E7%A1%80%E6%A8%A1%E6%9D%BF%E5%8F%8A%E9%80%9A%E8%BF%87 LESS/CSS 自定义样式
• 翻译者：可通过 Transifex 帮助翻译 NodeBB
• 欢迎 点赞、关注 并 为仓库加星，加入 http://community.nodebb.org 了解最新开发动态

许可证

NodeBB 采用 GNU 通用公共许可证 v3 (GPL-3) 授权（http://www.gnu.org/copyleft/gpl.html%EF%BC%89%E3%80%82

如需在非自由/限制性环境中使用 NodeBB 的 sublicense 协议，请联系 ***。

相关资源

• http://community.nodebb.org
• http://docs.nodebb.org
• http://blog.nodebb.org
• http://www.nodebb.org/

• ---

• ---

截图

NodeBB 的主题引擎高度灵活，不限制设计选择。以下是部分主题示例：

![]([] ![]([] ![]([] ![]([] ![]([] ![]([] ![]([] ![]([]

简约的 "Persona" 主题可立即使用，无需编码经验：

![]([] ![]([]