MediaWiki — Instalación y más

 

Generalidades

Mediawiki.fw.png

MediaWiki es un software gratuito, open-source que puedes usar para crear contenido wiki, tal como Wikipedia. La aplicación es ideal para crear páginas de bases de conocimiento similares a una enciclopedia.

MediaWiki puede ser instalada manualmente en los servidores de DreamHost.

Antes de instalar MediaWiki

Usa estas instrucciones para preparar tu sitio web para instalación de MediaWiki:

  1. Descarga MediaWiki de su sitio en:
  2. Crea una base de datos que será usada por MediaWiki. Visita el siguiente artículo para más información:
  3. Configura tu dominio para usar PHP 8.1 o una versión superior. Revisa los siguiente artículos para obtener más información:

Instalar MediaWiki

Puedes encontrar instrucciones detalladas sobre la instalación manual de MediaWiki en el siguiente artículo:

  1. Carga el archivo MediaWiki que descargaste a tu servidor web a través de FTP.
  2. Inicia sesión en tu servidor a través de SSH, luego descomprime el archivo en el servidor.
  3. Confirma que los archivos de MediaWiki están en el directorio web de tu dominio. Es posible que debas copiarlos desde un directorio mediawiki-x.xx.x recién creado al directorio root.
  4. Apunta tu navegador a mw-config/index.php en tus archivos MediaWiki extraídos, lo que abre la pantalla de configuración. Por ejemplo:
    • http://example.com/mw-config/index.php
  5. Sigue las instrucciones en pantalla para completar el proceso.
    Una vez que se completa el proceso de instalación, se descarga un archivo LocalSettings.php en tu navegador.
  6. Carga el archivo LocalSettings.php a tu carpeta de instalación de MediaWiki en el servidor web a través de FTP.

El archivo LocalSettings.php contiene los ajustes de configuración para tu nueva instalación de MediaWiki, como las credenciales de la base de datos y los permisos de usuario.

Complementos comunes en MediaWiki

Extensiones

MediaWiki ofrece muchos tipos diferentes de extensiones que puede usar para agregar más funcionalidad y personalización a tu sitio. Consulta el siguiente artículo para obtener más detalles:

Google Analytics

También puedes agregar Google Analytics a tu instalación de MediaWiki si lo deseas. Consulta el siguiente artículo para obtener instrucciones detalladas:

Manejo de imágenes

Problemas de miniaturas/thumbnails

MediaWiki ocasionalmente puede tener problemas para generar miniaturas de imágenes, como devolver imágenes corruptas o el mensaje de error "Error creating thumbnail". Una causa común de esto es que no hay suficiente memoria.

Si cargas una imagen grande y ves "Error creating thumbnail" donde debería estar una miniatura, intenta agregar lo siguiente a tu archivo LocalSettings.php en el directorio primario de tu sitio:

$wgMaxShellMemory = 524288;

Imagenes SVG

Para obtener los mejores resultados en la generación de miniaturas de imágenes SVG, puedes instalar librsvg.

El proceso de instalación de SVG no es compatible y se recomienda solo para usuarios avanzados. Consulta el siguiente artículo para obtener más información:

Email y spam

Suplantación de dominio

Agrega lo siguiente a tu archivo LocalSettings.php:

$wgUserEmailUseReplyTo = true;

Esto falsifica el dominio para que el correo del usuario que envía esté en un encabezado Responder en lugar del encabezado Remitente. De lo contrario, el correo que los usuarios intentan enviarse entre sí a través de Special: EmailUser en tu wiki no se puede entregar.

Notificaciones

Dada la cuota de SMTP, debes tener cuidado si habilitas $wgEnotifWatchlist.

Si una página está 'watchlisted' por 100 usuarios que tienen habilitada esa preferencia de usuario, entonces un cambio en esa página agota su cuota durante una hora, si estás en un Shared Hosting.

Bloquear spam de MediaWiki

