Cómo autohospedar Wiki.js en un VPS (Guía completa)

Wiki.js es un potente y flexible software de wiki de código abierto construido sobre Node.js. Es adecuado tanto para uso personal como colaborativo, lo que lo convierte en una opción popular para desarrolladores y entusiastas de laboratorios en casa que buscan autohospedar una plataforma de gestión de documentación o conocimiento. Esta guía te llevará a través del proceso de autohospedaje de Wiki.js en un Servidor Privado Virtual (VPS). También exploraremos el uso de Docker para una experiencia de instalación simplificada.

Prerrequisitos

Para seguir esta guía, necesitarás:

• Un proveedor de VPS (recomendado: Contabo VPS, Hetzner Cloud, DigitalOcean, Vultr o Linode)
• Un nombre de dominio (opcional pero recomendado para acceder a tu wiki)
• Conocimientos básicos de línea de comandos y Docker

Elegir el VPS adecuado

Al seleccionar un VPS para alojar Wiki.js, considera las siguientes especificaciones:

Para un rendimiento óptimo, Contabo ofrece los mejores recursos por el precio, lo que lo convierte en una opción ideal para alojar Wiki.js.

Paso 1: Configuración de tu VPS

1. Lanza tu VPS: Elige uno de los planes anteriores que se ajuste a tus necesidades y lanza el servidor.

2. Conéctate a tu VPS: Usa SSH para conectarte. Reemplaza your_user y your_ip con tus credenciales.

   ssh your_user@your_ip

3. Actualiza tu sistema:

   sudo apt update && sudo apt upgrade -y

4. Instala Docker:

   sudo apt install docker.io -y
   sudo systemctl start docker
   sudo systemctl enable docker

5. Instala Docker Compose:

   sudo apt install docker-compose -y

Paso 2: Desplegando Wiki.js

1. Crea un directorio para Wiki.js:

   mkdir ~/wikijs && cd ~/wikijs

2. Crea un archivo docker-compose.yml:

   Usa un editor de texto para crear este archivo:

   version: "3"
   
   services:
     wikijs:
       image: requarks/wiki:latest
       ports:
         - "3000:3000"
       environment:
         - DB_TYPE=postgres
         - DB_HOST=db
         - DB_PORT=5432
         - DB_USER=wikijs
         - DB_PASS=password
         - DB_NAME=wikijs
       depends_on:
         - db
   
     db:
       image: postgres:13
       environment:
         - POSTGRES_USER=wikijs
         - POSTGRES_PASSWORD=password
         - POSTGRES_DB=wikijs
       volumes:
         - pgdata:/var/lib/postgresql/data
   
   volumes:
     pgdata:

   Modifica las credenciales de la base de datos según sea necesario para tu configuración.

3. Inicia el servicio de Wiki.js:

   sudo docker-compose up -d

4. Accede a Wiki.js: Abre tu navegador y navega a http://your_ip:3000. Sigue las instrucciones en pantalla para completar la configuración.

Paso 3: Configurando Wiki.js

Una vez instalado, puedes configurar Wiki.js según tus preferencias. Puedes conectarlo a una base de datos externa, establecer autenticación de usuario y personalizar funciones. Para los usuarios primerizos, Wiki.js proporciona una interfaz que hace que estas tareas sean sencillas.

FAQ

1. ¿Cuáles son los beneficios de autohospedar Wiki.js?

El autohospedaje de Wiki.js te otorga control total sobre tus datos y privacidad. Puedes personalizar la plataforma según tus necesidades, escalar recursos según sea necesario y evitar el bloqueo de proveedores. Permite a los desarrolladores y equipos mantener una base de conocimiento coherente sin las limitaciones de los servicios de terceros, todo mientras se mantiene rentable, dependiendo de tus elecciones de infraestructura.

2. ¿Puedo usar Wiki.js con una base de datos PostgreSQL existente?

Sí, Wiki.js admite la conexión a bases de datos PostgreSQL existentes. Durante la fase de configuración, debes especificar tus credenciales de base de datos en el archivo docker-compose.yml. Asegúrate de que la versión de PostgreSQL sea compatible con los requisitos de Wiki.js. También es posible que desees configurar ajustes adicionales para un rendimiento óptimo según las especificaciones de tu base de datos.

3. ¿Qué sucede si mi VPS se cae?

Si tu VPS experimenta tiempo de inactividad, Wiki.js no será accesible, y cualquier edición o actualización realizada mientras estés desconectado puede no guardarse. Las copias de seguridad regulares son cruciales. Utilizar un servicio de copias de seguridad o configurar copias de seguridad automáticas para tu base de datos PostgreSQL puede proteger tus datos. Además, considera usar herramientas de monitoreo para alertarte sobre el estado de tu VPS, lo que te permitirá reaccionar rápidamente.

Conclusión

Autohospedar Wiki.js en un VPS es un enfoque práctico para gestionar documentación y colaboración en tus proyectos. Siguiendo esta guía, configurarás de manera eficiente una plataforma confiable de gestión del conocimiento. Para más detalles, consulta nuestra comparación completa de VPS para elegir el proveedor perfecto para tus necesidades. ¡Feliz hospedaje!