更新时间:2022-12-18 15:56:34浏览次数:271+次
本文介绍在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
安装和配置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访问:
在里面创建管理员帐户并安装Wiki.js。安装完成后,您将被重定向到登录页面。提供管理员凭据以登录:
第一次登录时,您可以选择以下两个选项:创建主页或进入管理面板。
在这里,我们可以通过单击+创建主页来创建第一个页面:
接下来就按界面的要求配置了,整个过程不复杂:
完成后,可为Wiki.js配置SSL证书,以便能够使用https访问。