Table of Contents
- Si algo va mal
- Los iconos se ven como cuadros vacíos (□)
- No arranca: falta hyperaxe o algún módulo
- Arranca pero el puerto está ocupado
- Karvan no aparece en el menú
- El panel de llamada se ve descuadrado
- Con el tema claro, las burbujas se ven raras
- La llamada no conecta
- Cambié de identidad y sigo viendo la anterior
- ¿Las imágenes que subo llevan metadatos?
- Aviso serio: no publiques desde dos sitios con la misma identidad
Si algo va mal
⚠ Rama experimental, no oficial. El Oasis oficial es https://github.com/epsylon/oasis · Volver a la portada
Todo lo de esta página ha pasado de verdad durante el desarrollo.
Los iconos se ven como cuadros vacíos (□)
No es un fallo de Oasis. Usa caracteres Unicode poco comunes para los iconos del menú y a tu sistema le falta una fuente que los cubra. En la captura se ven así los del menú lateral, menos el reloj de arena de Karvan.
sudo apt install fonts-noto-core # Debian, Ubuntu y derivadas
No afecta a nada más que a cómo se ve.
No arranca: falta hyperaxe o algún módulo
Cannot find module '../../server/node_modules/hyperaxe'
Faltan las dependencias. Se instalan dentro de src/server, no en la raíz:
cd src/server && npm install
Arranca pero el puerto está ocupado
Si ya tienes un Oasis corriendo, el segundo no puede coger el mismo puerto web ni el de SSB. Para levantar una segunda instancia —útil para probar llamadas entre dos identidades—:
OASIS_ACCOUNT=pruebas ./oasis.sh gui --host=127.0.0.1 --port=3011 --no-open -- --port=8009
Lo que va detrás de -- se le pasa a la configuración de SSB; ahí es donde se cambia
el puerto del protocolo.
Karvan no aparece en el menú
Míralo en /modules: está entre Jobs y L.A.R.P.. Si su casilla está
desmarcada, el módulo está apagado y su ruta devuelve un error.
El panel de llamada se ve descuadrado
Ya no debería. Hubo un fallo real: un comentario sin cerrar en karvan.css anulaba
todo el bloque de la videollamada, y el resultado eran dos cajas vacías enormes y unos
botones cuadrados. Está arreglado.
Si te pasa algo parecido tras tocar el CSS, comprueba que no has dejado un comentario abierto:
python3 -c "
import re;s=open('src/client/assets/styles/karvan.css').read()
st=re.sub(r'/\*.*?\*/','',s,flags=re.S)
assert '/*' not in st, 'comentario sin cerrar'
assert st.count('{')==st.count('}'), 'llaves descuadradas'
print('ok')"
Con el tema claro, las burbujas se ven raras
Clear-SNH usa !important en casi todas sus reglas, así que gana sobre cualquier
hoja posterior. Por eso ese tema trae su propio bloque para Karvan, que lo traduce a la
paleta clara. Si añades un tema con !important, tendrás que hacer lo mismo. La lista
de clases a cubrir está en Temas.
La llamada no conecta
Comprueba, por este orden:
- Que el indicador está en verde. Si dice server relay con el punto gris, los dos navegadores todavía no se han encontrado.
- Que hay otro participante de verdad. Con uno solo, se enciende tu cámara y poco más.
- Si estáis en redes distintas, hace falta un TURN. De fábrica no hay ninguno —a propósito, para no filtrar la IP a un tercero—. Ver Llamadas.
En la misma red local debería conectar sin nada más.
Cambié de identidad y sigo viendo la anterior
El cambio se aplica al reiniciar. Cierra Oasis y vuelve a arrancarlo. La variable
OASIS_ACCOUNT manda sobre lo que diga el selector, así que si arrancas con ella,
ignorará tu elección. Ver Instalar.
¿Las imágenes que subo llevan metadatos?
No. Antes de guardarlas se les quitan: GPS, marca y modelo de la cámara, número de serie y fecha. Vale para JPEG, PNG y WebP. Se conservan la orientación y el perfil de color, y los píxeles quedan byte a byte como estaban.
Compruébalo con una imagen que hayas subido y descargado:
identify -verbose imagen.jpg | grep -i "exif:"
Como mucho debe salir Profile-exif: 32 bytes, que es solo la orientación.
Esto dependía de sharp, y sin esa biblioteca la imagen pasaba intacta sin avisar
de nada. Ahora el limpiador no depende de nada; si sharp está instalado se sigue
prefiriendo, porque además gira los píxeles según la orientación.
Aviso serio: no publiques desde dos sitios con la misma identidad
Si el selector marca en rojo "Comparte clave con otra identidad", esas dos carpetas
tienen el mismo secret.
Un registro de SSB es una cadena firmada y numerada. Si dos sitios publican el número 500 con contenidos distintos, la red ve una bifurcación, deja de replicar el feed y eso no se arregla: se pierde la identidad.
Tener la copia no hace daño. Publicar desde las dos, sí.

