如何在 Ubuntu 上安裝 XWiki

XWiki 是一種 wiki 軟件，它使任何人都可以使用 Web 瀏覽器、台式機或手機從任何可以訪問互聯網的設備創建、組織和共享信息。

它是一個成熟的社區 wiki 託管服務，具有用戶權限、角色和組。 它有公共和私人維基。 諸如 MySQL 之類的數據庫用於存儲信息。 Servlet 容器（例如，Tomcat、Jetty）用於運行它； 它支持 XHTML、所見即所得、XSL-FO、MathML、SVG 和 RSS。

XWiki 是下一代 Wiki，是市場上唯一一個在單個程序包中提供如此多功能的 Wiki。

XWiki 提供了一種可以在任何 wiki 上啟用的高級模式，允許使用基於 XSLT 的轉換規則對內容呈現進行更精細的控制。 它帶有一組默認樣式表，這些樣式表預先配置為開箱即用。 不過，可以通過使用自定義 XSLT 文件輕鬆自定義此行為，從而允許完全自由地設計您的 wiki 外觀，而無需編寫任何代碼。

在本指南中，您將學習如何在 Ubuntu 20.04 上安裝 XWiki，以及如何啟動和運行您的用戶、權限和基本功能。 雖然本指南將基於 Ubuntu 20.04，但這些說明可以應用於任何基於 Debian 的發行版。

先決條件

  • 一台運行 Ubuntu 20.04 的服務器，至少 1024 MB 內存和至少 20 GB 硬盤。
  • 從 Internet 訪問 wiki 的域名（可選）。
  • 一般的 Linux 和 Web 服務器的基本知識。
  • 對服務器的根訪問權限或 sudo 在您的服務器上安裝應用程序和管理文件和目錄的用戶權限。

更新系統

為確保滿足系統要求，您必須先更新它。 通過運行更新您的發行版的包列表：

sudo apt-get update

您應該收到以下輸出：

更新可用包列表後，運行以下命令在 Ubuntu 20.04 上安裝所有更新：

sudo apt-get upgrade -y

或者

sudo apt-get dist-upgrade -y

您應該收到以下輸出：

建議重啟您的服務器以應用任何內核升級，以便它們正確生效並避免以後在使用 XWiki 的某些模塊時出現問題，例如嚴重依賴於工作 Linux 內核版本的文檔轉換服務。

sudo reboot now

在此之後，使用相同的方式重新登錄 sudo 用戶並繼續下一步。

安裝Java

XWiki 是用 Java 編寫的，因此在繼續之前，您必須在 Ubuntu 20.04 上安裝 Java。

要在 Ubuntu 20.04 上安裝 Java，請運行以下命令：

sudo apt install default-jdk -y

您應該得到以下輸出：

安裝後，您可以使用以下命令檢查 Java 版本：

java --version

您應該得到以下輸出：

現在 Java 已正確安裝，您可以繼續下一步。

在 Ubuntu 20.04 上安裝 XWiki

默認情況下，XWiki 在 Ubuntu 20.04 存儲庫中不可用，因此您必須從 XWiki 自己的網站下載該軟件包並在您的服務器上手動安裝。

首先，確保 wget 和 curl 安裝有：

sudo apt-get -y install wget curl

使用以下命令將 GPG 密鑰添加到 apt：

wget -q "https://maven.xwiki.org/public.gpg" -O- | apt-key add -

您應該看到確認密鑰已正確添加的 OK 輸出。

使用以下命令將 XWiki 存儲庫添加到您的系統：

sudo wget "https://maven.xwiki.org/stable/xwiki-stable.list" -P /etc/apt/sources.list.d/

上面的命令會將 XWiki 穩定存儲庫添加到您的服務器。

您應該得到以下輸出：

為了易於使用新添加的存儲庫，有必要更新其緩存：

sudo apt-get update -y

在這個階段，Xwiki 在您的 Ubuntu 20.04 存儲庫中可用，您可以使用以下命令找到可用的軟件包：

sudo apt-cache search xwiki

