Просмотр кода страницы RAMBA Wiki Migration 1.43

__TOC__

<div class="portal-header">
<div style="font-size:2em; font-weight:700;">🚀 Миграция RAMBA Wiki на MediaWiki 1.43</div>
<div style="margin-top:8px; opacity:.85;">
Переезд RAMBA Wiki со старого TurnKey Linux / MediaWiki 1.39 на новую инфраструктуру Debian 12 и MediaWiki 1.43 LTS.
</div>
</div>

{{DISPLAYTITLE:Миграция RAMBA Wiki на MediaWiki 1.43}}

== Общая информация ==

В сентябре 2026 года была выполнена полная миграция '''RAMBA Wiki''' на новую платформу.

Основной задачей было заменить устаревшую установку MediaWiki, сохранив:

* все существующие статьи;
* историю изменений;
* пользователей и права доступа;
* загруженные изображения;
* оформление Wiki;
* мобильную версию;
* необходимые расширения;
* собственное расширение '''RambaGameMonitor''';
* существующий публичный адрес '''wiki.ramba-art.ru'''.

Миграция выполнялась по схеме '''parallel migration''': старая Wiki продолжала существовать во время подготовки новой системы и использовалась как аварийный вариант возврата.

После полного тестирования трафик был переключён на новую Wiki, а старая система была сохранена в Proxmox Backup Server и удалена из рабочей инфраструктуры.

== Исходная система ==

До миграции RAMBA Wiki работала в контейнере Proxmox:

{| class="wikitable"
! Параметр
! Значение
|-
| Proxmox CT
| '''115'''
|-
| Имя
| '''WiKi'''
|-
| Дистрибутив
| TurnKey MediaWiki 17.1 / Debian 11 Bullseye
|-
| MediaWiki
| '''1.39.2 LTS'''
|-
| PHP
| 7.4
|-
| MariaDB
| 10.5
|-
| Web-сервер
| Apache 2.4
|-
| IP
| 192.168.1.11
|-
| RAM
| 512 MB
|-
| CPU
| 1 vCPU
|-
| Диск
| 8 GB
|}

MediaWiki 1.39 к моменту миграции уже являлась устаревшей веткой, поэтому было принято решение не обновлять существующий TurnKey-контейнер на месте, а построить новую систему.

== Новая архитектура ==

Для новой RAMBA Wiki был создан отдельный LXC-контейнер:

{| class="wikitable"
! Параметр
! Значение
|-
| Proxmox CT
| '''102'''
|-
| Имя
| '''wiki-v2'''
|-
| ОС
| Debian 12 Bookworm
|-
| MediaWiki
| '''1.43.9 LTS'''
|-
| PHP
| 8.2
|-
| MariaDB
| 10.11
|-
| Web-сервер
| Apache 2.4
|-
| IP
| '''192.168.1.79'''
|-
| RAM
| 2048 MB
|-
| Swap
| 512 MB
|-
| CPU
| 2 vCPU
|-
| RootFS
| 16 GB
|-
| Storage
| OMV-SSD1
|}

Система работает как unprivileged LXC-контейнер.

== Схема работы ==

Публичный HTTPS завершается на reverse proxy BrainyCP.

<syntaxhighlight lang="text">
Internet
   │
   │ HTTPS :443
   ▼
wiki.ramba-art.ru
   │
   ▼
BrainyCP / nginx
CT 105
192.168.1.12
   │
   │ HTTP :80
   ▼
RAMBA Wiki
CT 102 — wiki-v2
192.168.1.79
   │
   ├── Apache
   ├── PHP 8.2
   ├── MediaWiki 1.43
   └── MariaDB 10.11
</syntaxhighlight>

TLS-сертификат обслуживается reverse proxy.

Сам MediaWiki-контейнер не требует собственного HTTPS-сервера.

== Создание нового контейнера ==

Новая Wiki была развёрнута на чистом Debian 12.

Основные установленные компоненты:

<syntaxhighlight lang="bash">
apache2
mariadb-server
imagemagick

php8.2
libapache2-mod-php8.2
php8.2-mysql
php8.2-intl
php8.2-mbstring
php8.2-xml
php8.2-curl
php8.2-gd
php8.2-zip
php8.2-apcu
</syntaxhighlight>

Для Apache были активированы необходимые модули:

<syntaxhighlight lang="bash">
a2enmod rewrite
a2enmod headers
a2enmod expires
</syntaxhighlight>

