Як встановити 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;
    }
}

Перевірте синтаксис: