代 代码
2.9K 浏览

【保姆级教程】Wiki.js （私有知识库）部署安装教程【无须懂代码全程可视化】

pipu
2022年12月18日
30 评论
  1. ⏬提前下载
  2. 唠叨
    1. 个人wiki来管理个人知识库相比于evernote（印象笔记）来管理有哪些优势劣势？
  3. WikiJs介绍
    1. 优点
    2. 项目展示
      1. 部分功能截图展示
  4. ⭕️部署流程思维导图
  5. ⭕️我的安装环境
  6. ⬇️源代码下载
  7. ⬇️安装PostgreSQL数据库
    1. 安装PostgreSQL管理器
    2. 添加数据库
  8. ⬇️安装Nodejs
    1. node.js版本管理器
    2. 划重点！！！
  9. ⚙️配置.yml文件
    1. 打开.yml文件
    2. 重命名.yml文件
    3. 配置.yml文件
  10. 运行wikijs服务
    1. 运行wikijs
    2. 域名解析
  11. 新建网站
    1. 新建网站
    2. 申请SSL证书
    3. 配置反向代理
  12. 开放服务器端口
    1. 宝塔面板
    2. 腾讯云
  13. 安装插件
    1. 安装supervision管理器
    2. 添加守护程序
  14. ✅安装完毕
  15. 使用指南
    1. 中文语言包设置
    2. 时区设置
  16. 结语

⏬提前下载

请部署之前，提前下载好源代码： 点击下载官方源代码

唠叨

  • 最近吸收了太多知识，无处安放，所以需要wiki作为知识管理。我用过为知笔记、印象笔记evernote、思源笔记、Joplin、Obsidian、Logseq、notion、语雀。。。。感觉都不太合适系统化思维，所以wiki.js是首选。

个人wiki来管理个人知识库相比于evernote（印象笔记）来管理有哪些优势劣势？

  • 个人维基百科的重要的好处就是：可以按照个性化的理解和需求进行编辑，而不担心被别人修改。这个个人维基可以作为自己的外挂大脑使用，但是不要成为一个垃圾筐，什么都往里装，扔进去就再也不看了，这样放的多了之后，就会越多越乱EVERNOTE就很容易陷入这个窘境因此个人的WIKI需要进行结构化的整理，形成自己的系统。
  • 看了网上的很多部署教程，对小白来说门槛还是很高，我还是做一期偏小白的教程吧，搭配宝塔面板的可视化操作，很耐思～

WikiJs介绍

v2-ee2b730384ea5ec8cb4da9fc2a912b1a_r

有不少的朋友喜欢玩wiki，这是一种在网络上开放且可供多人协同创作的超文本系统，可以有多人（甚至任何访问者)维护内容，每个人都可以发表自己的意见，或者对共同的主题进行扩展与探讨。简单地说就是有点类似于XX百科，小团队共同维护页面内容。

Wiki.js是一个基于NodeJS技术的开源项目，其界面简洁美观、权限管理灵活，支持多种编辑器、多种用户验证方式、多种备份存储方式、多种搜索引擎，支持国际化、自定义主题(Theme)、流量分析等，特别适合做小团队的知识库，一方面适合管理和阅读，另一方面还能协同创作。

用到的技术栈也不同于老旧的 wiki 系统，它采用了 Node.js、PostgreSQL、Vue.js、Docker 等技术，颇有 WordPress 之风，不要太爽！

优点

image-20220925120153308
image-20220925120258668

随时随地安装：几乎适用于任何平台，并与PostgreSQL、MySQL、MariaDB、MS SQL Server 或 SQLite 兼容！

管理强大：使用广泛而直观的管理区域管理维基的所有方面。

性能：Wiki.js运行在快速的Node.js引擎上，它是基于性能考虑而构建的。

定制：完全自定义您的维基的外观，包括一个浅色和深色的模式。

隐私保护：让你的维基公开，完全私人或两者的混合。

可伸缩：无论是在一个小树莓派或在云中的高性能虚拟机上，Wiki.js 智能地利用可用资源。

