基于 Wiki.js 搭建知識庫系統

前言

本文介紹如何使用 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 安裝

Node.js 中文網

1. 下載

   wget https://npmmirror.com/mirrors/node/v16.15.0/node-v16.15.0-linux-x64.tar.xz
   

2. 解壓

   tar -xf node-v16.15.0-linux-x64.tar.xz 
   

3. 換名

   mv node-v16.15.0-linux-x64/ node
   

4. 建立軟連接

   ln -s /data/software/node/bin/node /usr/local/bin/
   

   也可以使用配置環境變量的方式

5. 查看版本

    node -v
   

PostgreSQL 安裝

PostgreSQL 官網

1. 安裝

   yum install postgresql-server
   

2. 初始化數據庫

   cd /usr/bin/
   

   ./postgresql-setup initdb
   

3. 加入 systemctl 服務設置開機自啟動

   systemctl enable postgresql.service
   

4. 啟動

   systemctl start postgresql.service
   

5. 進入客戶端命令

   sudo -u postgres plsql
   

6. 修改密碼

   ALTER USER postgres WITH PASSWORD 'postgres';
   

7. 數據存儲

   PostgreSQL 存儲文件、配置文件默認在 /var/lib/pgsql/data/ 下

8. 開啟遠程訪問權限

   編輯配置文件 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 成功連接

   image-20220601100137277.png

9. 客戶端操作命令

   進入客戶端

   sudo -u postgres plsql
   

   查看數據庫

   \l
   

   新建數據庫

   create database wiki;
   

   退出客戶端

   \q
   

Wiki.js 安裝

1. 下載

   wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
   

2. 解壓縮

   mkdir wiki
   tar xzf wiki-js.tar.gz -C ./wiki
   cd ./wiki
   

3. 修改配置文件

   配置文件改名

   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
   

4. 啟動服務

   在 wiki 目錄下

   node server
   

5. 加入 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
   

6. 設置開機自啟動

   systemctl enable wiki
   

7. 啟動服務

   systemctl start wiki
   

8. 查看服務狀態

   systemctl status wiki
   

   如果沒有啟動成功，可通過如下命令查看日志信息

   journalctl -u wiki
   

使用

配置管理員

Wiki.js 服務成功啟動后，訪問 http://ip:3000，出現如下頁面：

image-20220531164034350.png

配置管理員郵箱地址，密碼，網站地址，后進行安裝，稍等一會，就會出現如下頁面：

image-20220601090432609.png

配置中文

Wiki.js 默認使用英語，可配置中文，方便操作。

1. 首先選擇 后臺管理

   
   
   image-20220601102257106.png

2. 安裝中文簡體

   
   
   image-20220601090536579.png

3. 切換到中文簡體

   
   
   image-20220601090632689.png

創建頁面

1. 選擇 創建主頁

   image-20220601102542863.png

2. Wiki.js 支持多種方式的編輯器，可以自行選擇，有的還未開放

   
   
   image-20220601090719054.png

3. 效果展示

   image-20220601102850608.png