所有文章

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

最后修改

calendar-icon

作者

阅读时间

read-time-icon 9 min read

浏览量

view-count-icon

摘要: 作者因需知识管理,认为 Wiki.js 挺合适。介绍其为开源项目,优势多、功能全。还详述利用宝塔面板、PostgreSQL 数据库安装部署 Wiki.js 的流程,包括源代码下载、数据库与 Nodejs 安装、文件配置等,以及使用指南如语言包设置、时区设置等,希望能帮到他人并记录过程。

⏬提前下载

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

唠叨

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

个人wiki来管理个人知识库相比于evernote来管理有哪些优势劣势?

  • 个人维基百科的重要的好处就是:可以按照个性化的理解和需求进行编辑,而不担心被别人修改。这个个人维基可以作为自己的外挂大脑使用,但是不要成为一个垃圾筐,什么都往里装,扔进去就再也不看了,这样放的多了之后,就会越多越乱EVERNOTE就很容易陷入这个窘境因此个人的WIKI需要进行结构化的整理,形成自己的系统。

  • 看了网上的很多部署教程,对小白来说门槛还是很高,我还是做一期偏小白的教程吧,搭配宝塔面板的可视化操作,很耐思~

WikiJs介绍

632ffb2995d9e.webp

官网:https://js.wiki

Githu:https://github.com/Requarks/wiki

官方文档:https://docs.requarks.io


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

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

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

优点

1672145756-49e8216c60c27fdf95824fb7a616f148.webp 1672145757-90ba81595fd2c008f98e91012cf08a30.webp

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

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

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

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

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

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

部分功能截图展示

自定义导航栏

1672145758-bddfe6efd30baae2a04c4e2fbf355997.webp

文档编辑历史

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

1672145758-0bda97ee1c8b508083f3378c8ead7682.webp

网站分析

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

1672145758-c937996ec972cf34ebb70ba9510763a3.webp

主题设置

持暗黑模式,晚上看文档更护眼

1672145758-1b7c372b7df53eb4c1534014320e5a9d.webp

团队人员管理

适合团队协作,多人账号权限管理

1672145758-a0f555f8957ba66371308f2b2578d7ee.webp

储存管理

1672145759-cb92c8fed73fbf51f95e92b9206979f2.webp

搜索引擎管理

1672145760-4484fc08471aa597698bcd04b49f8265.webp

部署流程思维导图

这篇文章就来分享一下利用宝塔面板PostgreSQL数据库来安装与部署Wiki.js

1672145761-80a24525f76be80bcef3983bf7eb75b7.webp

我的安装环境

系统:centOs8.2 64bit(宝塔面板)

wikijs版本:v2.5289

数据库版本PostgreSQL

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

1672145761-64f359e7f9de23525de41da1c9be6f90.webp 1672145761-fe61452b107e8b71314efe4109efa4e9.webp 所以我就用PostgreSQL来部署Wiki.js

源代码下载

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

1672145762-0d18d9efc01c55cbfc111f61d61ae038.webp

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

1672145762-d3b10a925fc04ded59f1bf5b1bfa3a69.webp

我下载的最新版本V2.5.289(2022年9月25日),随着时间的推移,其他版本不保证能成功。如有必要,请务必跟我保持一致的版本号。

1672145762-caad9ddb8087c5336a27200aeed9c477.webp 贴心如我,我直接帮你们下载好了

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

点击下载官方源代码

安装PostgreSQL数据库

安装PostgreSQL管理器

1672145763-4fcdaa7967d33cded74e29753ec4644b.webp

安装14.2版本

1672145763-bf4f60726b7ac03705fa4ca37968f089.webp

添加数据库

1672145764-fbde969405eb3d2a9e724eca05f55aad.webp

安装Nodejs

node.js版本管理器

1672145764-10bb0375e4431b3f433035b84927cb1d.webp

我装的是1.7Stable

1672145765-6931ab289c9f4c279ca3f2ff24eb31f4.webp

选择node.js稳定版v14.17.6

1672145765-5d56e18ef7443dd62061ea2b4dfbb870.webp

划重点!!!

1672145766-a749b90b4466c7132a5f4e6ed815cea6.webp 安装完毕以后,一定要在这里选择v14.7.6,然后就可以全局使用nodejs了!!

配置.yml文件

打开.yml文件

1672145766-c1da3ec8a84d5df835f6eb075ee81ed8.webp

重命名.yml文件

1672145767-034b759a51bff06f2f45c75ca7573cae.webp

配置.yml文件

参考下图填写

1672145767-4f316d9352e4b2b52a870514e809de4b.webp

输入完毕保存即可

运行wikijs服务

运行wikijs

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

node server

1672145768-52b2ceec8baf1d2a0b087d31792f5317.webp

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

域名解析

(腾讯云dnspod为例,其他厂商同理)

1672145769-32f63f586615d00d346ccb2245a88d0f.webp

新建网站

新建网站

1672145769-630089009d9f69feedbbe781d24fe468.webp

目录改为wikijs的目录

申请SSL证书

1672145770-8d25b8b72747491f3ea4407f786771b1.webp

配置反向代理

1672145770-87633eb28e21e1796fcd07d07c555d33.webp

温馨提示:

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

开放服务器端口

宝塔面板

1672145771-346e8da54a97d04354a3b933a94b234a.webp

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

腾讯云

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

1672145771-ed0e512b3485b1d4544b5e1d31c05317.webp

安装插件

安装supervision管理器

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

1672145772-8cf908d49ac521b58588faf60d28ec6a.webp

添加守护程序

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

1672145772-dd6d602900099d179d2d3e3acb604e68.webp

✅安装完毕

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

1672145772-910904176fa5da3625f78b0ec7d91ad0.webp 1672145773-ef5200da0c0678d7368497641e049a4a.webp

使用指南

中文语言包设置

1672145774-b185bacbc47c5ba9fe96860b59174ebb.webp

下载简体中文语言包

1672145774-29448fa606f1ab49b87c5dbde27b1a11.webp

应用语言包

1672145775-852b9e5f9cae394001888c33dafbcc8f.webp

变成中文啦!✌️

1672145776-a0a4cdfb24015d6ec9ea3e80afe7fd96.webp

时区设置

1672762144-CleanShot-2023-01-04-at-00.04.19@2x的副本-scaled.webp

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

结语

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

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

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

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

完结撒花🎉,让文档成为写作的乐趣吧!

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