Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

PrivLink

PrivLink es una aplicación de autoalojamiento para gestión de navegación personal con sistema de tokens, soporte Docker/Cloudflare y base de datos SQLite ligera.

Ficha actualizada 27 sept 2026, 14:06 · upstream 27 sept 2026, 13:55 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es PrivLink

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

PrivLink es una herramienta de autoalojamiento diseñada para gestionar sitios web personales mediante una interfaz de tarjetas con iconos y etiquetas. Permite distinguir entre sitios públicos (accesibles sin autenticación) y privados (protegidos por token), facilitando la organización de favoritos en un entorno seguro y personalizable.

La aplicación se basa en FastAPI y Python, utilizando SQLite como base de datos local para garantizar una instalación sencilla sin dependencias externas complejas. Soporta despliegue directo mediante Docker o en entornos cloud gratuitos como Cloudflare Workers, con capacidad de migración entre ambos. Incluye funcionalidades avanzadas como caché ETag/304, optimización de carga y soporte para proxies HTTP/SOCKS5.

El sistema de control de acceso mediante tokens permite a los usuarios gestionar la visibilidad de sus sitios sin complicaciones técnicas excesivas. Además, ofrece un modo de recolección desde el navegador para capturar sitios con protecciones como Cloudflare o autenticación dinámica, manteniendo la privacidad al no exportar cookies ni saltar verificaciones.

CASOS DE USO
  • Gestión personal de favoritos web con clasificación pública/privada y ordenamiento por etiquetas
  • Autoalojamiento en VPS/NAS/Docker para navegación privada sin depender de servicios externos
  • Despliegue gratuito en Cloudflare Workers con base de datos D1 y almacenamiento R2
  • Captura de sitios protegidos mediante scripts de navegador (Tampermonkey/extensiones) sin exportar cookies
PUNTOS DESTACADOS
  • Arquitectura ligera: FastAPI + SQLite, sin necesidad de bases de datos externas ni compilación de frontend
  • Soporte multiplataforma: despliegue nativo (uvicorn), Docker y Cloudflare Workers con migración automática
  • Sistema de tokens opcional para proteger sitios privados sin complicar el acceso a contenido público
  • Optimización de rendimiento con caché ETag/304, gzip y renderizado local vía localStorage
PRECAUCIONES
  • No soporta autenticación multiusuario; requiere configuración manual del token NAV_TOKEN para cada usuario
  • Despliegue nativo exige Python 3.11+ gestionado con uv; entornos legacy requieren Docker o migración
  • La recolección desde navegador depende de que el sitio sea accesible desde el cliente (no bypassa captchas)
  • El almacenamiento de iconos es local en directorios ICON/ y background/, requiriendo copias manuales para backup
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU2 vCPUrecomendación inicial
MEMORIA2 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Requiere Python 3.11+ con uv o Docker. Configurar NAV_TOKEN en .env para activar modo protegido. Usar proxy inverso (Caddy/Nginx) con HTTPS en producción. Backup manual de data/, ICON/ y background/. En Cloudflare, usar GitHub Actions o CLI con wrangler; migración desde local disponible vía script incluido.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsFastAPIPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8000
06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.