搭建Wiki.js的过程

zerobiubiu 2022年05月03日 114次浏览

Wiki.js官网自称最为强大的和可扩展的开源Wiki软件
可以采用多种方式编写Wiki,支持常用的markdown、HTML等

ℹ️ 序

为了让我写的文档能够方便的访问和查看,之前用docsify生成的静态页面,放在GitHub pages托管,现在感觉结构太缺乏,不是很能满足现在的需求(心理需求),决定还是切换到Wiki.js了

设备:云服务器1核2G
系统:Debian10.10
数据库:MySQL8.0

🆕 安装

崩溃了,快写完了,保存测试,数据丢了,内容只剩这儿了😭
2022年5月4日12点48分,重写

进到官网,右上角点Get Started按钮,选择2.x Setup Instructions,就能看到官方的安装教程,根据系统选择就好。

Wiki.js支持 MySQL, MariaDB, PostgreSQL, MSSQL、SQLite3数据库
官方教程用到的是SQLite3,但是我用的MySQL。
MySQL数据库的配置可以看这篇

下载官方包,wget,curl都可以。

wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
curl https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz

提取内容

mkdir wiki
tar xzf wiki-js.tar.gz -C ./wiki
cd ./wiki

内置一个配置模板,拿来用就好

mv config.sample.yml config.yml

更改配置文件:用编辑器打开,我习惯VIM

vim config.yml

进去只需要注意几个关键配置,其他的不需要在意。

  1. port:这是服务器启动的端口
  2. db:
    1. type:数据库类型,我用的MySQL,可自行选择,
    2. host:服务器的地址,本机的话127.0.0.1或者localhost
    3. port:数据库的端口,MySQL默认3306
    4. user:数据库用户,没什么注意的话就填root
    5. pass:数据库用户密码
    6. db:数据库名,一定要提前创建好,不然启动会出错。

      创建数据库的命令CREATE DATABASE 数据库名;

⏯ 启动

Wiki.js是基于Node.js开发的,启动要用到 Node.js10.12 以上,推荐用最新的LTS版本就好,v16LTS可以启动,但是v18启动会报错。

Node.js安装、版本管理可以通过NVM工具,NVM的操作可以看我的Wiki-NVM

做好上边的配置就可以启动了,启动命令

node server

出现这个界面就代表成功了,访问你的IP加你设置的端口就可以访问了

但是,启动后会占用掉终端,尤其是SSH连接欸,一旦断开服务器就停止运行了,所以要采取办法让他在后台保持运行

nohup,将程序以忽略挂起信号的方式运行起来

nohub node server &

服务器就会在后台运行,同时将执行日志输出到nohup.out的文件中,除非另外指定了输出文件

nohup node server > your_out.file 2>&1 &

当我们不想用的时候,可以杀掉程序进程

  1. 查看进程:
    ps -ef | grep "node server"
    
  2. 杀死进程
    kill -9 查看进程查到的pid
    

至此,安装结束