本页内容
- 先决条件
- 第 1 步 - 配置防火墙
- 第 2 步 - 安装 PostgreSQL 和实用工具
- 第 3 步 - 配置 PostgreSQL
- 第 4 步 - 安装 Node.js
- 第 5 步 - 下载 Wiki.js
- 第 6 步 - 配置并运行 Wiki.js
- 第 7 步 - 设置 Systemd 服务
- 第 8 步 - 安装 Nginx
- 第 9 步 - 安装 SSL
- 第 10 步 - 配置 SELinux
- 第 11 步 - 配置 Nginx
- 第 12 步 - 完成安装
- 结论
Wiki.js 是一款开源、轻量级的 wiki 软件。它基于 Node.js JavaScript 框架构建。它可用于编写文档、wiki 以及网页内容,开发人员可使用 Markdown 编辑器,非技术人员可使用 WYSIWYG 编辑器。它支持多种内容类型,包括 UML 图表、使用 Tex 或 MathML 语法的数学表达式以及代码。它包含用于多种功能的模块,包括分析、身份验证、日志记录、第三方搜索引擎,以及多个用于将你的内容同步到的存储服务。
在本教程中,你将学习如何在 Rocky Linux 9 服务器上使用 PostgreSQL 数据库和 Nginx 服务器作为代理来安装 Wiki.js。
先决条件
- 一台运行 Rocky Linux 9 的服务器。
- 一个具有 sudo 权限的非 root 用户。
- 一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 wiki.example.com 作为域名。
- 确保一切已更新。sudo dnf update
- 安装基本实用工具包。其中部分可能已安装。sudo dnf install wget curl nano unzip yum-utils -y
一台运行 Rocky Linux 9 的服务器。
一个具有 sudo 权限的非 root 用户。
一个指向你服务器的完全限定域名(FQDN)。在本教程中,我们将使用 wiki.example.com 作为域名。
确保一切已更新。
$ sudo dnf update
安装基本实用工具包。其中部分可能已安装。
$ sudo dnf install wget curl nano unzip yum-utils -y
第 1 步 - 配置防火墙
第一步是配置防火墙。Rocky Linux 使用 Firewalld 防火墙。检查防火墙的状态。
$ sudo firewall-cmd --state
running
防火墙按不同的区域工作,public 区域是我们将使用的默认区域。列出防火墙上所有处于激活状态的服务和端口。
$ sudo firewall-cmd --permanent --list-services
它应显示如下输出。
cockpit dhcpv6-client ssh
Wiki.js 需要 HTTP 和 HTTPS 端口才能运行。将它们开放。
$ sudo firewall-cmd --add-service=http --permanent
$ sudo firewall-cmd --add-service=https --permanent
重新加载防火墙以应用更改。
$ sudo firewall-cmd --reload
第 2 步 - 安装 PostgreSQL 和实用工具
Rocky Linux 9 自带较旧版本的 PostgreSQL。在本教程中我们将安装 Postgres 14。
为 PostgreSQL 安装仓库 RPM。
$ sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-9-x86_64/pgdg-redhat-repo-latest.noarch.rpm
安装 PostgreSQL 14 服务器。
$ sudo dnf install -y postgresql14-server postgresql14-contrib
初始化数据库。
$ sudo /usr/pgsql-14/bin/postgresql-14-setup initdb
启用并启动 PostgreSQL 服务。
$ sudo systemctl enable postgresql-14 --now
检查该服务的状态。
$ sudo systemctl status postgresql-14
? postgresql-14.service - PostgreSQL 14 database server
Loaded: loaded (/usr/lib/systemd/system/postgresql-14.service; enabled; vendor preset: disabled)
Active: active (running) since Sat 2022-10-22 09:52:41 UTC; 2s ago
Docs: https://www.postgresql.org/docs/14/static/
Process: 103857 ExecStartPre=/usr/pgsql-14/bin/postgresql-14-check-db-dir ${PGDATA} (code=exited, status=0/SUCCESS)
Main PID: 103862 (postmaster)
Tasks: 8 (limit: 5915)
Memory: 16.6M
CPU: 61ms
CGroup: /system.slice/postgresql-14.service
??103862 /usr/pgsql-14/bin/postmaster -D /var/lib/pgsql/14/data/
??103863 "postgres: logger "
??103865 "postgres: checkpointer "
??103866 "postgres: background writer "
??103867 "postgres: walwriter "
??103868 "postgres: autovacuum launcher "
??103869 "postgres: stats collector "
??103870 "postgres: logical replication launcher "
Oct 22 09:52:41 wiki.example.com systemd[1]: Starting PostgreSQL 14 database server...
第 3 步 - 配置 PostgreSQL
登录到 PostgreSQL shell。
$ sudo -i -u postgres psql
为 Wiki.js 创建一个新的数据库。
postgres=# CREATE DATABASE wikidb;
创建一个带有强密码的新数据库用户。
postgres=# CREATE USER wikiuser WITH ENCRYPTED PASSWORD 'wikipassword';
授予该用户使用该数据库的权限。
postgres=# GRANT ALL PRIVILEGES ON DATABASE wikidb TO wikiuser;
退出 Postgres Shell。
postgres=# \q
第 4 步 - 安装 Node.js
在撰写本教程时,Wiki.js 支持 Node v16。
使用以下命令安装 Node 仓库。
$ curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
安装 Node。
$ sudo dnf install nodejs -y
验证 Node 安装。
$ node --version
v16.18.0
第 5 步 - 下载 Wiki.js
创建一个文件夹来安装 Wiki.js。
$ sudo mkdir -p /var/www/wikijs
将当前登录的用户设为该文件夹的所有者。
$ sudo chown $USER:$USER /var/www/wikijs
切换到该目录并下载 Wiki.js 代码压缩包。
$ cd /var/www/wikijs && wget https://github.com/Requarks/wiki/releases/latest/download/wiki-js.tar.gz
解压下载的压缩包。
$ tar xzf wiki-js.tar.gz
第 6 步 - 配置并运行 Wiki.js
根据示例创建配置文件。
$ cp config.sample.yml config.yml
打开配置文件进行编辑。
$ nano config.yml
找到以下数据库设置,并将其值更新为第 3 步中配置的值。
# PostgreSQL / MySQL / MariaDB / MS SQL Server only:
host: localhost
port: 5432
user: wikiuser
pass: wikipassword
db: wikidb
ssl: false
找到 bindIP: 0.0.0.0 这一行,并按如下方式更新它。
bindIP: 127.0.0.1
这将使 Wiki.js 监听回环地址,因为我们将使用 Nginx 代理从外部访问它。
按 Ctrl + X 保存文件,并在提示时输入 Y。
使用以下命令运行 Wiki.js。
$ node server
你将收到类似的输出,确认安装成功。
2022-10-22T10:25:48.187Z [MASTER] info: =======================================
2022-10-22T10:25:48.190Z [MASTER] info: = Wiki.js 2.5.289 =====================
2022-10-22T10:25:48.191Z [MASTER] info: =======================================
2022-10-22T10:25:48.191Z [MASTER] info: Initializing...
2022-10-22T10:25:49.079Z [MASTER] info: Using database driver pg for postgres [ OK ]
2022-10-22T10:25:49.086Z [MASTER] info: Connecting to database...
2022-10-22T10:25:49.117Z [MASTER] info: Database Connection Successful [ OK ]
2022-10-22T10:25:49.467Z [MASTER] warn: DB Configuration is empty or incomplete. Switching to Setup mode...
2022-10-22T10:25:49.468Z [MASTER] info: Starting setup wizard...
2022-10-22T10:25:49.740Z [MASTER] info: Starting HTTP server on port 3000...
2022-10-22T10:25:49.741Z [MASTER] info: HTTP Server on port: [ 3000 ]
2022-10-22T10:25:49.745Z [MASTER] info: HTTP Server: [ RUNNING ]
2022-10-22T10:25:49.745Z [MASTER] info: .......................................
2022-10-22T10:25:49.745Z [MASTER] info:
2022-10-22T10:25:49.746Z [MASTER] info: Browse to http://YOUR-SERVER-IP:3000/ to complete setup!
按 Ctrl + C 停止该进程。
第 7 步 - 设置 Systemd 服务
上述保持 Wiki.js 运行的方式是临时的。为了使该进程持久化,我们需要为 Wiki.js 创建一个 systemd 服务,将其作为后台服务运行。这将允许 Wiki.js 在系统重启后继续运行。
为 Wiki.js 创建一个 systemd 服务文件并打开它进行编辑。
$ sudo nano /etc/systemd/system/wikijs.service
在其中粘贴以下代码。将变量 User 的值替换为你的系统用户名。
[Unit]
Description=Wiki.js
After=network.target
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
User=navjot
Environment=NODE_ENV=production
WorkingDirectory=/var/www/wikijs
[Install]
WantedBy=multi-user.target
按 Ctrl + X 保存文件,并在提示时输入 Y。
重新加载 system 守护进程。
$ sudo systemctl daemon-reload
启用 Wiki.js 服务。
$ sudo systemctl enable wikijs
第 8 步 - 安装 Nginx
Rocky Linux 自带较旧版本的 Nginx。你需要下载官方 Nginx 仓库来安装最新版本。
创建并打开 /etc/yum.repos.d/nginx.repo 文件以创建官方 Nginx 仓库。
$ sudo nano /etc/yum.repos.d/nginx.repo
在其中粘贴以下代码。
[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true
[nginx-mainline]
name=nginx mainline repo
baseurl=http://nginx.org/packages/mainline/centos/$releasever/$basearch/
gpgcheck=1
enabled=0
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true
按 Ctrl + X 保存文件,并在提示时输入 Y。
安装 Nginx 服务器。
$ sudo dnf install nginx -y
验证安装。
$ nginx -v
nginx version: nginx/1.22.1
启用并启动 Nginx 服务器。
$ sudo systemctl enable nginx --now
检查服务器的状态。
$ sudo systemctl status nginx
? nginx.service - nginx - high performance web server
Loaded: loaded (/usr/lib/systemd/system/nginx.service; enabled; vendor preset: disabled)
Active: active (running) since Sat 2022-10-22 11:15:39 UTC; 49min ago
Docs: http://nginx.org/en/docs/
Process: 116236 ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf (code=exited, status=0/SUCCESS)
Main PID: 116237 (nginx)
Tasks: 2 (limit: 5915)
Memory: 5.0M
CPU: 245ms
CGroup: /system.slice/nginx.service
??116237 "nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf"
??116238 "nginx: worker process"
Oct 22 11:15:39 wiki.example.com systemd[1]: Starting nginx - high performance web server...
第 9 步 - 安装 SSL
我们将使用 Certbot 工具配合 Snapd 工具来签发 SSL 证书。它需要 EPEL 仓库才能工作。
$ sudo dnf install epel-release
我们将使用 Snapd 安装 Certbot。安装 Snapd。
$ sudo dnf install snapd
启用并启动 Snap 服务。
$ sudo systemctl enable snapd.socket --now
为 Snapd 创建必要的链接。
$ sudo ln -s /var/lib/snapd/snap /snap
$ echo 'export PATH=$PATH:/var/lib/snapd/snap/bin' | sudo tee -a /etc/profile.d/snapd.sh
安装核心 Snapd 仓库。
$ sudo snap install core
$ sudo snap refresh core
安装 Certbot。
$ sudo snap install --classic certbot
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot
生成证书。以下命令还将自动配置 Nginx。
$ sudo certbot certonly --nginx --agree-tos --no-eff-email --staple-ocsp --preferred-challenges http -m
[email protected]
-d wiki.example.com
上述命令会将证书下载到你服务器上的 /etc/letsencrypt/live/wiki.example.com 目录。
生成 Diffie-Hellman 组证书。
$ sudo openssl dhparam -dsaparam -out /etc/ssl/certs/dhparam.pem 4096
对该流程进行一次空运行,以检查 SSL 续期是否正常工作。
$ sudo certbot renew --dry-run
如果你没有看到任何错误,说明一切就绪。你的证书将自动续期。
第 10 步 - 配置 SELinux
运行以下命令,为 Wiki.js 目录应用正确的 SELinux 上下文。
$ sudo semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/wikijs(/.*)?"
$ sudo restorecon -Rv /var/www/wikijs
为 HTTP 创建一个端口并将其分配给 3000,以使 Wiki.js 能够配合 SELinux 工作。
$ sudo semanage port -a -t http_port_t -p tcp 3000
允许 Nginx 连接到网络。
$ sudo setsebool -P httpd_can_network_connect 1
第 11 步 - 配置 Nginx
创建并打开文件 /etc/nginx/conf.d/wikijs.conf 进行编辑。
$ sudo nano /etc/nginx/conf.d/wikijs.conf
在其中粘贴以下代码。
# enforce HTTPS
server {
listen 80;
listen [::]:80;
server_name wiki.example.com;
return 301 https://$server_name$request_uri;
}
server {
listen 443 ssl http2;
listen [::]:443 ssl http2;
server_name wiki.example.com;
root /var/www/wikijs;
access_log /var/log/nginx/wiki.access.log;
error_log /var/log/nginx/wiki.error.log;
http2_push_preload on; # Enable HTTP/2 Server Push
ssl_certificate /etc/letsencrypt/live/wiki.example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/wiki.example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/wiki.example.com/chain.pem;
ssl_session_timeout 1d;
# Enable TLS versions (TLSv1.3 is required upcoming HTTP/3 QUIC).
ssl_protocols TLSv1.2 TLSv1.3;
# Enable TLSv1.3's 0-RTT. Use $ssl_early_data when reverse proxying to
# prevent replay attacks.
#
# @see: https://nginx.org/en/docs/http/ngx_http_ssl_module.html#ssl_early_data
ssl_early_data on;
ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384';
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:50m;
# OCSP Stapling ---
# fetch OCSP records from URL in ssl_certificate and cache them
ssl_stapling on;
ssl_stapling_verify on;
ssl_dhparam /etc/ssl/certs/dhparam.pem;
add_header X-Early-Data $tls1_3_early_data;
location / {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $http_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;
proxy_pass http://127.0.0.1:3000;
}
}
# This block is useful for debugging TLS v1.3. Please feel free to remove this
# and use the `$ssl_early_data` variable exposed by NGINX directly should you
# wish to do so.
map $ssl_early_data $tls1_3_early_data {
"~." $ssl_early_data;
default "";
}
将上述文件中的 root 位置替换为你服务器上的目录。
按 Ctrl + X 保存文件,并在提示时输入 Y。
打开文件 /etc/nginx/nginx.conf 进行编辑。
$ sudo nano /etc/nginx/nginx.conf
在 include /etc/nginx/conf.d/*.conf; 这一行之前添加以下行。
server_names_hash_bucket_size 64;
按 Ctrl + X 保存文件,并在提示时输入 Y。
验证你的 Nginx 配置。
$ sudo nginx -t
如果你没有看到任何错误,说明一切就绪。
启动 Wiki.js 服务。
$ sudo systemctl start wikijs
重新加载 Nginx 服务器。
$ sudo systemctl reload nginx
第 12 步 - 完成安装
访问 URL https://wiki.example.com 以完成安装。

填写你的管理员账户详情和 URL。取消勾选“允许遥测”选项以禁用遥测。你也可以从管理面板中禁用它。点击“安装”按钮继续。
你将被带到登录页面。

输入你的账户详情并点击“登录”按钮,进入管理页面。

你现在可以开始使用 Wiki.js 了。
结论
本教程到此结束,你已学习如何在 Rocky Linux 9 服务器上安装 Wiki.js。如果你有任何问题,请在下方评论中留言。