Instalar Joplin Server en Synology DSM 7.x con Container Manager

En Synology DSM 7.x, la forma más cómoda de desplegar Joplin Server es usar la función “Project” de Container Manager. En el fondo es Docker Compose: un contenedor PostgreSQL, un contenedor Joplin Server, y Synology se encarga de descargar imágenes, crear contenedores y gestionar el arranque diario.

Esta es la versión específica para Synology. Se centra en directorios de File Station, proyectos de Container Manager, acceso LAN, sincronización remota y proxy inverso. Si ya escribes docker-compose.yml a mano en servidores Linux, el flujo te resultará familiar. Si usas sobre todo la interfaz gráfica de Synology, también puedes seguirlo paso a paso.

Cuándo tiene sentido

Joplin Server sirve si quieres guardar los datos de sincronización de notas en tu propio dispositivo. Permite que clientes Windows, macOS, iOS, Android y otros sincronicen a través de tu propio servidor, sin depender de una nube de terceros.

Desplegarlo en Synology encaja bien si:

tu NAS está encendido de forma permanente y puede actuar como servidor personal o doméstico de sincronización;
solo quieres sincronizar ordenadores y teléfonos dentro de la LAN;
quieres sincronización remota mediante Tailscale, WireGuard o un proxy inverso;
prefieres gestionar contenedores desde Container Manager en lugar de usar SSH todo el tiempo.

Si solo estás probando Joplin de forma temporal, no necesitas necesariamente Joplin Server. Joplin también soporta WebDAV, S3, Dropbox y otros métodos de sincronización. Pero para self-hosting a largo plazo, Joplin Server es una opción más completa.

Paso 1: preparar directorios en File Station

Abre File Station en Synology y entra en la carpeta compartida docker.

Crea un directorio:

1

docker/joplin

Dentro de joplin, crea otro subdirectorio:

1

postgres_data

La estructura final debería quedar más o menos así:

1
2
3


docker/
└── joplin/
    └── postgres_data/

postgres_data sirve para guardar la base de datos PostgreSQL. Los datos de sincronización de Joplin Server viven principalmente en la base de datos, así que este directorio debe persistir. Cuando actualices o recrees contenedores, los datos no desaparecerán mientras este directorio siga existiendo.

Paso 2: crear un proyecto en Container Manager

Abre Container Manager en Synology:

haz clic en Project en la barra izquierda;
haz clic en Create;
usa joplin-server como nombre del proyecto;
elige la ruta /docker/joplin que creaste;
selecciona Create docker-compose.yml como origen.

Pega esta configuración Compose:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


version: '3'

services:
  db:
    image: postgres:16
    container_name: joplin-db
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    restart: unless-stopped
    environment:
      - POSTGRES_PASSWORD=change_this_database_password
      - POSTGRES_USER=joplin_user
      - POSTGRES_DB=joplin_db

  app:
    image: joplin/server:latest
    container_name: joplin-server
    depends_on:
      - db
    ports:
      - "22300:22300"
    restart: unless-stopped
    environment:
      - APP_PORT=22300
      - APP_BASE_URL=http://192.168.1.100:22300
      - DB_CLIENT=pg
      - POSTGRES_PASSWORD=change_this_database_password
      - POSTGRES_DATABASE=joplin_db
      - POSTGRES_USER=joplin_user
      - POSTGRES_PORT=5432
      - POSTGRES_HOST=db

Debes cambiar dos valores:

POSTGRES_PASSWORD: la contraseña de la base de datos. Debe ser idéntica en ambos lugares;
APP_BASE_URL: la dirección real que los clientes de Joplin usarán para llegar al servidor.

Si solo lo usas dentro de la LAN, cambia APP_BASE_URL por la IP local de Synology:

1

- APP_BASE_URL=http://192.168.1.100:22300

Si ya tienes un proxy inverso HTTPS, escribe directamente el dominio externo:

1

- APP_BASE_URL=https://joplin.example.com

No rellenes APP_BASE_URL al azar. La sincronización de clientes, las redirecciones web y los enlaces de adjuntos dependen de ese valor. Debe ser la dirección que realmente vas a usar.

Tras confirmar la configuración, continúa hasta finalizar. Container Manager descargará postgres:16 y joplin/server:latest, y luego iniciará los dos contenedores.

Paso 3: comprobar el estado de los contenedores

Después de crear el proyecto, abre la página del proyecto joplin-server en Container Manager.

Normalmente verás dos contenedores:

joplin-db
joplin-server

Si ambos están en verde y ejecutándose, puedes continuar.

Si no arrancan correctamente, revisa primero los logs del proyecto. Las causas frecuentes son:

las dos contraseñas de base de datos no coinciden;
el directorio postgres_data tiene problemas de permisos;
el puerto 22300 de Synology ya está ocupado por otro servicio;
la indentación YAML se rompió.

Paso 4: primer inicio de sesión en Joplin Server

Abre en el navegador:

1

http://群晖IP:22300

Por ejemplo:

1

http://192.168.1.100:22300

La cuenta administradora predeterminada es:

1

admin@localhost

La contraseña predeterminada es:

1

admin

Después del primer inicio de sesión, cambia la contraseña del administrador de inmediato. No te saltes este paso, especialmente si planeas configurar acceso remoto.

Si el panel permite cambiar el correo del administrador, también conviene poner tu propio correo para identificar mejor la cuenta.

Paso 5: ¿crear un usuario normal?

Si solo lo usas tú, puedes sincronizar con la cuenta administradora ya actualizada. Pero una práctica más limpia es crear un usuario normal para sincronizar notas, dejando la cuenta administradora solo para gestionar el panel.

En el panel de administración:

entra en Users;
haz clic en Add user;
escribe correo y contraseña;
guarda.

Si no configuraste SMTP, el sistema dirá que envió un correo de activación, pero no lo recibirás. En ese caso, entra en la página Emails del panel, busca el correo de activación no enviado, copia el enlace de activación y ábrelo en el navegador para activar la cuenta.

Para uso personal, no configurar SMTP no es un problema. Para varios usuarios a largo plazo, conviene añadir SMTP después, porque registro, activación y restablecimiento de contraseña serán menos molestos.

Paso 6: configurar la sincronización del cliente Joplin

Abre el cliente Joplin en tu ordenador o teléfono:

entra en Options / Settings;
abre Synchronization;
elige Joplin Server como destino de sincronización;
en Joplin Server URL, escribe el APP_BASE_URL configurado antes;
como usuario, escribe el correo del administrador o del usuario normal;
escribe la contraseña correspondiente;
pulsa Check synchronization configuration.

Si la comprobación funciona, guarda y empieza a sincronizar.

Si falla, confirma primero si el cliente puede abrir Joplin Server en el navegador. Muchos problemas de sincronización no vienen de Joplin, sino de un APP_BASE_URL incorrecto, una cuenta sin activar, un certificado roto en el proxy inverso o un teléfono que no está en la misma red.

Opción remota 1: Tailscale o WireGuard

La forma más segura y cómoda de sincronizar desde fuera es conectar el teléfono y el ordenador de vuelta a la red de casa mediante VPN.

Opciones comunes:

Tailscale;
WireGuard;
ZeroTier.

La ventaja es que Joplin Server no necesita exponerse directamente a internet. La URL en el cliente Joplin puede seguir siendo la IP local de Synology, por ejemplo:

1

http://192.168.1.100:22300

Cuando el teléfono esté fuera, conecta primero Tailscale o WireGuard y luego abre Joplin para sincronizar.

Si no quieres tratar con IP pública, DDNS, certificados y reenvío de puertos, esta es la ruta más estable. La desventaja es que cada dispositivo externo debe conectarse primero a la VPN.

Opción remota 2: proxy inverso HTTPS de Synology

Si quieres que Joplin sincronice directamente desde cualquier red, configura un dominio HTTPS.

El flujo general es:

prepara un dominio o DDNS;
reenvía el puerto 443 del router a Synology;
en Synology Control Panel -> Login Portal -> Advanced -> Reverse Proxy, crea una regla nueva;
usa https://joplin.example.com:443 como origen;
usa http://127.0.0.1:22300 o http://群晖内网IP:22300 como destino;
solicita y asigna un certificado HTTPS para el dominio;
cambia APP_BASE_URL en Compose a https://joplin.example.com;
redepliega el proyecto en Container Manager.

Al usar proxy inverso, conviene añadir cabeceras reenviadas comunes en los encabezados personalizados:

1
2
3
4


Host: $host
X-Real-IP: $remote_addr
X-Forwarded-For: $proxy_add_x_forwarded_for
X-Forwarded-Proto: $scheme

Si usas la interfaz de proxy inverso integrada en Synology, los nombres de campos pueden variar ligeramente entre versiones menores de DSM. Añádelos mediante las opciones de “custom header” o relacionadas con “WebSocket” que aparezcan en la interfaz.

Joplin también puede encontrar límites de subida al sincronizar adjuntos grandes. Si usas Nginx Proxy Manager o Nginx manual, configura:

1

client_max_body_size 100M;

Si el proxy inverso integrado de Synology no ofrece esa opción, prueba primero la sincronización con adjuntos normales. Si sincronizas archivos grandes con frecuencia, Nginx Proxy Manager o Caddy serán más flexibles.

Redeplegar después de cambiar APP_BASE_URL

Mucha gente prueba primero con una IP local y luego cambia a un dominio HTTPS. Está bien, pero no cambies solo el cliente.

También debes modificar la configuración Compose del proyecto en Container Manager:

1

- APP_BASE_URL=https://joplin.example.com

Después redepliega el proyecto para que las variables de entorno del contenedor surtan efecto.

Si APP_BASE_URL sigue apuntando a la dirección antigua, pueden aparecer estos problemas:

la comprobación de sincronización del cliente falla;
después de iniciar sesión redirige a una dirección incorrecta;
los enlaces de adjuntos fallan;
el protocolo se detecta mal detrás del proxy inverso.

Prioridades de copia de seguridad

En Synology, el directorio más importante es:

1

docker/joplin/postgres_data

Ahí está la base de datos PostgreSQL, es decir, los datos centrales de sincronización de Joplin Server. Conviene incluirlo en Hyper Backup u otro plan de copia de seguridad.

Una estrategia más sólida:

hacer copias periódicas de docker/joplin/postgres_data;
mantener una copia local de las notas en los clientes Joplin;
exportar notas importantes como JEX de vez en cuando;
confirmar que la copia funciona antes de actualizar contenedores.

No respaldes solo la imagen o la configuración del contenedor de Joplin Server. Las imágenes se pueden descargar de nuevo; la base de datos es tu información.

Resumen

Instalar Joplin Server en Synology DSM 7.x se reduce a unos pocos pasos:

preparar docker/joplin/postgres_data en File Station;
crear un proyecto Compose en Container Manager;
configurar bien POSTGRES_PASSWORD y APP_BASE_URL;
cambiar la contraseña del administrador tras el primer inicio de sesión;
elegir Joplin Server como destino de sincronización en el cliente;
para acceso remoto, priorizar Tailscale / WireGuard, o configurar un proxy inverso HTTPS.

El punto más fácil de romper es APP_BASE_URL. Mientras esa dirección sea correcta y el directorio de base de datos sea persistente, Joplin Server puede funcionar como un servicio privado y estable de sincronización de notas en Synology.