基于 Wiki.js 搭建知识库系统
前言
本文介绍如何使用 Wiki.js 搭建知识库系统。
安装
前提准备
Wiki.js 几乎可以在任何支持 Node.js 的系统上运行。它可以运行在 Linux 、Windows、macOS等操作系统上,也可以运行在 Docker 、Kubernetes 等容器上。
-
CPU 推荐 2核或者更多
-
内存 至少 1G
-
存储 至少 1G
-
数据库 推荐使用 PostgreSQL,MySQL/MariaDB/MS SQL Server/SQLite 也支持使用
Node 安装
-
下载
wget https://npmmirror.com/mirrors/node/v16.15.0/node-v16.15.0-linux-x64.tar.xz
-
解压
tar -xf node-v16.15.0-linux-x64.tar.xz
-
换名
mv node-v16.15.0-linux-x64/ node
-
建立软连接
ln -s /data/software/node/bin/node /usr/local/bin/
也可以使用配置环境变量的方式
-
查看版本
node -v
PostgreSQL 安装
-
安装
yum install postgresql-server
-
初始化数据库
cd /usr/bin/
./postgresql-setup initdb
-
加入 systemctl 服务设置开机自启动
systemctl enable postgresql.service
-
启动
systemctl start postgresql.service
-
进入客户端命令
sudo -u postgres plsql
-
修改密码
ALTER USER postgres WITH PASSWORD 'postgres';
-
数据存储
PostgreSQL 存储文件、配置文件默认在
/var/lib/pgsql/data/
下 -
开启远程访问权限
编辑配置文件
postgresql.conf
vim postgresql.conf
修改配置文件中的监听地址
listen_addresses = '*'
在配置文件同级目录下有个文件
pg_hba.conf
最后面添加host all postgres 0.0.0.0/0 trust
重启 postgresql 服务
systemctl restart postgresql.service
用 Navicat 成功连接
-
客户端操作命令
进入客户端
sudo -u postgres plsql
查看数据库
\l
新建数据库
create database wiki;
退出客户端
\q
Wiki.js 安装
-
下载
wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
-
解压缩
mkdir wiki
tar xzf wiki-js.tar.gz -C ./wiki
cd ./wiki -
修改配置文件
配置文件改名
mv config.sample.yml config.yml
配置数据库信息(注意:数据库要先创建)
db:
type: postgres
# PostgreSQL / MySQL / MariaDB / MS SQL Server only:
host: localhost
port: 5432
user: postgres
pass: 123456
db: wiki
ssl: false -
启动服务
在 wiki 目录下
node server
-
加入 systemctl 服务
在
/etc/systemd/system/
下新建wiki.service
文件[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/local/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/data/software/wiki # 这个要指定你 wiki 的安装地址
[Install]
WantedBy=multi-user.target重新加载
systemctl daemon-reload
-
设置开机自启动
systemctl enable wiki
-
启动服务
systemctl start wiki
-
查看服务状态
systemctl status wiki
如果没有启动成功,可通过如下命令查看日志信息
journalctl -u wiki
使用
配置管理员
Wiki.js 服务成功启动后,访问 http://ip:3000,出现如下页面:
配置管理员邮箱地址,密码,网站地址,后进行安装,稍等一会,就会出现如下页面:
配置中文
Wiki.js 默认使用英语,可配置中文,方便操作。
-
首先选择 后台管理
-
安装中文简体
-
切换到中文简体
创建页面
-
选择 创建主页
-
Wiki.js 支持多种方式的编辑器,可以自行选择,有的还未开放
-
效果展示
-