>[danger] **弃用提醒:**
> *由于看云对于免费用户的限制愈发严苛,本文档已经迁移至语雀。本文档将不做维护。*
> **语雀地址**:[https://www.yuque.com/a632079/nodebb/start](https://www.yuque.com/a632079/nodebb/start)
*****
## 序言
NodeBB 是 一种基于 Node.js 构建的电子公告牌系统(Bulletin Board System)。事实上,NodeBB已经不能说是一种单纯的 BBS 系统了。相对于传统的BBS,它的风格其实更偏向于 WeCenter 这种话题类的平台(Platform),也就是说它可能并不是十分适合有 **传统BBS** 需求的站长。
NodeBB的优势在于 即时通讯技术 和 瀑布流消息的呈现模式,这主要得益于 Socket.io 提供的 ajax 解决方案(WebSocket > Long polling)。可以说,NodeBB能够吸引人的其实就是它这种十分友好,流畅的用户之间的交互。
NodeBB 的插件结构十分自由,也十分的开放。 与此同时 NodeBB 的原生系统其实十分的简陋 ,例如:缺少完善的权限系统,缺少完善的积分系统,未自带完善的社会化登录(SSO)等。
所以,我们欢迎任何热爱它的人来加入我们。但是,我们也不会解答一些作为 Node.js 开发者应该明白的常识性问题。
>[warning] 以下是熟练使用 NodeBB 必须掌握的程序:
> **Node.js** --- NodeBB 是基于 ES5 标准开发的程序。但是鉴于 Node.js 强大的模块系统,所以你完全可以使用 ES6 或者 ES2016 来开发任何新的插件。
> **MongoDB/Redis** 掌握数据库的基本操作,能够让你在初期避免发生一些奇葩的问题。
很多人一开始会拿 Discuz!/PHPWind 来和 NodeBB进行比较,在这里呢,笔者可以很负责的告诉你:想要熟练操控NodeBB的难度是这类PHP论坛的2-3倍。奉劝那些只是看着NodeBB的现代化(Modern)而入坑的童鞋量力而为。
~~由于老的社区团队已经不再维护中文社区了,所以我们创建了新的社区/团队:~~
>[info] 08.17 更新: 与老团队合作,打造新社区
* NodeBB Hot : [https://nodebb-cn.org](https://nodebb-cn.org)
- 社区 (不管你点哪个,其实都是一个站点) :
- https://community.nodebb-cn.org
- http://nodebb.org.cn
- http://nodebb.net
* NodeBB China(QQ交流群) : 392448497
* NodeBB Telegram 交流群: https://t.me/NodeBBCN
## 正在使用NodeBB的论坛
[萌梦社区](http://qtdream.com/ "萌梦社区")
[EFL Club 英语学习论坛](http://forum.eflclub.me/ "EFL Club")
[羊毛界](http://yangmaojie.com "羊毛界")
[Minecraft Lightweight](http://mc.soaryun.com/ "Minecraft Lightweight")
[Widora](http://sns.widora.io "Widora")
[intio.org](http://intio.org/ "intio.org")
[自由职业者社区](https://v2mm.tech/categories/ "v2mm")
~~**如果您也在使用NodeBB,可以在 NodeBB China 的 Github 仓库中直接提交Pull Requests来补充**~~
>[warning] 为了方便维护,向这里 **提交链接** 请在 QQ/TG 群组中联系管理员 或 在评论中提出。
## 项目贡献
>[info] ~~目前我们的文档托管在看云。我们会定期从 Github 同步到看云的仓库(每周一次)~~
> 目前文档尚未真正完成,完成后开启同步(目前:定期 看云 -> Github)
> 项目 Github 链接: https://github.com/NodeBB-China/nodebb-cn-docs
1. 遇到问题可以在Issues中/看云评论提出,同时也非常欢迎各位Fork此项目然后提交Pull Requests。
2. 如果对Git和GitHub的使用流程比较熟悉,也可以在Issues中申请加入我们Organization的Members,这样就可以无需Fork而可以直接向本项目Push内容。
3. 我们的文档分为原创和翻译。对于原创,您可以在文档中注明作者或链接。对于翻译,参与前请~~优先阅读~~[~~翻译流程约定~~](官方教程翻译/翻译流程约定.md). 约定内容已过时,近期会增加
>以上贡献规则摘自 NodeBB China 文档
## NodeBB官方链接索引
* [NodeBB GitHub](https://github.com/NodeBB/NodeBB)
* [官方论坛](https://community.nodebb.org/)
* [官方英文版文档](https://docs.nodebb.org/en/latest/)
>[info] 编写: a632079 & NodeBB China
润色: -
维护: a632079
审核: PA Team & NodeBB China
最后更新: 2017.05.30
- 序
- 赞助
- 导言
- 安装
- 通过操作系统
- Windows + Mongodb/Redis
- Ubuntu/Debian + Redis/Mongodb
- CentOS + Redis
- CentOS + Mongodb
- FreeBSD/OpenBSD + Redis
- Arch Linux + Redis
- OSX + Redis
- 通过云服务
- 通过主机面板安装
- AppNode
- CPanel
- 宝塔
- 使用
- FAQ
- 高级
- 运行 NodeBB
- 配置 Config.json
- 配置 Nginx
- 配置 MongoDB
- 更新 NodeBB
- 设置 Widgets
- 安装 Yarn
- 更新 MongoDB
- 数据库备份与恢复
- 重置管理员密码
- 让 NodeBB 支持搜索
- 优化
- 优化配置,提升NodeBB处理能力
- Google字体库 -> 360公共前端库
- Google字体库 -> 中科大镜像
- 海外VPS提升NodeBB访问速度
- 通过 NodeBB API 自动发帖
- 开发
- 准备
- 常用方法 & 变量
- 插件制作
- 使用工具包编写一个插件
- 主题制作
- 使用工具包编写一个主题
- 部件制作
- 国际化
- 钩子(hook)使用说明