將出現一個軟件包列表，允許您選擇要安裝的軟件包。

XWiki 需要一個外部 servlet 容器，例如 Apache Tomcat 在 Ubuntu 20.04 上運行。 在本指南中，我們將使用 tomcat 9 和 MariaDB 作為數據庫服務器安裝 xwiki-platform 包：

sudo apt install xwiki-tomcat9-common xwiki-tomcat9-mariadb -y

作為安裝過程的一部分，您需要設置一個 XWiki 數據庫，如下所示。 選擇 是的 並擊中 Enter 開始數據庫創建過程。

設置您想要的密碼，選擇 好的 並按下 Enter 當提示完成 XWiki 數據庫密碼設置時，如下所示。 請務必事後確認。

安裝完成後，您可以使用以下命令驗證 Tomcat 服務：

sudo systemctl status tomcat9.service

您應該看到以下輸出：

如您所見，tomcat 服務處於活動狀態並正在運行。

通常，Tomcat 監聽 8080 端口。您可以使用以下命令檢查它是否監聽 8080 端口：

ss -antpl | grep 8080

您應該看到以下輸出：

為 XWiki 配置 Nginx

這部分將向您展示如何為 XWiki 配置 Nginx。 Nginx 是一種非常流行且功能強大的 Web 服務器。 它可用於提供靜態內容、代理請求和輕鬆處理身份驗證等。

為了讓 Nginx 與 XWiki tomcat 應用程序通信，您需要對其進行相應配置。

要安裝 Nginx Web 服務器，請在終端提示符下鍵入以下命令：

sudo apt-get install nginx -y

安裝 Web 服務器後，使用以下名為 xwiki.conf 的命令創建一個新的 Nginx 配置文件。 xwiki.conf 是一個配置文件，必須用你自己的設置更新，它會保存在 etc 文件夾中。

sudo nano /etc/nginx/sites-available/xwiki.conf

您應該會看到一個空文件在屏幕前打開，可供編輯。

使用以下內容填充文件：

server {
  listen 80;
  server_name xwiki.example.com;
  access_log /var/log/nginx/xwiki-access.log;
  error_log /var/log/nginx/xwiki-error.log;

  location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header Host $host;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection ‘upgrade’;
    proxy_cache_bypass $http_upgrade;
    proxy_pass https://127.0.0.1:8080;
  }
}

Save 完成該文件後，使用以下命令激活新的 Nginx 配置：

sudo ln -s /etc/nginx/sites-available/xwiki.conf /etc/nginx/sites-enabled/

使用以下命令重新啟動 Nginx 以使更改生效：

sudo systemctl restart nginx

訪問 XWiki 網頁界面

現在您已經安裝並配置了 XWiki，是時候訪問 Web 界面了。 為此，請輸入您的服務器 IP 地址或域名，後跟 /xwiki。 為了 example:

  • https://xwiki.example.com/xwiki
  • https://server-ip-address/xwiki

您應該會看到如圖所示的歡迎屏幕。

點擊 繼續 按鈕。 你應該看到 admin 用戶創建頁面。

現在您需要通過填寫所有相關信息來創建您的第一個 XWiki 用戶帳戶，如下所示：

提供您的用戶名和密碼以及電子郵件，然後單擊 註冊並登錄 按鈕。 您將被帶到以下頁面：

點擊 繼續 按鈕。 您應該看到以下頁面。 選擇您要使用的口味，然後單擊 安裝這個風味 按鈕如圖所示。

安裝完成後，您應該會看到以下頁面：

要應用設置，請單擊 繼續 按鈕。 完成安裝後，您將看到以下顯示默認 XWiki 文件夾的頁面。 通過單擊繼續完成安裝 繼續.

最後，您應該看到 XWiki 默認儀表板，如下所示：

結論

在本指南中，您學習瞭如何在 Ubuntu 20.04 上安裝 Xwiki 並為其配置 Nginx。 我們希望本指南對您有所幫助。

有關 XWiki 的更多信息，請訪問 官方網站

Related Posts