Guía de despliegue

Alojar Karakeep en un VPS: marcadores e IA

Desplegar en un VPS Cloud →

Tutorial

Alojar Karakeep en un VPS: marcadores e IA

Autoalojamiento6 min de lectura7 pasos

Todo desarrollador acumula enlaces que piensa leer más tarde. La mayoría acaban en un cementerio de pestañas, en un hilo de conversación o en un servicio de marcadores que perfila sus lecturas. Karakeep resuelve el problema: un gestor autoalojado que rastrea, captura y indexa todo lo que usted guarda, y deja que un modelo local lo etiquete y lo resuma, para que encuentre de verdad lo que había guardado dos meses antes.

Contenido· El problema de los gestores de marcadores en la nube1/6
  1. 01El problema de los gestores de marcadores en la nube
  2. 02Lo que Karakeep hace y los servicios en la nube no
  3. 03Arquitectura: tres contenedores en un solo VPS
  4. 04Alojar Karakeep en un VPS, paso a paso
  5. 05Combine Karakeep con n8n para guardar sin pensarlo
  6. 06Karakeep como base de conocimiento asistida por IA

El problema de los gestores de marcadores en la nube

Pocket, Raindrop.io, Instapaper: prácticos, pero cada enlace guardado informa a una red publicitaria sobre sus intereses. Más concretamente, si el servicio cierra, su archivo se va con él. Y ninguno de ellos le ofrece una búsqueda de texto completo sobre el contenido real de las páginas — solo sobre el título y las etiquetas que usted ha puesto a mano.

Karakeep (antes Hoarder) es la respuesta autoalojada: código abierto con licencia AGPL-3.0, más de 26 000 estrellas en GitHub y desplegable en tres contenedores Docker en un VPS de 2 GB en menos de diez minutos.

Lo que Karakeep hace y los servicios en la nube no

  • Rastrea y archiva el contenido completo de la página en el momento en que usted la guarda — recupera un artículo por su texto, no solo por su título, incluso después de que la página original haya desaparecido.
  • Captura una imagen de cada URL con un Chrome sin interfaz — un archivo visual de cómo era la página en el momento de guardarla.
  • Etiqueta automáticamente mediante Ollama en local u OpenAI — suelte una URL y reciba etiquetas pertinentes, sin trabajo manual.
  • Busca en texto completo mediante Meilisearch — consultas en unos milisegundos sobre todo el contenido guardado, incluidos el texto de los PDF y el OCR de las imágenes.
  • Se instala en el móvil como una aplicación web — añada un marcador desde el menú de compartir nativo de su teléfono, directamente en su instancia.
  • Expone una API REST — envíe y recupere sus marcadores por programa, y conecte n8n, una extensión de navegador o sus propias cadenas de procesamiento.

Arquitectura: tres contenedores en un solo VPS

Karakeep funciona en tres contenedores Docker:

1. La aplicación Karakeep (Node.js) — sirve la interfaz web y la API REST, y orquesta el rastreo de las páginas y las llamadas al modelo. Puerto 3000, unos 300 MB de RAM en reposo.
2. Meilisearch — el motor de búsqueda de texto completo, que indexa todo el contenido guardado. Solo interno (puerto 7700), unos 200 MB de RAM en reposo.
3. Alpine Chrome (sin interfaz) — rastrea las URL y toma las capturas por cuenta de la aplicación. Solo interno (puerto 9222), unos 300 MB de RAM en reposo.

Total en reposo: de 800 MB a 1,2 GB. Un VPS ServOrbit de 2 GB resulta cómodo; prevea 4 GB si además ejecuta Ollama en la misma máquina.

Alojar Karakeep en un VPS, paso a paso

  1. Contrate un VPS

    Elija un VPS Cloud ServOrbit con al menos 2 GB de RAM (Ubuntu 22.04). Si prevé ejecutar Ollama en el mismo servidor para el etiquetado local, un VPS de 4 GB es más indicado: Ollama por sí solo necesita al menos 4 GB para un modelo pequeño como phi3:mini.

  2. Despliegue desde el catálogo ServOrbit

    Seleccione Karakeep en la sección Colaboración y productividad del catálogo. El aprovisionamiento arranca los tres contenedores, genera automáticamente NEXTAUTH_SECRET y MEILI_MASTER_KEY, y publica la interfaz web en el puerto 3000. Abra http://ip-de-votre-vps:3000 en su navegador: aparece la página de registro, y la primera cuenta registrada se convierte en la administradora.

  3. Configure su dominio y el certificado

    Apunte un subdominio (por ejemplo marque-pages.votre-domaine.com) a la IP de su VPS, en Cloudflare o en su proveedor DNS. El bloque de reverse proxy Nginx habitual, con Let's Encrypt: un server con listen 443 ssl, un server_name marque-pages.votre-domaine.com, y dentro del location / un proxy_pass http://127.0.0.1:3000; con proxy_set_header Host $host; y proxy_set_header X-Real-IP $remote_addr;.

    Una vez instalado el certificado, actualice NEXTAUTH_URL=https://marque-pages.votre-domaine.com en su docker-compose.yml y reinicie el contenedor de la aplicación con docker compose up -d. NextAuth exige una correspondencia exacta de la URL para que la cookie de autenticación funcione.

  4. Conecte Ollama para el etiquetado local (opcional)

    Si Ollama está desplegado en el mismo VPS (está en el catálogo ServOrbit), edite el entorno de Karakeep en docker-compose.yml y añada OLLAMA_BASE_URL: http://localhost:11434 así como OLLAMA_KEEP_ALIVE: "10m".

    En la interfaz de Karakeep, vaya a Ajustes → IA y seleccione su modelo Ollama (por ejemplo phi3:mini por rapidez, llama3.2 por calidad). Guarde un enlace: en unos segundos aparecen las etiquetas y el resumen. Sin Ollama ni clave OpenAI, Karakeep sigue siendo plenamente funcional — el etiquetado automático es una opción.

  5. Instale la extensión y la aplicación móvil

    La extensión Karakeep, disponible para Chrome y Firefox, guarda la página actual con un clic desde cualquier pestaña. Apúntela a https://marque-pages.votre-domaine.com e inicie sesión. En el móvil, abra su instancia en Safari o Chrome, toque el botón de compartir y luego «Añadir a pantalla de inicio»: la aplicación web se instala como una aplicación nativa. El menú de compartir de iOS y de Android puede enviar desde ese momento cualquier URL a Karakeep, desde cualquier aplicación.

  6. Importe sus marcadores existentes

    Vaya a Ajustes → Importar en su instancia. Formatos admitidos: exportación JSON de Pocket, archivos de marcadores Netscape (generados por todos los grandes navegadores, por Raindrop.io y por Pinboard), y el formato de copia de seguridad propio de Karakeep. Para una importación voluminosa (varios miles de entradas), la cola de rastreo las procesa en segundo plano: la importación es rápida y la indexación de texto completo se hace después.

  7. Iniciar sesión por primera vez

    Abra la URL y haga clic en «Sign up»: la primerísima cuenta registrada se convierte en la administradora de la instancia. Créela de inmediato.

Combine Karakeep con n8n para guardar sin pensarlo

La API REST de Karakeep acepta un POST /api/v1/bookmarks con un cuerpo JSON {"url": "...", "title": "..."}. En n8n, un nodo HTTP Request puede enviarle URL procedentes de fuentes RSS, de boletines, de enlaces compartidos por mensajería o de cualquier webhook, sin pasar por un navegador. Su lista de lectura se llena sola.

Karakeep como base de conocimiento asistida por IA

La combinación de Karakeep y de Ollama en un mismo VPS da algo que ninguna oferta comercial propone: una base de conocimiento totalmente privada y autoalojada, donde un modelo lee y etiqueta todo lo que usted guarda, y donde la búsqueda de texto completo lo encuentra al instante — sin que ningún dato salga de su servidor.

Para los desarrolladores de Marruecos y de la región MENA que trabajan con fuentes en árabe, en francés y en inglés, el interés es claro: Meilisearch indexa las tres escrituras de forma nativa, y un modelo Ollama multilingüe (por ejemplo aya o command-r) produce etiquetas y resúmenes en los tres idiomas.

A medida que su biblioteca crece, Karakeep expone también una API de búsqueda — GET /api/v1/bookmarks?q=query — que escenarios de n8n o agentes pueden consultar. Su saber guardado se convierte en un conjunto de datos privado y consultable, en lugar de un cementerio de pestañas olvidadas.

Sus marcadores, su servidor, su IA

Despliegue Karakeep en un VPS ServOrbit y dé un hogar privado a su base de conocimiento — búsqueda de texto completo, etiquetado automático con Ollama en local y aplicación móvil, sin ninguna cuenta en la nube.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva