Wiki.js es una aplicación wiki de código abierto y rica en funcionalidades, diseñada con el framework Node.js. Ofrece una experiencia de edición versátil, compatible con Markdown e interfaces WYSIWYG. Además, facilita la colaboración en tiempo real, el control de versiones y diversos métodos de autenticación, incluyendo integraciones con Google y LDAP. Esta guía completa te guiará por los pasos necesarios para configurar Wiki.js con Docker, lo que te permitirá implementar tu propia wiki en cuestión de minutos.
Configuración de Wiki.js a través de Docker Compose
El proceso de configuración de Wiki.js con Docker y Docker Compose es sencillo. Empieza creando un nuevo directorio llamado wikijs-dockery accede a él:
mkdir wikijs-docker && cd wikijs-docker
A continuación, crea un archivo con el nombre de docker-compose.ymltu editor de texto preferido:
nano docker-compose.yml
Luego, inserte la siguiente configuración en el archivo:
services: db: image: postgres:16 environment: POSTGRES_DB: wiki POSTGRES_PASSWORD: wikijsrocks POSTGRES_USER: wikijs restart: unless-stopped volumes: - db-data:/var/lib/postgresql/data wiki: image: ghcr.io/requarks/wiki:2 depends_on: - db environment: DB_TYPE: postgres DB_HOST: db DB_PORT: 5432 DB_USER: wikijs DB_PASS: wikijsrocks DB_NAME: wiki restart: unless-stopped ports: - "80:3000" volumes: db-data:
Después de guardar y cerrar el archivo, inicie los contenedores ejecutando el siguiente comando:
docker compose up -d
Una vez finalizada la configuración, acceda a http://localhost en su navegador web. Aquí deberá proporcionar los datos de la cuenta de administrador y seleccionar el botón «Instalar» para comenzar la instalación.
Al finalizar la instalación, inicie sesión con sus credenciales.
Creación y gestión de páginas en Wiki.js
Una vez completada la configuración inicial, puede establecer su página de inicio para comenzar a completar su contenido o acceder al panel de administración para gestionar su configuración, usuarios y funciones disponibles:
Al hacer clic en la opción Crear página de inicio, se le pedirá que elija un editor adaptado a sus preferencias:
A continuación, defina las propiedades de su página y presione el botón Aceptar para continuar con la creación de una nueva página:
Escriba el contenido deseado y haga clic en el botón Crear para finalizar la creación de la página:
Gestión y organización de contenidos
Tu panel te permite ver y modificar fácilmente las páginas existentes, así como crear nuevas con el editor que prefieras. Puedes organizar tu contenido renombrando, moviendo o eliminando páginas, y usar etiquetas para una categorización eficaz. Además, la barra lateral y la función de búsqueda agilizan la navegación a páginas específicas de tu wiki:
Configuración de los ajustes del sitio Wiki.js
Dentro del panel de administración de Wiki.js, puedes configurar opciones del sitio como la configuración regional, las estructuras de navegación, los temas y las etiquetas. Estas opciones son cruciales para definir la configuración general de tu instancia de Wiki.js.
En la pestaña General, puedes ajustar la configuración fundamental del sitio, incluido el título del sitio, la descripción, la página de inicio predeterminada y la configuración de visibilidad (pública o privada):
Cambie a la pestaña Configuración regional para especificar el idioma predeterminado, la zona horaria y los formatos de fecha y hora para su sitio:
Para administrar la estructura del menú de su wiki y mejorar la navegación del usuario, visite la sección de la barra de navegación :
En la pestaña Páginas, puedes supervisar, editar y organizar todas las páginas wiki, crear páginas nuevas y administrar la jerarquía de tu contenido:
Además, en la pestaña Etiquetas, puedes crear y administrar etiquetas de contenido, lo que mejora la búsqueda de páginas. También puedes personalizar la estética de tu wiki mediante la pestaña Tema, donde puedes modificar el logotipo, los colores, las fuentes y los estilos de diseño del sitio.
Administrar grupos en su wiki
La sección Grupos permite crear grupos de usuarios, designar miembros y establecer permisos a nivel de grupo para regular el acceso. Este método organizativo ayuda a optimizar los roles de los usuarios y a mantener una gestión de acceso consistente en toda la wiki.
Al hacer clic en un grupo específico, podrá actualizar su configuración, permisos, reglas de página y administración de usuarios dentro de ese grupo. En la pestaña Configuración, puede ajustar las opciones, incluida la URL de redirección de inicio de sesión.
También puede navegar por las secciones de Permisos, Reglas de página y Usuarios para refinar a qué puede acceder el grupo y asignar usuarios en consecuencia.
Gestión de usuarios en Wiki.js
Para agregar un nuevo usuario, diríjase a la sección Usuarios, haga clic en el botón NUEVO USUARIO y complete los campos obligatorios.
Una vez completado, seleccione CREAR o CREAR Y CERRAR para finalizar la configuración del nuevo usuario:
Al seleccionar un usuario en particular, podrá ver y editar su perfil, asignar grupos de usuarios, definir métodos de autenticación (como contraseñas o autenticación de dos factores) y administrar su estado con acciones como Desactivar, Verificar o Eliminar :
Además, puede actualizar su información básica, metadatos ampliados (incluida la ubicación y el puesto de trabajo) y ver su historial de actividad:
Administrar sus módulos wiki
Los módulos son mejoras que amplían las capacidades de Wiki.js. Por ejemplo, el módulo Analytics permite integrar herramientas como Google Analytics para monitorizar la interacción de los usuarios y las métricas de tráfico.
Utilice la pestaña Autenticación para establecer y administrar proveedores de autenticación (inicio de sesión local, LDAP, OAuth) además de configurar varias opciones de inicio de sesión:
También puedes activar o desactivar el sistema de comentarios y determinar cómo participan los usuarios en las discusiones de la página:
Configuración del sistema
Gestione cómo se renderiza, indexa para búsquedas y almacena el contenido configurando los motores de renderizado, la indexación de búsquedas y las opciones de almacenamiento. Por ejemplo, acceda a la pestaña Renderizado para personalizar la renderización del contenido, como ajustar la configuración del motor Markdown o habilitar la compatibilidad con diagramas y expresiones matemáticas.
En la sección Motor de búsqueda, puedes administrar las opciones de indexación de búsqueda interna y las integraciones de motores de búsqueda de terceros:
En la sección Almacenamiento, especifique los objetivos de copia de seguridad y sincronización para su contenido, lo que le permitirá administrar dónde y cómo se almacenan los archivos adjuntos de medios y páginas (por ejemplo, en el sistema de archivos local o AWS S3):
Gestión de la seguridad y la conectividad
Puedes proteger tu instancia de Wiki.js configurando el acceso a la API, configurando notificaciones por correo electrónico, ajustando las políticas de seguridad y habilitando SSL para una experiencia segura. Por ejemplo, gestiona los tokens de la API para integrar Wiki.js con otras aplicaciones:
Configure las configuraciones de correo electrónico para administrar notificaciones, invitaciones y procesos de recuperación de contraseña dentro de Wiki.js:
La configuración de seguridad también se puede ajustar, cubriendo aspectos como tiempos de espera de sesión, políticas de contraseñas y restricciones de acceso:
Además, puedes configurar certificados SSL/TLS para garantizar que tu instancia de Wiki.js funcione de forma segura a través de HTTPS:
Además, verifique la información de su Wiki, como el diagnóstico del sistema, las especificaciones del servidor y las estadísticas del entorno de ejecución desde la sección Información del sistema :
Realice actividades de mantenimiento como volver a indexar los resultados de búsqueda, borrar datos almacenados en caché o restablecer configuraciones desde la pestaña Utilidades :
Por último, las herramientas para desarrolladores ofrecen recursos avanzados como un área de juegos GraphQL, capacidades de depuración de registros o integraciones de scripts personalizados:
Ahora que cuenta con el conocimiento para configurar Wiki.js usando Docker, puede usar con confianza esta plataforma para crear documentación interna, wikis de equipo colaborativos o bases de conocimiento públicas sin esfuerzo.
Artículos relacionados:
Los mejores métodos para almacenar contraseñas de forma segura sin conexión
15:30
Guía definitiva para rediseñar la pantalla de bloqueo de tu iPhone
6:35
Guía para ajustar la configuración de volumen de aplicaciones específicas en dispositivos Android
6:30
Deja una respuesta