Как установить XWiki на Debian 11

В этой статье блога мы собираемся пошагово объяснить вам, как установить XWiki на Debian 11.

Мы уже рассматривали установку XWiki на Ubuntu, вы можете почитать эту статью по ссылке ниже:

Как установить XWiki на Ubuntu

XWiki — это программное обеспечение с открытым исходным кодом, написанное на Java. Это свободное программное обеспечение вики, которое работает на сервлет-машине Java. Xwiki хранит свою информацию в базе данных MySQL или PostgreSQL. Она имеет множество функций, таких как контроль версий, легкий экспорт в различные форматы, редактирование страниц, импорт контента и т.д. В этом руководстве мы собираемся настроить XWiki с Nginx в качестве обратного прокси.

Установка XWiki на Debian 11 — это несложный процесс, который может занять до 15 минут. Давайте приступим!

Необходимые условия

Сервер с Debian 11 в качестве ОС
Действительный домен, указывающий на IP-адрес сервера
Привилегии пользователя: root или не root пользователь с привилегиями sudo

Шаг 1. Обновление системы

Прежде чем приступить к установке, необходимо обновить системные пакеты до последней доступной версии:

sudo apt-get update -y && sudo apt-get upgrade -y

Шаг 2. Установите Java

Поскольку XWiki написана на Java, нам необходимо установить ее с помощью следующей команды:

sudo apt install default-jdk -y

Чтобы проверить установленную версию, выполните следующую команду:

java --version

Вы должны получить результат, подобный этому:

Шаг 3. Установите MySQL

Сначала нам нужно загрузить репозиторий MySQL, так как он не добавлен в репозиторий Debian 11.

wget http://repo.mysql.com/mysql-apt-config_0.8.24-1_all.deb

После загрузки репозитория установите пакет выпуска:

sudo apt install ./mysql-apt-config_0.8.24-1_all.deb

В последнюю очередь установите сервер MySQL с помощью следующей команды:

sudo apt update 
sudo apt install mysql-server -y

После установки запустите и включите службу:

sudo systemctl start mysql && sudo systemctl enable mysql

Чтобы проверить состояние службы MySQL, выполните следующую команду:

sudo systemctl status mysql

Вы должны получить следующий результат:

Шаг 4. Установите XWiki

Прежде чем мы сможем установить XWiki, нам нужно добавить репозиторий и ключ GPG, так как они не добавлены в репозиторий по умолчанию в Debian 11.

wget https://maven.xwiki.org/xwiki-keyring.gpg -O /usr/share/keyrings/xwiki-keyring.gpg 
wget "https://maven.xwiki.org/stable/xwiki-stable.list" -O /etc/apt/sources.list.d/xwiki-stable.list 
sudo apt-get update -y

После добавления репозитория вы можете перечислить все доступные установки с помощью следующей команды:

sudo apt search xwiki

Выходные данные будут выглядеть примерно так:

Мы собираемся установить xwiki-tomcat9-mysql/stable версии 15.2 с помощью следующей команды:

sudo apt install xwiki-tomcat9-mysql -y

Во время установки появится несколько окон с информацией. В первом окне нажмите Да. Это нужно для подтверждения MySQL.

Во втором окне необходимо ввести пароль пользователя MySQL для установки XWiki.

Третий шаг — подтверждение пароля.

В последнем окне необходимо установить пароль для административного пользователя «root» для XWiki.

Шаг 5. Установите веб-сервер Nginx

Поскольку мы будем настраивать обратный прокси для доступа к XWiki через доменное имя, нам необходимо сначала установить веб-сервер Nginx.

sudo apt-get install nginx -y

После установки запустите и включите службу:

sudo systemctl start nginx && sudo systemctl enable nginx

Чтобы проверить состояние службы Nginx, выполните следующую команду:

sudo systemctl status nginx

Вы должны получить следующий результат:

Шаг 6. Создание обратного прокси-сервера

Чтобы создать конфигурационный файл Nginx и настроить обратный прокси, чтобы вы могли получить доступ к нему через доменное имя.

Перейдите в каталог Nginx и создайте конфигурационный файл для XWiki.

cd /etc/nginx/conf.d/ 
touch xwiki.conf

Откройте файл, вставьте следующие строки кода, сохраните файл и закройте его.

server {
    listen       80;
    server_name  YourDomainName;
    charset utf-8;
    client_max_body_size 64M;
 
    root /var/www/html;

    location /
    {
        rewrite ^ $scheme://$server_name/xwiki$request_uri? permanent;
    }
 
    location ^~ /xwiki
    {
       proxy_pass              http://127.0.0.1:8080;
       proxy_cache             off;
       proxy_set_header        X-Real-IP $remote_addr;
       proxy_set_header        X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header        Host $host;
       proxy_set_header        X-Forwarded-Proto $scheme;
       expires                 $expires;
    }
}

Проверьте синтаксис: