Skip to content
Java陈序员Java陈序员
首页
开源项目open in new window
github icon
  • JavaScript
    • TypeScript 快速上⼿
      • 基于 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
                      上次编辑于: 2025/7/20 11:21:37
                      贡献者: chenyl8848
                      上一页
                      TypeScript 快速上⼿
                      没有最好,只有更好!
                      Copyright © 2025 Java陈序员