在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

本文介绍在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js的方法。前提条件是系统中必须安装有Git、Node.js、MariaDB。Git可以用sudo apt install git安装,Node.js可以用curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -和sudo apt-get install -y nodejs安装,MariaDB可以参考在Ubuntu 22.04上安装MariaDB的方法

下载Wiki.js

为了增强安全性,我们将首先为Wiki.js创建一个专用用户和Node.js进程。

可以使用以下命令创建用户:

sudo adduser wikijs

为wiki.js创建文件夹源代码:

sudo mkdir -p /var/www/wikijs

创建的用户将拥有源代码文件夹:

sudo chown wikijs:wikijs /var/www/wikijs

现在切换到创建的用户并下载最新的Wiki.js源代码:

sudo su - wikijs

cd /var/www/wikijs

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

下载完成后,提取存档:

tar xzf wiki-js.tar.gz

rm wiki-js.tar.gz

配置Wiki.js

wiki.js配置文件将从示例配置文件创建,如下所示:

cp config.sample.yml config.yml

现在对创建的配置文件进行所需的调整:

vim config.yml

要容纳创建的MariaDB数据库,请对文件进行以下更改:

db:

  type: mariadb

  # PostgreSQL / MySQL / MariaDB / MS SQL Server only:

  host: localhost

  port: 3306

  user: wikidb_user

  pass: Passw0rd

  db: wikidb

  ssl: false

.....

# Leave 0.0.0.0 for all interfaces

bindIP: 127.0.0.1

请记住替换正确的数据库凭据。此外,出于安全原因,将绑定IP更改为127.0.0.1,因为我们将使用Nginx作为反向代理。

设置完成后,请验证服务器是否正常运行:

node server

会返回一些成功的输出信息。

使用CTRL+C停止正在运行的服务器。同时切换回上一个sudo用户并重新开始安装:

exit

为Wiki.js创建系统服务

让我们能够管理wiki.js服务,我们需要创建一个systemd服务文件。

sudo vim /etc/systemd/system/wikijs.service

文件将包含以下行:

[Unit]

Description=Wiki.js

After=network.target

[Service]

Type=simple

ExecStart=/usr/bin/node server

Restart=always

User=wikijs

Environment=NODE_ENV=production

WorkingDirectory=/var/www/wikijs

[Install]

WantedBy=multi-user.target

保存文件并重新加载系统守护程序:

sudo systemctl daemon-reload

启动并启用wiki.js服务:

sudo systemctl start wikijs

sudo systemctl enable wikijs

检查服务状态:

$ systemctl status wikijs

在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

安装和配置Nginx

在本文中,我们将使用高性能Nginx服务器进行反向代理。使用以下命令安装Nginx:

sudo apt install nginx

为Wiki.js创建虚拟主机文件:

sudo vim /etc/nginx/conf.d/wikijs.conf

文件将包含以下行:

server {

  listen 80;

  server_name  wiki.example.com;

  root   /var/www/wikijs;

  # Pass requests to the Wiki.js service listening on 127.0.0.1:3000

  location / {

    proxy_pass          http://127.0.0.1:3000;

    proxy_http_version  1.1;

    proxy_set_header    Upgrade $http_upgrade;

    proxy_set_header    Connection "upgrade";

    proxy_set_header    Host $host;

    proxy_set_header    X-Real-IP $remote_addr;

    proxy_set_header    X-Forwarded-For $proxy_add_x_forwarded_for;

    proxy_set_header    X-Forwarded-Proto $scheme;

  }

}

检查文件的语法:

$ sudo nginx -t

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

nginx: configuration file /etc/nginx/nginx.conf test is successful

重新启动并启用Nginx:

sudo systemctl restart nginx

sudo systemctl enable nginx

完成以上配置后就可以访问wiki.js Web UI了。

访问wiki.js Web UI并完成wiki.js安装

可用地址格式为http://IP_address或http://domain_name访问:

在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

在里面创建管理员帐户并安装Wiki.js。安装完成后,您将被重定向到登录页面。提供管理员凭据以登录:

在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

第一次登录时,您可以选择以下两个选项:创建主页或进入管理面板。

在这里,我们可以通过单击+创建主页来创建第一个页面:

在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

接下来就按界面的要求配置了,整个过程不复杂:

在Ubuntu 22.04上下载安装Wiki.js和配置Wiki.js

完成后,可为Wiki.js配置SSL证书,以便能够使用https访问。

栏目相关文章