Skip to content
Java陈序员Java陈序员
首页
开源项目open in new window
github icon
  • Wiki.js
    • 基于 Wiki.js 搭建知识库系统
      • 前言
        • 安装
          • 前提准备
            • Node 安装
              • PostgreSQL 安装
                • Wiki.js 安装
                • 使用
                  • 配置管理员
                    • 配置中文
                      • 创建页面

                    基于 Wiki.js 搭建知识库系统

                    author iconJava陈序员原创💡calendar icon2022年6月1日category icon
                    • Wiki.js
                    tag icon
                    • 知识库
                    timer icon大约 3 分钟

                    此页内容
                    • 前言
                    • 安装
                      • 前提准备
                      • Node 安装
                      • PostgreSQL 安装
                      • Wiki.js 安装
                    • 使用
                      • 配置管理员
                      • 配置中文
                      • 创建页面

                    # 基于 Wiki.js 搭建知识库系统

                    # 前言

                    本文介绍如何使用 Wiki.js 搭建知识库系统。

                    Wiki.js 官网open in new window

                    # 安装

                    # 前提准备

                    Wiki.js 几乎可以在任何支持 Node.js 的系统上运行。它可以运行在 Linux 、Windows、macOS等操作系统上,也可以运行在 Docker 、Kubernetes 等容器上。

                    • CPU 推荐 2核或者更多
                    • 内存 至少 1G
                    • 存储 至少 1G
                    • 数据库 推荐使用 PostgreSQL,MySQL/MariaDB/MS SQL Server/SQLite 也支持使用

                    # Node 安装

                    Node.js 中文网open in new window

                    1. 下载

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

                      tar -xf node-v16.15.0-linux-x64.tar.xz 
                      
                      1
                    3. 换名

                      mv node-v16.15.0-linux-x64/ node
                      
                      1
                    4. 建立软连接

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

                      也可以使用配置环境变量的方式

                    5. 查看版本

                       node -v
                      
                      1

                    # PostgreSQL 安装

                    PostgreSQL 官网open in new window

                    1. 安装

                      yum install postgresql-server
                      
                      1
                    2. 初始化数据库

                      cd /usr/bin/
                      
                      1
                      ./postgresql-setup initdb
                      
                      1
                    3. 加入 systemctl 服务设置开机自启动

                      systemctl enable postgresql.service
                      
                      1
                    4. 启动

                      systemctl start postgresql.service
                      
                      1
                    5. 进入客户端命令

                      sudo -u postgres plsql
                      
                      1
                    6. 修改密码

                      ALTER USER postgres WITH PASSWORD 'postgres';
                      
                      1
                    7. 数据存储

                      PostgreSQL 存储文件、配置文件默认在 /var/lib/pgsql/data/ 下

                    8. 开启远程访问权限

                      编辑配置文件 postgresql.conf

                      vim postgresql.conf 
                      
                      1

                      修改配置文件中的监听地址

                      listen_addresses = '*'  
                      
                      1

                      在配置文件同级目录下有个文件 pg_hba.conf 最后面添加

                      host     all             postgres        0.0.0.0/0               trust
                      
                      1

                      重启 postgresql 服务

                      systemctl restart postgresql.service
                      
                      1

                      用 Navicat 成功连接

                      image-20220601100137277

                    9. 客户端操作命令

                      进入客户端

                      sudo -u postgres plsql
                      
                      1

                      查看数据库

                      \l
                      
                      1

                      新建数据库

                      create database wiki;
                      
                      1

                      退出客户端

                      \q
                      
                      1

                    # Wiki.js 安装

                    1. 下载

                      wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
                      
                      1
                    2. 解压缩

                      mkdir wiki
                      tar xzf wiki-js.tar.gz -C ./wiki
                      cd ./wiki
                      
                      1
                      2
                      3
                    3. 修改配置文件

                      配置文件改名

                      mv config.sample.yml config.yml
                      
                      1

                      配置数据库信息(注意:数据库要先创建)

                      db:
                        type: postgres
                      
                        # PostgreSQL / MySQL / MariaDB / MS SQL Server only:
                        host: localhost
                        port: 5432
                        user: postgres
                        pass: 123456
                        db: wiki
                        ssl: false
                      
                      1
                      2
                      3
                      4
                      5
                      6
                      7
                      8
                      9
                      10
                    4. 启动服务

                      在 wiki 目录下

                      node server
                      
                      1
                    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
                      
                      1
                      2
                      3
                      4
                      5
                      6
                      7
                      8
                      9
                      10
                      11
                      12
                      13
                      14
                      15

                      重新加载

                      systemctl daemon-reload
                      
                      1
                    6. 设置开机自启动

                      systemctl enable wiki
                      
                      1
                    7. 启动服务

                      systemctl start wiki
                      
                      1
                    8. 查看服务状态

                      systemctl status wiki
                      
                      1

                      如果没有启动成功,可通过如下命令查看日志信息

                      journalctl -u wiki
                      
                      1

                    # 使用

                    # 配置管理员

                    Wiki.js 服务成功启动后,访问 http://ip:3000,出现如下页面:

                    image-20220531164034350

                    配置管理员邮箱地址,密码,网站地址,后进行安装,稍等一会,就会出现如下页面:

                    image-20220601090432609

                    # 配置中文

                    Wiki.js 默认使用英语,可配置中文,方便操作。

                    1. 首先选择 后台管理

                      image-20220601102257106

                    2. 安装中文简体 image-20220601090536579

                    3. 切换到中文简体 image-20220601090632689

                    # 创建页面

                    1. 选择 创建主页

                      image-20220601102542863

                    2. Wiki.js 支持多种方式的编辑器,可以自行选择,有的还未开放 image-20220601090719054

                    3. 效果展示

                      image-20220601102850608

                    edit icon编辑此页open in new window
                    上次编辑于: 2022/6/1 上午10:51:40
                    贡献者: cyl
                    上一页
                    Wiki.js
                    没有最好,只有更好!
                    Copyright © 2024 Java陈序员