siyuan-docker-compose
SiYuan es una base de conocimientos personal con edición a nivel de bloque, alojada en un contenedor Docker y protegida por un código de acceso.
Ficha actualizada 22 sept 2026, 18:37 · upstream 22 sept 2026, 17:30 · release v1.6.3
Qué es siyuan-docker-compose
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SiYuan es una herramienta de productividad diseñada para organizar conocimiento personal de forma privada. Funciona como una base de conocimientos que permite editar notas a nivel de bloque (por ejemplo, marcadores o bloques de texto) sin perder el contexto original. El workspace se aloja en el disco del host y la interfaz de usuario está protegida mediante un código de acceso único, lo que garantiza la privacidad de los datos. La arquitectura utiliza Docker Compose para gestionar múltiples servicios: el motor de procesamiento de notas, el frontend web, el proxy inverso (Traefik), bases de datos y contenedores de respaldo.
- Acceder a notas organizadas por bloques o marcadores sin perder la estructura original
- Buscar y navegar entre miles de notas personalizadas con un solo punto de entrada
- Crear nuevas notas directamente desde el navegador web con edición en tiempo real
- Organizar conocimiento personal mediante etiquetas, categorías y búsqueda avanzada
- La imagen del contenedor se pincha a un SHA256 fijo para garantizar consistencia entre despliegues
- Se realiza una verificación de frescura diaria del repositorio de imágenes contra la última versión estable
- El pipeline CI incluye pruebas de depuración (debugging) y validación de despliegue en cada commit
- La arquitectura es modular con servicios independientes que pueden ser escalados independientemente
- Se requiere un código de acceso fuerte para proteger la interfaz, lo que añade una capa adicional de seguridad manual
- Las actualizaciones no se realizan automáticamente; deben ejecutarse manualmente mediante scripts o cron jobs
- No existe un script de actualización en el contenedor del servicio (no puede ser actualizado desde dentro del contenedor)
- La persistencia de datos depende de volúmenes externos y debe gestionarse cuidadosamente para evitar corrupción
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Crea una red Docker llamada 'siyuan-network' con `docker network create siyuan-network` antes de iniciar el stack,Copia `.env.example` a `.env` y configura la variable de acceso (`SIYUAN_AUTH_CODE`) mediante un editor,Inicia el contenedor con `docker compose -f siyuan-docker-compose.yml -p siyuan up -d`,Verifica que el servicio esté corriendo ejecutando `curl http://127.0.0.1:6806/` y verificando la respuesta 401 (requiere autenticación),Si el contenedor se reinicia, ejecuta `git pull` para restaurar la versión actual del kernel,Para actualizaciones no automáticas, ejecuta `./update.sh --dry-run` primero para ver qué se aplicaría sin modificar el repositorio
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.