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

fclyn 发布于 2025-05-06 20 次阅读


唠叨

  • 最近吸收了太多知识,无处安放,所以需要wiki作为知识管理。我用过为知笔记、印象笔记evernote、思源笔记、Joplin、Obsidian、Logseq、notion、语雀。。。。感觉都不太合适系统化思维,所以wiki.js是首选。
  • 看了网上的很多部署教程,对小白来说门槛还是很高,我还是做一期偏小白的教程吧,搭配宝塔面板的可视化操作,很耐思~

WikiJs介绍

v2-b3f02dbcbe29c69a222749fcc454e268_1440w

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

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

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

优点

v2-a8e9cab018a3988dd2014667390deb8d_1440wv2-18daa0e4d9c8e9366c2d18b1bc06cac8_1440w

随时随地安装

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

⚙️ 管理强大

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

性能

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

✍ 定制

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

隐私保护

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

可伸缩

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

项目展示

官网

Github

官方文档

部分功能截图展示

自定义导航栏

v2-95c8fe087a34027785c542b08aa5d1fc_1440w

文档编辑历史

v2-f0f38de860971539de7a398944ccabf2_1440w

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

网站分析

v2-7b52529b88552124b402a4f537a329ac_1440w

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

主题设置

v2-10c52b1d42b74e79f0eccc9823605c82_1440w

支持暗黑模式

团队人员管理

v2-6b6d8995de94254b02e8c9788520a23c_1440w

适合团队协作

储存管理

v2-9c5023455d550043fb22f69b6ec2ef77_1440w

搜索引擎管理

v2-583ed3d4bec44e9893df778cc18c9a47_1440w

⭕️Wikijs部署流程思维导图

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

v2-292e716b4f0a918ded9f8b551f6ed1b2_1440w

⭕️我的安装环境

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

wikijs版本:v2.5289

数据库版本:PostgreSQL

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

v2-7702f1b75494d2dc041a61f3a185af68_1440wv2-ca97896274514b14039cfeb754a16759_1440w

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

⬇️源代码下载

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

v2-bd7e9cd5eba4fd7f0b7093425aba3a24_1440w

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

v2-3d2552f77fc20fcd23e7c062e3b53e66_1440w

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

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

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

⬇️安装PostgreSQL数据库

v2-28536250433684b5ae43a4e35aaa640e_1440w

安装14.2版本v2-067fb7c0579f1691e1416d6c49f34460_1440w

添加数据库

v2-702c9ea2d618662e1c719a8dc984d584_1440w

⬇️安装Nodejs

宝塔面板安装node.js版本管理器

v2-bd4abe6d8cf210e69dc7d2625fd8619a_1440w

我装的是1.7Stable

v2-407846fb544eecaaac9716efa2eee758_1440w

选择node.js稳定版v14.17.6v2-e362ac3f1eb98a05018f2e33c3fb7a4f_1440w

划重点!!!

v2-e9eb1603d1f91746382834f1d741102c_1440w

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

⚙️配置.yml文件

重命名.yml文件

v2-f1c8f14bbad76fd127874bb02715ec32_1440w

打开.yml文件

v2-4b1c735698fde3b924f7031448697108_1440w

配置.yml文件

v2-369bad65cf9c046fff6083ba7b5d54f9_1440w

运行wikijs服务

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

node server

v2-d5c8195f048ddede6673297cdf778a2a_1440w

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

域名解析(腾讯云dnspod为例,其他厂商同理)

v2-2c9707617f9fb431599627089928414a_1440w

新建网站

v2-4429915f09ce6ebe7d1e02863e79e9c6_1440w

申请SSL证书

v2-ed71a155da790addb840f8d222242dfb_1440w

配置反向代理

v2-80c2850ff8e2aa2e8d0f67ee38a17c11_1440w

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

开放服务器端口

宝塔面板

v2-edf4affa08c1b77638f8e9d70ada0ca7_1440w

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

腾讯云

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

v2-cb3483b15a58590930fa29b7b8986a93_1440w

安装插件

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

v2-a0b05e0c60e09ca498fa1bcfa9dfe016_1440w

添加守护程序

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

v2-4e46f7d8d5ba7028fc61c8d88ff51920_1440w

✅安装完毕

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

v2-4e8d8e3465e2cbf57e81dd4d8e76b0ed_1440wv2-db87ade751c7526d4ffca3e0389d5f62_1440w

使用指南

中文语言包设置

v2-db1f9921c3e7eb1beb391912c4afe585_1440w

下载简体中文语言包

v2-ef83d4e9ef3ab41bdc3d07952160719a_1440w

应用语言包

v2-dcb04aaf060a856108a69c6110b6346f_1440w

选择中文,然后点击保存

v2-35f227aa8d7bab377abcccd2facde9f9_1440w

变成中文啦!✌️

时区设置

v2-4780708a970bca733e1759c32ee02bf3_1440w

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

结语

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

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

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

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

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

此作者没有提供个人介绍。
最后更新于 2025-05-06