Основная директория MediaWiki:

<syntaxhighlight lang="text">
/var/www/mediawiki
</syntaxhighlight>

== Перенос базы данных ==

База данных старой Wiki была экспортирована из CT 115 и импортирована в MariaDB нового CT 102.

После импорта был выполнен штатный процесс обновления схемы базы данных MediaWiki.

<syntaxhighlight lang="bash">
cd /var/www/mediawiki
runuser -u www-data -- php maintenance/run.php update
</syntaxhighlight>

Обновление схемы прошло успешно.

В результате были сохранены:

* статьи;
* ревизии;
* категории;
* пользователи;
* права пользователей;
* служебные страницы MediaWiki;
* история изменений.

== Перенос изображений ==

Каталог загруженных файлов старой Wiki был перенесён в:

<syntaxhighlight lang="text">
/var/www/mediawiki/images
</syntaxhighlight>

После переноса были восстановлены корректные права доступа для Apache:

<syntaxhighlight lang="bash">
chown -R www-data:www-data /var/www/mediawiki/images
find /var/www/mediawiki/images -type d -exec chmod 755 {} \;
find /var/www/mediawiki/images -type f -exec chmod 644 {} \;
</syntaxhighlight>

Также был перенесён логотип RAMBA Wiki:

<syntaxhighlight lang="text">
/var/www/mediawiki/resources/assets/ramba_b.png
</syntaxhighlight>

== Короткие URL ==

Для статей сохранена привычная структура адресов:

<syntaxhighlight lang="text">
https://wiki.ramba-art.ru/wiki/Название_страницы
</syntaxhighlight>

В MediaWiki используется:

<syntaxhighlight lang="php">
$wgScriptPath = "";
$wgArticlePath = "/wiki/$1";
$wgServer = "https://wiki.ramba-art.ru";
</syntaxhighlight>

Apache выполняет перенаправление запросов вида:

<syntaxhighlight lang="text">
/wiki/Название
</syntaxhighlight>

на MediaWiki `index.php`.

== Reverse Proxy ==

Reverse proxy RAMBA Wiki находится в BrainyCP:

{| class="wikitable"
! Параметр
! Значение
|-
| Proxmox CT
| 105
|-
| IP
| 192.168.1.12
|-
| Web-сервер
| nginx
|-
| Backend
| 192.168.1.79:80
|-
| Frontend
| HTTPS :443
|}

Основной upstream:

<syntaxhighlight lang="nginx">
location / {
    proxy_pass http://192.168.1.79:80;

    proxy_http_version 1.1;

    proxy_set_header Host $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 https;
    proxy_set_header X-Forwarded-Host $host;
    proxy_set_header X-Forwarded-Port 443;

    proxy_redirect off;
}
</syntaxhighlight>

До миграции upstream указывал на старый сервер:

<syntaxhighlight lang="text">
192.168.1.11:80
</syntaxhighlight>

После проверки новой Wiki он был изменён на:

<syntaxhighlight lang="text">
192.168.1.79:80
</syntaxhighlight>

Это позволило переключить production без изменения DNS.

== HTTPS за reverse proxy ==

Поскольку HTTPS завершается на nginx, а между nginx и Apache используется HTTP, MediaWiki необходимо корректно сообщать исходный протокол запроса.

В `LocalSettings.php` добавлена проверка доверенного reverse proxy:

<syntaxhighlight lang="php">
if (
    ($_SERVER["REMOTE_ADDR"] ?? "") === "192.168.1.12" &&
    ($_SERVER["HTTP_X_FORWARDED_PROTO"] ?? "") === "https"
) {
    $_SERVER["HTTPS"] = "on";
}
</syntaxhighlight>

Заголовок `X-Forwarded-Proto` принимается только от reverse proxy RAMBA с адресом `192.168.1.12`.

== Мобильная версия ==

Для мобильного интерфейса используются:

* '''MobileFrontend'''
* '''MinervaNeue'''

Конфигурация:

<syntaxhighlight lang="php">
wfLoadSkin( 'MinervaNeue' );

$wgDefaultMobileSkin = 'minerva';

wfLoadExtension( 'MobileFrontend' );
</syntaxhighlight>

Расширение MobileFrontend установлено в версии, совместимой с MediaWiki 1.43.

После миграции была дополнительно переработана главная страница RAMBA Wiki, чтобы карточки корректно отображались на небольших экранах.

На мобильных устройствах карточки автоматически перестраиваются в один столбец.

== Редактирование исходного кода ==

Для работы с исходным кодом страниц используются:

<syntaxhighlight lang="php">
wfLoadExtension( 'WikiEditor' );
wfLoadExtension( 'CodeEditor' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );

$wgDefaultUserOptions['usebetatoolbar'] = 1;
$wgWikiEditorRealtimePreview = true;
</syntaxhighlight>

`SyntaxHighlight_GeSHi` используется для оформления команд, конфигурационных файлов и программного кода в технических статьях RAMBA Wiki.

== Основные расширения ==

После миграции были активированы необходимые стандартные расширения:

<syntaxhighlight lang="php">
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'Cite' );
wfLoadExtension( 'TemplateData' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'ReplaceText' );
</syntaxhighlight>

== DynamicPageList3 ==

Для существующих страниц RAMBA Wiki была сохранена поддержка DynamicPageList3.

Установлен:

<syntaxhighlight lang="text">
DynamicPageList3 3.5.2
</syntaxhighlight>

Активация:

<syntaxhighlight lang="php">
wfLoadExtension( 'DynamicPageList3' );
</syntaxhighlight>

После установки расширение было проверено на MediaWiki 1.43.

== RambaGameMonitor ==

Сохранено собственное расширение '''RambaGameMonitor'''.

Расширение предоставляет тег:

<syntaxhighlight lang="text">
<rambamonitor />
</syntaxhighlight>

который позволяет отображать состояние игровых серверов непосредственно на страницах RAMBA Wiki.

В текущей реализации выполняются запросы:

* Rust — Source Engine Query / UDP;
* Minecraft Java Edition — Server List Ping / TCP.

Пример результата:

{| class="wikitable"
! Сервер
! Состояние
! Игроки
! Дополнительная информация
|-
| Rust
| Online / Offline
| текущие / максимум
| карта
|-
| Minecraft
| Online / Offline
| текущие / максимум
| версия
|}

После переноса расширение было проверено непосредственно на MediaWiki 1.43 и PHP 8.2.

== Отказ от устаревших компонентов ==

Во время миграции была проведена ревизия расширений старой Wiki.

Некоторые компоненты намеренно не переносились.

{| class="wikitable"
! Компонент
! Решение
! Причина
|-
| GameQ
| Не переносить
| RambaGameMonitor больше не зависит от GameQ
|-
| LocalisationUpdate
| Не переносить
| Устаревшее расширение
|-
| GoogleCodePrettify
| Не переносить
| Заменено SyntaxHighlight
|-
| Renameuser
| Не переносить
| Функциональность присутствует в современном MediaWiki
|}

Таким образом новая установка не является простой копией старого сервера — устаревшие компоненты были удалены.

== Права доступа ==

Анонимным пользователям разрешено чтение Wiki, но запрещено редактирование и самостоятельная регистрация.

<syntaxhighlight lang="php">
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createaccount'] = false;

$wgGroupPermissions['user']['edit'] = true;
$wgGroupPermissions['user']['createpage'] = true;
</syntaxhighlight>

Для администратора Wiki дополнительно было назначено право:

<syntaxhighlight lang="text">
interface-admin
</syntaxhighlight>

Это необходимо для редактирования системных CSS/JS-страниц, включая:

<syntaxhighlight lang="text">
MediaWiki:Common.css
</syntaxhighlight>

== Безопасность ==

После миграции были сгенерированы новые значения:

<syntaxhighlight lang="text">
$wgSecretKey
$wgUpgradeKey
</syntaxhighlight>

Старые значения больше не используются.

Значения ключей в документации намеренно не публикуются.

Пароль базы данных также не должен храниться в статьях Wiki или открытых конфигурационных примерах.

== Резервное копирование ==

После успешного запуска production была создана полная резервная копия нового CT 102 в '''Proxmox Backup Server'''.

Идентификатор backup:

<syntaxhighlight lang="text">
ct/102/2026-09-02T08:36:30Z
</syntaxhighlight>

Объём файловой системы на момент резервного копирования составлял приблизительно:

<syntaxhighlight lang="text">
1.77 GiB
</syntaxhighlight>

После дедупликации и сжатия в PBS было передано около:

<syntaxhighlight lang="text">
568 MiB
</syntaxhighlight>

