CentOS 安装 Wiki.js

一、概要

1. 环境

(1) CentOS 7.9 2009

(2) Node.js 16

(3) Wiki.js 2.5.297

2. 概念

Wiki.js是一个开源的知识管理系统，它是一款使用JS编写的Node.js项目，它的文档类型支持Markdown语法，支持将多种编辑方式，可生成PDF、MD文档等。

(1) 优点：

a. 画面美观；

b. 安装和配置比较简单；

c. 支持Markdown格式；

(2) 缺点：

a. 默认页面略显冗余；

b. 相较于Confluence，功能较少，比如不支持表格拖拽改变大小；

3. 准备

(1) 创建目录

sudo mkdir -p /opt/Wiki
sudo mkdir -p /var/Wiki/data

(2) 创建组和用户

sudo groupadd --system wikijs
sudo useradd -s /sbin/nologin --system -g wikijs wikijs

(3) 授权

sudo chown -R wikijs:wikijs /opt/Wiki
sudo chown -R wikijs:wikijs /var/Wiki/data

(4) 证书

cd /opt/Wiki
openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout wikijs.pem -out wikijs.pem

二、安装与配置

1. 安装

(1) 获取wiki.js

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

(2) 解压

sudo tar xzf wiki-js.tar.gz -C /opt/Wiki

2. MySQL

(1) 登录MySQL

mysql -u root -p

(2) 创建用户

CREATE USER 'wikijs'@'%' IDENTIFIED BY 'MyNewPass1!';
GRANT ALL PRIVILEGES ON *.* TO 'wiki'@'%' WITH GRANT OPTION;
flush privileges;

(3) 创建数据库

create database if not exists wiki default character set UTF8MB4;

3. 配置文件

(1) 创建配置文件

sudo mv /opt/Wiki/config.sample.yml /opt/Wiki/config.yml

(2) 数据库配置

db:
  type: mysql
  host: localhost
  port: 3306
  user: wikijs
  pass: MyNewPass1!
  db: wiki

(3) Cache目录，用于存放临时文件

dataPath: /var/Wiki/data

(4) SSL

ssl:
  enabled: true
  port: 3443
  provider: custom
  format: pem
  key: /etc/pki/CA/private/wikijs.key.pem
  cert: /etc/pki/CA/certs/wikijs.crt.pem
  dhparam: /etc/pki/CA/dhparam.pem
  domain: wiki.example.com
  subscriberEmail: admin@example.com

3. 防火墙

sudo firewall-cmd --list-all
sudo firewall-cmd --permanent --add-port=3443/tcp
sudo firewall-cmd --permanent --add-port=3000/tcp
sudo firewall-cmd --reload

4. Service

(1) 创建配置文件

sudo vi /etc/systemd/system/wiki.service

(2) 初始化以下内容

[Unit]
Description=Wiki.js
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/opt/Wiki

[Install]
WantedBy=multi-user.target

(3) 重新加载systemd

sudo systemctl daemon-reload

(4) 启动

sudo systemctl start wiki
sudo systemctl enable wiki
systemctl status wiki

a. 务必需要确认wiki是运行状态的状态；

b. 启动之后会弹出提示如下：

三、系统配置

1. 浏览http://<域名或IP地址>:3000

输入管理员邮箱、密码和Wiki.js网站域名，点击"INSTALL"系统将进行初始化工作(包括创建相关的数据库表)。

2. 设置LDAP

(1) 首先找到左侧的Modules-->Authentication模块；

 

(2) 点击"ADD STRATEGY"下拉按钮，选中其中的LDAP/Active Directory选项；

(3) 配置"LDAP URL", "Admin Bind DN", "Admin Bind Credential", "Search Base", "Search Filter";

四、参考

1. 官方

https://docs.requarks.io/

2. 其他

https://www.howtoforge.com/how-to-install-wikijs-on-rocky-linux-9/

https://computingforgeeks.com/install-wiki-js-on-centos-rhel-7/