项目展示

官网

Github

官方文档

部分功能截图展示

自定义导航栏

image-20220925020454593

文档编辑历史

image-20220925140857761

这里可以清晰地看到谁在什么时间，修改了哪些内容

网站分析

image-20220925020303846

看到这里集合了Motomo，非常贴心

主题设置

image-20220925140753069

支持暗黑模式

团队人员管理

image-20220925020343778

适合团队协作

储存管理

image-20220925020322472

搜索引擎管理

image-20220925020411741

⭕️部署流程思维导图

这篇文章就来分享一下利用宝塔面板和PostgreSQL数据库来安装与部署Wiki.js Wikijs部署流程思维导图

⭕️我的安装环境

系统：centOs8.2 64bit（宝塔面板）

wikijs版本：v2.5.300

数据库版本：PostgreSQL

官方推荐的数据库是PostgreSQL，作者说3.0版本只支持PostgreSQL

image-20220925122338534
image-20220925122319235

所以我就用PostgreSQL来部署Wiki.js

⬇️源代码下载

在宝塔面板新建一个命名为”wikijs“的文件夹

image-20220924150836508

把下载的文件上传到刚新建的wikijs的目录，并且解压

image-20220924151046486

我下载的最新版本V2.5.300（2023年10月16日），随着时间的推移，其他版本不保证能成功。如有必要，请务必跟我保持一致的版本号。

image-20220925005422287

贴心如我，我直接帮你们下载好了

点击此处下载 v2.5.300 版本的Github源代码

点击下载

⬇️安装PostgreSQL数据库

安装PostgreSQL管理器

image-20220925120857419

安装14.2版本

image-20220925120923583

添加数据库

未标题-1

⬇️安装Nodejs

node.js版本管理器

image-20220925011620417

我装的是1.7Stable

image-20220925011656973

选择node.js稳定版v14.17.6

image-20220925011733335

划重点！！！

image-20220925012606955

安装完毕以后，一定要在这里选择v14.7.6，然后就可以全局使用nodejs了！！

⚙️配置.yml文件

打开.yml文件

image-20220925121331215

重命名.yml文件

未标题-1

配置.yml文件

参考下图填写

632ff1d5b3562输入完毕保存即可

运行wikijs服务

运行wikijs

在wikijs的文件目录，打开终端输入

node server
image-20220924155109957

看到Browse to（你的ip地址+端口）就说明运行成功了，接下来解析一下域名就可以了

域名解析

（腾讯云dnspod为例，其他厂商同理）

image-20220924160618079

新建网站

新建网站

image-20220924160104997

目录改为wikijs的目录

申请SSL证书

image-20220924162307890

配置反向代理

image-20220924162419862

温馨提示：如果你的.yml文件的默认端口3000没改，那么这里的目标url就写：http://localhost:3000

开放服务器端口

宝塔面板

image-20220924161459776

如果你的.yml文件的默认端口3000没改，那么端口就填3000

腾讯云

宝塔面板设置完了以后，记得还要去服务器开放一下端口哦（腾讯云为例）

image-20220924161616222

安装插件

安装supervision管理器

为了让wikijs长期不间断运行和ssl配置，需要去宝塔面板安装一下supervision管理器

image-20220924161738898

添加守护程序

有的时候，程序跑着跑着就崩了，怎么办？我们可以用宝塔面板的Supervisor管理器来进行进程守护。

image-20220924162009387

✅安装完毕

浏览器输入你的域名，就可以进行安装啦！

image-20220924162828532
image-20220925164737769

使用指南

中文语言包设置

image-20220925013238125

下载简体中文语言包

image-20220925013456493

应用语言包

image-20220925013536069

变成中文啦！✌️

image-20220925013614827

时区设置


点击右上角我的信息进入配置界面

image-20220925114648779

我们国家所属时区是东八区，所以直接滑到GMT+8:00，选择Beijing，最后点右上角保存即可

结语

万万没想到这个过程如此艰难！整整花了半个月时间，对于小白门槛确实有点高！

