Tutoriales Aplicaciones Web / septiembre 17, 2025

Instalación de Tianji en Ubuntu 24.04

Analiza las visitas de tu web con Tianji, sin cookies ni rastreos.

Don T3rr0rZ0n3

4 minutos

En un mundo donde la privacidad digital es cada vez más importante, contar con herramientas que respeten al usuario sin dejar de ofrecer métricas útiles es fundamental. Tianji es una solución de análisis web minimalista, enfocada en la privacidad, simplicidad y autoalojamiento.

Este software permite monitorizar visitas, páginas vistas, fuentes de tráfico y comportamiento de los usuarios en tu web, sin necesidad de depender de servicios externos como Google Analytics. Es ideal para blogs, páginas personales o proyectos que busquen una alternativa ética y ligera para obtener estadísticas básicas de uso.

En este tutorial te explicaremos cómo instalar Tianji en un servidor GNU/Linux, configurar el seguimiento en tu sitio web y empezar a visualizar las visitas de forma sencilla.

Características de Tianji

  • Estas son algunas de las características que hacen de Tianji una herramienta destacada en el análisis web respetuoso con la privacidad:
  • 🔐 Sin cookies, sin rastreo invasivo: Tianji no usa cookies ni fingerprinting, cumpliendo con la privacidad por diseño.
  • ⚡ Ligero y rápido: Diseñado para consumir pocos recursos, ideal para servidores pequeños o entornos con recursos limitados.
  • 🪶 Fácil de desplegar: Puede ejecutarse como una simple aplicación web sin necesidad de bases de datos complejas.
  • 🌐 Interfaz clara: Dashboard limpio con las métricas esenciales: visitas únicas, páginas vistas, navegadores, países y referers.
  • 🧩 Integración sencilla: Basta con añadir un pequeño script en tu sitio web para empezar a registrar estadísticas.
  • 🧘 Sin complicaciones legales: Al no usar cookies ni almacenar datos personales, puede prescindir del típico banner de consentimiento.
  • 🔧 Autoalojado: Control total de tus datos, sin depender de terceros ni enviar información fuera de tu servidor.

Pasos previos

Antes de comenzar con la instalación, asegúrate de cumplir con los siguientes requisitos:

  • 💻 Servidor con Ubuntu 24.04 como sistema operativo base.
  • 🔐 Acceso SSH al servidor.
  • 🧑‍💻 Permisos de superusuario (root) o capacidad para ejecutar comandos con sudo.
  • 🐳 Docker y Docker Compose instalados, ya que utilizaremos contenedores para desplegar la aplicación de forma rápida, aislada y reproducible.

Instalación de Docker

En caso de que Docker y Docker Compose no estén instalados en tu sistema, a continuación te mostramos cómo hacerlo de forma sencilla:

Instalación de Docker en Ubuntu 24.04
Docker es una aplicación que simplifica el proceso de gestión de los procesos de las aplicaciones en contenedores. Los contenedores le permiten ejecutar sus aplicaciones en procesos aislados de recursos.
_ voidNullDon T3rr0rZ0n3

Con el entorno listo y los requisitos cumplidos, puedes continuar con el proceso de instalación.

Preparación del entorno

Para instalar Tianji correctamente, primero debemos completar los siguientes pasos.

Actualización del sistema

Como primer paso, vamos a asegurarnos de que todos los paquetes del sistema estén actualizados a su última versión:

apt update
apt upgrade -y

Creación del directorio

Para tener todo ordenado, crearemos un directorio donde se guardaran los datos y donde guardaremos el fichero del Docker Compose:

mkdir /opt/tianji
cd /opt/tianji
wget https://raw.githubusercontent.com/msgbyte/tianji/master/docker-compose.yml

Levantamos contenedores

Listo, ya tenemos todo, así que toca levantar el contenedor:

docker-compose up -d

Configuración de Proxy Nginx

Como la aplicación se encuentra escuchando en un puerto local (localhost), necesitaremos configurar un proxy inverso con Nginx para poder acceder a ella mediante un dominio.

Para ello, puedes seguir este tutorial donde encontrarás todos los pasos detallados:

Configurar Proxy Inverso con Nginx para que escuche a un puerto interno
En ocasiones tenemos servicios o aplicaciones web que escuchan directamente a un puerto interno. Para evitar acceder a dicha aplicación o servicio por la IP del servidor, una configuración que podemos hacer es acceder desde un Nginx Proxy.
_ voidNullDon T3rr0rZ0n3
💡
Si has configurado el proxy Nginx utilizando solo HTTP, te recomendamos dar el siguiente paso y habilitar HTTPS para asegurar las conexiones. Si solo necesitas generar un certificado SSL, puedes seguir este tutorial donde se explica cómo hacerlo paso a paso: Instalación de certificado SSL con certbot

Primer contacto con la aplicación

Una vez que hemos levantado el contenedor con Docker Compose y configurado correctamente el dominio a través de Nginx Proxy, ya podemos acceder a la aplicación desde nuestro navegador utilizando el dominio o subdominio que hayamos definido.

💡
La contraseña y usuario para acceder la primera vez, es admin.

Cambiar contraseña del usuario admin

Por seguridad, lo primero que haremos será cambiar la contraseña de admin ya que la que hay configurada por defecto es insegura.

Para ello haremos clic sobre los tres puntos y luego iremos a Profile. Allí haremos clic sobre el botón Change Password.

Más sobre ./voidNull

Haz que cada palabra cuente: tu donación nos inspira a seguir creando contenido. Accede al apartado de Donación para hacer tu aportación