Combatier SPAM
Proporciona los pasos que puedes seguir para combatir el SPAM en tu sitio web.
MediaWiki Wiki Spam
Descripción de qué es el spam de wiki e instrucciones sobre cómo cualquier usuario puede ayudar a resolver el problema de spam de wiki (no solo los administradores). No todo es obvio, por lo que vale la pena que los administradores lo lean también, ya que es posible que desees referir a tus usuarios de wiki a esto.
CAPTCHA
Habilitar un Captcha en cualquier formulario ayuda a reducir el spam.
Restringir la creación de cuentas
Por defecto, cualquiera puede crear una cuenta en tu wiki. Sin embargo, puedes restringir quién tiene la capacidad de crear cuentas.
Derechos de usuario
También tienes control sobre los derechos de usuario. Puedes deshabilitar las ediciones sin usuario con esta característica.

Utilidades de MediaWiki

Scripts de mantenimiento

En la instalación root de MediaWiki, hay un subdirectorio llamado /maintenance que incluye varios scripts que puedes ejecutar en tu instalación de MediaWiki. Para ejecutar los scripts PHP, debes crear un usuario Shell (SSH) en tu dominio.

Para correr los scripts, debes ingresar php antes del nombre del archivo. Por ejemplo, corre el siguiente comando si deseas ejecutar el script eval.php en el directorio de mantenimiento:

[server]$ php eval.php

Si simplemente escribes php, utiliza la versión predeterminada en el servidor. Sin embargo, puedes elegir explícitamente cualquier versión usando la siguiente ruta completa a la versión en el servidor. Revisa el siguiente artículo para ver ejemplos:

Para obtener más información sobre los scripts individuales, consulta el siguiente artículo:

Almacenamiento en caché

El almacenamiento en caché de tu sitio puede mejorar el rendimiento. Hay varias formas de almacenar en caché tus datos usando MediaWiki. Consulta los siguientes artículos para obtener más información:

Habilitar cargas

Consulta la siguiente guía para obtener instrucciones sobre cómo habilitar la carga de archivos:

Generando copias de seguridad

Consulta la siguiente guía para obtener instrucciones sobre cómo hacer una copia de seguridad de tus datos:

Además, consulta el siguiente artículo de DreamHost para obtener más instrucciones:

Configuraciones seguras

Contraseñas y HTTPS

MediaWiki utiliza un formulario en una página web HTTP para tomar tu contraseña. Esto significa que tu contraseña se transmite a través de la red en texto claro. Para usar HTTPS, debes agregar un certificado SSL.

Permisos LocalSettings.php

El archivo LocalSettings.php almacena la información de inicio de sesión de tu base de datos, incluido el nombre de usuario y la contraseña de la base de datos. Después de mover el archivo LocalSettings.php a tu directorio root, puedes revisar tus permisos.

Debes actualizar los permisos en ese archivo a 640 o 600. Esto se puede hacer corriendo el siguiente comando:

[server]$ chmod 640 LocalSettings.php

Esto hace que el archivo solo se pueda escribir por el propietario, mientras que el grupo aún puede leerlo. Sin embargo, la opción más segura es marcar el archivo como solo legible/editable por el propietario:

[server]$ chmod 600 LocalSettings.php

De esta manera, tu contraseña de MySQL en este archivo está a salvo de que otros usuarios la vean en el mismo servidor. Mira el siguiente artículo para obtener más detalles sobre los permisos:

Mover las credenciales de la base de datos a otro archivo

Otra buena práctica de seguridad es configurar un archivo PHP separado almacenado en el directorio de tu usuario. Este archivo almacena tus credenciales y las pasa como variables. La siguiente configuración describe cómo vincular tu archivo LocalSettings.php a este nuevo archivo:

  1. En el directorio de tu usuario (no el directorio del dominio), crea un nuevo directorio llamado external_includes.
  2. En esta nueva carpeta, crea un archivo llamado database_info.php.
    La ruta completa a este nuevo archivo es:
    /home/username/external_includes/database_info.php
    Asegúrate de cambiar el username a tu usuario Shell. El archivo incluye lo siguiente (llena tus datos reales entre las comillas):
    <?php
     $database_server = "mysql.example.com"; 
     $database_name   = "databasename"; 
     $database_user   = "username";
     $database_pw     = "password";
     ?>
    
  3. Elimina las credenciales de la base de datos actual en tu archivo LocalSettings.php.
  4. Reemplaza esas lineas con lo siguiente:
    # enhanced DB security
     require_once ("/home/username/external_includes/database_info.php");
     
     $wgDBserver     = $database_server;
     $wgDBname       = $database_name;
     $wgDBuser       = $database_user;
     $wgDBpassword   = $database_pw;
     
     # DB variables not security related - leave these alone from how when you set up your wiki
     $wgDBprefix     = "wiki_";
     $wgDBtype       = "mysql";
    

Con esta configuración, tus credenciales en el archivo LocalSettings ahora están ocultas de forma segura.

Configuraciones de licencia

Puedes seleccionar qué licencia de MediaWiki deseas utilizar. Mira el siguiente artículo para más detalles:

Wikipedia usa GFDL. Si deseas habilitar contenido reutilizable en Wikipedia y otros proyectos GFDL, entonces debes usar GFDL (o licencia múltiple para usar ambos). En general, si hay otros proyectos con los que deseas trabajar, debes usar licencias compatibles.

Actualizar MediaWiki

Siempre asegúrate de hacer primero una copia de seguridad de los archivos de tu base de datos y sitio web antes de hacer cualquier ajuste. De esta manera, si algo fallara, podría reemplazar rápidamente tus archivos. Mira el siguiente artículo para más detalles:

Consulta la siguiente guía en mediawiki.org para obtener instrucciones de actualización:

Puede ser necesario ejecutar el script /maintenance/update.php después de la actualización. Para hacerlo, inicia sesión en tu sitio a través de SSH. Luego corre el siguiente comando:

[server]$ php /maintenance/update.php

Esto ejecuta un script de actualización que deberías corregir los errores actuales en tu sitio. Si eso no funciona, especifica la ruta completa a una versión de PHP. Por ejemplo:

[server]$ /usr/local/php81/bin/php maintenance/update.php

Configuraciones avanzadas y solución de problemas

Habilitar debugging

Puedes habilitar la depuración agregando líneas en la parte inferior de archivo LocalSettings.php. Al habilitar esto, se te proporciona información de depuración detallada para ayudar a aislar la causa.

Revisa el siguiente artículo para obtener más detalles:

Después de que termines de solucionar los problemas de tu instalación, debes deshabilitar la configuración de depuración.

URLs cortas

Puedes acortar las URL para que parezcan más fáciles de usar. Por ejemplo, puedes cambiar el siguiente ejemplo de URL:

example.com/w/index.php?title=Main_Page

a

example.com/wiki/Main_Page

Revisa los siguientes artículos para obtener más instrucciones:

Arreglar MediaWiki después de agregar un certificado SSL a un dominio

Puedes notar que MediaWiki se carga incorrectamente o muestra advertencias de 'contenido inseguro' en la barra del navegador después de agregar un certificado SSL al dominio donde está instalado MediaWiki.

Tu archivo LocalSettings.php debe ser editado para reflejar HTTPS para tu dominio. Para solucionarlo, busca el valor $wgServer en el archivo LocalSettings.php y asegúrate de que el dominio muestre HTTPS (y no HTTP) para el valor de URL:

## The protocol and server name to use in fully-qualified URLs
$wgServer = "https://www.example.com";

Después de hacer esta edición, guárdala y luego transfiere el archivo LocalSettings.php a la carpeta wiki root en tu servidor. Actualiza tu navegador y MediaWiki debería cargarse normalmente.

Ver también

¿Este artículo ha respondido sus preguntas?

Última actualización el PST.

¿Aún no encuentra lo que busca?