经过这一次，发现自己也学会了看官方文档

这篇文章，记录了我安装wikijs的整个过程，一边安装一边写

希望能帮到有需要的朋友，同时也给自己做个记录。

完结撒花，让文档成为写作的乐趣吧！

如果本文有看不懂的地方，您可以在下面留言，我看到会回复您的

评论 30

  1. 感谢博主，已成功部署。中间也遇到一些问题，比如不开启反向代理时访问站点显示403 forbidden，开启后显示502 Bad Gateway。针对第一个问题，可能是站点与根目录没有链接上，我的解决方法是删掉站点（别删数据库等文件），然后重新创建站点并选择对应的运行目录（也可参考这个https://blog.csdn.net/sinat_41870148/article/details/126742614）。第二个问题的话，在确保你设置了服务器的安全组放行与宝塔的安全的端口，可能是在反代的时候没有强制指定SSL协议，导致SSL握手失败，可参考官方解释进行修改（https://www.bt.cn/bbs/thread-105466-1-1.html）。望与博主一样能帮到遇到同样问题的朋友。

    回复

    1. Hi，你可以在管理后台，点击右上角进入设置、左边有一个Theme (主题)，你可以使用css自定义你的样式。

      回复

  3. 背景：您好我们是一家新成立不久的公司，现在打算使用wiki js搭建自己的公司自己的wiki，大概样式和这个网站差不多，https://wiki.bambulab.com/en/home
    我们看了相关的教程觉得配置太麻烦了，想问下您是否提供企业安装wiki js的服务。只需要把wiki js搭建好就可以。

    回复

  5. 您好，非常感谢您的分享，我现在的问题是只有打开终端输入node server后，网站才能打开，关闭终端后就找不到页面，我搜到有人说可以用nohup命令，但我没找到具体怎么用？请问博主知道该如何解决吗？谢谢

    回复

  6. 请问，数据如何备份，我怕服务器挂了，之前的数据就毁于一旦了~~~

    回复

  8. 博主好，请问部署后，wikijs有版本更新，后台没点击更新按钮，如何在线更新呀？

    回复

  9. 您好，请问我们学校用的是plesk，和宝塔差不多，但是没有终端，这样可以运行wiki.js吗

    回复

  10. 博主你好，wiki.js能够去自定义一些功能吗，比如标签查询是只能通过点击选择然后查找，但是公司使用的话文章会很多，导致标签也会很多，有没有什么办法能够直接筛选标签的呀

    回复

  11. 博主你好，文档对我帮助很大，请问如何在网站底部进行ICP备案号的插入呢？

    回复

        1. 因不知道你具体用哪个主题和博客系统，我无法给你回答抱歉，建议你可以自行搜索一下，相信你会找到你想要的答案。

          回复

  12. 这么详细的文档，怎么没有人评论赞一赞呢?，我也尝试搭建看看，不知道是不是适合应用到公司内部的知识库系统搭建

    回复

    1. 之前有很多评论，最近因为我换了博客系统，评论无办法迁移过来。可以作为个人或者公司内部知识库的搭建的，wikijs 本来就是应用于个人或者公司知识库搭建，作为公司使用，只要你在后台新建好账号，分配好权限即可，可以看到哪位同事什么时间修改了文档等等，很方便。

      回复

      1. 博主你好，wiki.js能够去自定义一些功能吗，比如标签查询是只能通过点击选择然后查找，但是公司使用的话文章会很多，导致标签也会很多，有没有什么办法能够直接筛选标签的呀

        回复

      2. 博主你好，请问wiki能够在检索文章标签的时候不需要通过点击左侧标签列表来达到检索的目的吗，因为文章过多导致标签也越来越多，连个筛选都没有，感觉太麻烦了

        回复

          1. 博主，那再问一下，wiki.js这个项目可以自己定制化吗，比如我需要自己设置一些页面或者新增一部分功能，我看wiki的页面展示都找不到对应的前端代码

回复 Dean 取消回复

您的电子邮箱地址不会被公开。 必填项已用 * 标注

这些同样精彩