Wiki.js-Ubuntu-安装指南_ubuntu wiki.js 搭建

介绍

在Ubuntu 18.04 / 20.04 / 22.04 LTS上安装Wiki.js

完整的A到Z指南

概述

本指南是一个完整详细的指南，用于在全新的Ubuntu 18.04/20.04/22.04 LTS机器上安装运行Wiki.js所需的所有内容。

在本指南结束时，您将拥有一个完全可用的Wiki.js实例，包括以下组件：

Docker
PostgreSQL 15（docker化）
Wiki.js 2.x（docker化，通过端口80可访问）
Wiki.js更新伴侣（docker化）
预配置了SSH、HTTP和HTTPS的OpenSSH和UFW防火墙

安装步骤

更新机器

首先，让我们确保机器是最新的。

# Fetch latest updates
sudo apt -qqy update
 
# Install all updates automatically
sudo DEBIAN_FRONTEND=noninteractive apt-get -qqy -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' dist-upgrade

安装Docker

# Install dependencies to install Docker
sudo apt -qqy -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' install ca-certificates curl gnupg lsb-release
 
# Register Docker package registry
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
 
# Refresh package udpates and install Docker
sudo apt -qqy update
sudo apt -qqy -o Dpkg::Options::='--force-confdef' -o Dpkg::Options::='--force-confold' install docker-ce docker-ce-cli containerd.io docker-compose-plugin

设置容器

# Create installation directory for Wiki.js
mkdir -p /etc/wiki
 
# Generate DB secret
openssl rand -base64 32 > /etc/wiki/.db-secret
 
# Create internal docker network
docker network create wikinet
 
# Create data volume for PostgreSQL
docker volume create pgdata
 
# Create the containers
docker create --name=db -e POSTGRES_DB=wiki -e POSTGRES_USER=wiki -e POSTGRES_PASSWORD_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -v pgdata:/var/lib/postgresql/data --restart=unless-stopped -h db --network=wikinet postgres:15
docker create --name=wiki -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 ghcr.io/requarks/wiki:2
docker create --name=wiki-update-companion -v /var/run/docker.sock:/var/run/docker.sock:ro --restart=unless-stopped -h wiki-update-companion --network=wikinet ghcr.io/requarks/wiki-update-companion:latest

设置防火墙

sudo ufw allow ssh
sudo ufw allow http
sudo ufw allow https
 
sudo ufw --force enable

启动容器

docker start db
docker start wiki
docker start wiki-update-companion

访问设置向导

在您的浏览器上，请导航到您的服务器IP / 域名（例如，http://your-server-ip/）。

如果您无法加载页面，请等待5分钟后再试。在一些系统上，容器初始化可能需要几分钟时间。

 自动启用 Let's Encrypt 的 HTTPS（可选）

在启用 Let's Encrypt 之前，您必须完成设置向导（请参见入门指南）。

• 在您的域名注册商上创建一个A记录，将域名/子域名（例如wiki.example.com）指向您的服务器的公共IP地址。
• 确保您能够使用该域名/子域名通过HTTP（例如http://wiki.example.com）加载您的wiki。
• 通过SSH连接到您的服务器。
• 通过运行下面的命令停止并删除现有的wiki容器（不会丢失任何数据）：

docker stop wiki
docker rm wiki

• 请使用您自己的域名/子域名以及维基管理员的电子邮件地址，替换以下命令中的wiki.example.com和admin@example.com的值，并运行该命令：

docker create --name=wiki -e LETSENCRYPT_DOMAIN=wiki.example.com -e LETSENCRYPT_EMAIL=admin@example.com -e SSL_ACTIVE=1 -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 ghcr.io/requarks/wiki:2

• 通过运行以下命令启动容器：

docker start wiki

• 等待容器启动和Let's Encrypt授权过程完成。您可以通过运行以下命令来选择性地查看容器日志：

docker logs wiki

一旦你在日志中看到以下行，过程就会完成：

(LETSENCRYPT) New certifiate received successfully: [ COMPLETED ]
HTTPS Server on port: [ 3443 ]
HTTPS Server: [ RUNNING ]

•  使用HTTPS在Web浏览器中加载您的维基（例如https://wiki.example.com）。您的维基现在使用免费的Let's Encrypt证书接受HTTPS请求！

自动将HTTP重定向到HTTPS

默认情况下，对HTTP端口的请求不会被重定向到HTTPS。您可以按照以下说明启用此选项：

• 点击页面右上角的头像，进入管理区域。
• 在左侧导航菜单中，点击SSL。
• 在"将HTTP请求重定向到HTTPS"部分的旁边，点击"打开"以启用HTTP到HTTPS的重定向。
• 现在，任何对HTTP端口的请求都会自动重定向到HTTPS！

更新证书

您可以随时从管理区域 > SSL更新证书。

如果您的证书已过期，并且无法加载wiki UI以进行更新，请简单地重新启动容器：

docker restart wiki

续订过程将在初始化期间自动运行。

升级

在安装指南中，您安装了Wiki.js更新助手。当有新版本可用时，此功能可以自动进行升级过程。

当有新版本可用时，您将在管理区域收到通知。要执行升级，请按照以下简单说明进行操作：

转到系统信息部分，然后点击执行升级按钮。
等待进程完成。
现在您应该已经使用最新版本。就是这么简单！