进阶 docs.nodebb.org 2026-10-13 15:07:09 · 38 阅读

第20章 PostgreSQL 数据库配置指南:在 NodeBB 中启用 PostgreSQL 作为数据存储

使用 PostgreSQL 作为数据存储

NodeBB 支持 PostgreSQL 作为主数据库。在运行 NodeBB 的安装程序之前,需要先创建好数据库和登录角色;数据表及其他数据库对象会在安装过程中由 NodeBB 自动创建。

第 1 步:安装并准备 PostgreSQL

按照官方 PostgreSQL 下载页面上对应你操作系统的说明安装 PostgreSQL。

为 NodeBB 创建一个登录角色,并创建一个属于该角色的数据库。例如,在本地安装中,postgres 操作系统用户可以打开 psql:

sudo -u postgres psql

然后执行:

CREATE ROLE nodebb WITH LOGIN; \password nodebb CREATE DATABASE nodebb OWNER nodebb; \q

\password 提示时请输入一个唯一的强密码。这样可以避免把密码直接写进 SQL 命令,从而防止密码出现在命令历史或服务器日志中。同时不要把密码提交到版本控制系统。打开 psql 的方式因操作系统和 PostgreSQL 安装方式而异,其他环境和选项请参考 psql、CREATE ROLE 和 CREATE DATABASE 的官方文档。

第 2 步:配置 NodeBB

运行 NodeBB 的安装命令:

./nodebb setup

根据提示选择 postgres 作为数据存储,然后输入:

  • PostgreSQL 主机地址(默认:127.0.0.1);
  • PostgreSQL 端口(默认:5432);
  • 登录角色名和密码;
  • 数据库名(默认:nodebb);
  • 连接是否需要 SSL。

最终 config.json 中的数据库配置大致如下:

{ "database": "postgres", "postgres": { "host": "127.0.0.1", "port": 5432, "username": "nodebb", "password": "replace-with-a-strong-password", "database": "nodebb", "ssl": false } }

请根据你的 PostgreSQL 服务器实际情况调整主机、端口、凭据、数据库名和 SSL 设置。

评论 (0)