Так как используемое для rootfs NFS-хранилище не поддерживает необходимый тип snapshot, Proxmox автоматически переключил backup из режима `snapshot` в режим `suspend`.

Контейнер был приостановлен приблизительно на две секунды.

Backup завершился успешно.

== Переключение production ==

После проверки новой системы был изменён upstream nginx:

<syntaxhighlight lang="text">
СТАРЫЙ:
192.168.1.11:80

НОВЫЙ:
192.168.1.79:80
</syntaxhighlight>

Перед применением конфигурации nginx была выполнена проверка:

<syntaxhighlight lang="bash">
nginx -t
</syntaxhighlight>

После успешной проверки:

<syntaxhighlight lang="bash">
systemctl reload nginx
</syntaxhighlight>

Публичный запрос подтвердил:

<syntaxhighlight lang="text">
https://wiki.ramba-art.ru/
        ↓
HTTP 301
        ↓
https://wiki.ramba-art.ru/wiki/Заглавная_страница
        ↓
HTTP 200
</syntaxhighlight>

== Проверка после миграции ==

После переключения production были протестированы:

* открытие главной страницы;
* HTTPS;
* короткие URL;
* авторизация;
* редактирование статей;
* редактирование `MediaWiki:Common.css`;
* загрузка файлов;
* отображение изображений;
* мобильный интерфейс;
* MinervaNeue;
* DynamicPageList3;
* SyntaxHighlight;
* RambaGameMonitor;
* Apache;
* MariaDB.

Финальная проверка:

<syntaxhighlight lang="text">
HTTP: 200
Redirects: 1
Final:
https://wiki.ramba-art.ru/wiki/Заглавная_страница
</syntaxhighlight>

== Вывод старой системы из эксплуатации ==

После успешной работы CT 102 старый контейнер CT 115 был остановлен.

После остановки была повторно проверена публичная Wiki:

<syntaxhighlight lang="text">
CT 102: running
CT 115: stopped
wiki.ramba-art.ru: HTTP 200
</syntaxhighlight>

Это подтвердило отсутствие зависимости production от старого контейнера.

После этого была создана финальная резервная копия CT 115 в Proxmox Backup Server.

Старый контейнер был удалён:

<syntaxhighlight lang="bash">
pct destroy 115
</syntaxhighlight>

Proxmox подтвердил удаление старого диска:

<syntaxhighlight lang="text">
Logical volume "vm-115-disk-0" successfully removed.
</syntaxhighlight>

После полного удаления CT 115 Wiki была проверена ещё раз:

<syntaxhighlight lang="text">
HTTP: 200
Time: 0.262066s
</syntaxhighlight>

Таким образом старая установка полностью выведена из эксплуатации.

== Итоговая конфигурация ==

<div class="portal-grid">

<div class="portal-card">
'''🌐 Production'''

'''wiki.ramba-art.ru'''

MediaWiki 1.43.9 LTS

Debian 12 Bookworm
</div>

<div class="portal-card">
'''📦 Контейнер'''

CT '''102'''

'''wiki-v2'''

192.168.1.79
</div>

<div class="portal-card">
'''🔀 Reverse Proxy'''

BrainyCP

CT '''105'''

192.168.1.12
</div>

<div class="portal-card">
'''💾 Backup'''

Proxmox Backup Server

Резервируются новая и архивная версии Wiki
</div>

</div>

== Результат ==

Миграция RAMBA Wiki выполнена успешно.

Старая архитектура:

<syntaxhighlight lang="text">
TurnKey Linux
Debian 11
MediaWiki 1.39
PHP 7.4
CT 115
192.168.1.11
</syntaxhighlight>

заменена на:

<syntaxhighlight lang="text">
Debian 12
MediaWiki 1.43.9 LTS
PHP 8.2
MariaDB 10.11
CT 102
192.168.1.79
</syntaxhighlight>

При этом были сохранены существующие данные Wiki и необходимые функции, удалены устаревшие компоненты, восстановлена мобильная версия, настроен reverse proxy и HTTPS, обновлены ключи безопасности и создана новая точка восстановления в Proxmox Backup Server.

'''RAMBA Wiki полностью переведена на новую инфраструктуру.'''

[[Категория:RAMBA Wiki]]
[[Категория:MediaWiki]]
[[Категория:Proxmox]]
[[Категория:Инфраструктура RAMBA]]
[[Категория:Миграции]]