Guía de despliegue

Wakapi en un VPS: estadísticas de programación en su servidor

Desplegar en un VPS Cloud →

Wakapi en un VPS: estadísticas de programación en su servidor

Las extensiones de WakaTime miden muy bien el tiempo de programación, pero envían cada archivo abierto, cada proyecto y cada rama a un servicio externo. Wakapi es un servidor de código abierto compatible con esas mismas extensiones: cambia una línea de configuración y sus estadísticas se quedan en su VPS. Esta guía lo instala con Docker Compose, cierra el registro, lo publica por HTTPS detrás de nginx y conecta su editor.

6 min de lectura4 pasos
Contenido· Qué hace Wakapi1/11
  1. 01Qué hace Wakapi
  2. 02Lo que le ofrece Wakapi
  3. 03WakaTime alojado o Wakapi en su VPS
  4. 04Requisitos previos
  5. 05Instalar Wakapi con Docker Compose
  6. 06No deje el registro abierto
  7. 07Publicar Wakapi por HTTPS con nginx
  8. 08Conectar su editor
  9. 09Leer sus estadísticas y la API
  10. 10Copias de seguridad y actualizaciones
  11. 11Instalar Wakapi en un clic en ServOrbit

Qué hace Wakapi

Wakapi recibe los «latidos» (heartbeats) que las extensiones de WakaTime envían mientras programa: el archivo, el proyecto, el lenguaje, el editor, la máquina y la rama, aproximadamente cada dos minutos. Los agrega en estadísticas que se consultan en un panel web y mediante una API compatible con la de WakaTime.

El proyecto se publica con licencia MIT. Es una sola aplicación Go y guarda sus datos en SQLite por defecto (también admite MySQL y PostgreSQL). En un VPS ocupa unos 100 MB de memoria en reposo.

Lo que le ofrece Wakapi

  • El tiempo por proyecto, lenguaje, editor, máquina y rama — en el día, la semana o el periodo que elija.
  • Sus extensiones actuales — VS Code, JetBrains, Vim, Neovim, Sublime Text: solo cambia la dirección del servidor.
  • Una API compatible con WakaTime — las barras de estado y herramientas que leen la API de WakaTime apuntan a su instancia.
  • Cuentas por invitación — registro público cerrado, enlaces de invitación de un solo uso válidos 24 horas.
  • La importación de su historial — desde WakaTime u otra instancia de Wakapi, en los ajustes.
  • Datos que se quedan con usted — nada sale del VPS, salvo si activa el reenvío a WakaTime.

WakaTime alojado o Wakapi en su VPS

Desplace la tabla

WakaTime (servicio alojado)Wakapi en su VPS
Adónde van los latidosServidores de WakaTimeSu VPS
Extensiones del editorExtensiones de WakaTimeLas mismas extensiones
Historial conservadoSegún el plan contratadoMientras usted lo conserve
Cuentas del equipoCuentas de WakaTimeCuentas en su instancia, por invitación
Licencia del servidorServicio propietarioMIT

Requisitos previos

Un VPS Ubuntu 24.04 con 1 GB de RAM y 1 vCPU es más que suficiente. Necesita Docker con el plugin Compose, nginx y certbot en el host, y un nombre (wakapi.example.com en esta guía) que apunte a la IP del VPS. Las extensiones de WakaTime envían sus datos por HTTPS: prepare el certificado desde el principio.

Instalar Wakapi con Docker Compose

  1. Preparar la carpeta y el archivo .env

    WAKAPI_PASSWORD_SALT es la sal que se añade a las contraseñas antes del hash: genérela una vez y no la cambie nunca, o ninguna cuenta podrá volver a iniciar sesión. El registro queda abierto el tiempo justo para crear su cuenta y se cierra en el paso 4.

    mkdir -p /opt/wakapi && cd /opt/wakapi
    cat > .env <<EOF
    DOMAIN=wakapi.example.com
    WAKAPI_PASSWORD_SALT=$(openssl rand -hex 32)
    WAKAPI_ALLOW_SIGNUP=true
    EOF
    chmod 600 .env
  2. Escribir el archivo docker-compose.yml

    La imagen oficial se ejecuta con un usuario sin privilegios y guarda su base SQLite en el volumen wakapi-data. El puerto solo se publica en la interfaz local: solo nginx queda expuesto a Internet. WAKAPI_LEADERBOARD_ENABLED desactiva la clasificación pública, y WAKAPI_INSECURE_COOKIES en false reserva las cookies de sesión a HTTPS.

    services:
      wakapi:
        image: ghcr.io/muety/wakapi:2.18.2
        restart: unless-stopped
        environment:
          WAKAPI_PASSWORD_SALT: "${WAKAPI_PASSWORD_SALT}"
          WAKAPI_PUBLIC_URL: "https://${DOMAIN}"
          WAKAPI_ALLOW_SIGNUP: "${WAKAPI_ALLOW_SIGNUP:-false}"
          WAKAPI_INVITE_CODES: "true"
          WAKAPI_LEADERBOARD_ENABLED: "false"
          WAKAPI_INSECURE_COOKIES: "false"
        ports:
          - "127.0.0.1:3000:3000"
        volumes:
          - wakapi-data:/data
    
    volumes:
      wakapi-data: {}
  3. Arrancar y crear su cuenta

    Arranque la pila y compruebe el punto de salud, que debe responder app=1 y db=1:

    docker compose up -d
    curl -s http://127.0.0.1:3000/api/health

    Cuando nginx y el certificado estén listos (sección siguiente), abra https://wakapi.example.com/signup y cree su cuenta: la primera cuenta creada pasa a ser administradora.

  4. Cerrar el registro

    En cuanto exista su cuenta, cierre el registro y vuelva a crear el contenedor:

    sed -i 's/^WAKAPI_ALLOW_SIGNUP=true/WAKAPI_ALLOW_SIGNUP=false/' .env
    docker compose up -d

    El formulario de registro responde ahora «registration is disabled». Para añadir a un compañero, genere un enlace de invitación desde los ajustes de su cuenta («Invite Friends»): es válido durante 24 horas y solo sirve una vez.

No deje el registro abierto

Una instancia publicada en un dominio con WAKAPI_ALLOW_SIGNUP=true permite que cualquiera abra una cuenta y guarde datos en ella. Mantenga false, invite a sus compañeros por enlace y deje el puerto en 127.0.0.1.

Publicar Wakapi por HTTPS con nginx

Cree /etc/nginx/sites-available/wakapi con este bloque de servidor y actívelo con un enlace simbólico en sites-enabled:

server {
    listen 80;
    server_name wakapi.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Compruebe la configuración, recargue nginx y solicite el certificado; certbot añade por sí mismo el bloque HTTPS y la redirección desde HTTP.

sudo nginx -t && sudo systemctl reload nginx
sudo certbot --nginx -d wakapi.example.com

Conectar su editor

Instale la extensión de WakaTime de su editor desde su tienda habitual. En Wakapi, abra los ajustes y copie su clave de API; después escriba el archivo ~/.wakatime.cfg de su equipo:

[settings]
api_url = https://wakapi.example.com/api
api_key = <API_KEY>

El cliente de WakaTime deduce el nombre del proyecto de la carpeta raíz del repositorio Git y el nombre de la máquina del nombre de host: sus repositorios aparecen tal cual en el panel, y distingue sin esfuerzo el portátil del equipo de sobremesa. Un archivo .wakatime-project en la raíz de un repositorio impone otro nombre de proyecto, útil cuando varios clones comparten el mismo nombre de carpeta. Para excluir una carpeta sensible, la clave exclude de ~/.wakatime.cfg acepta expresiones regulares sobre las rutas.

Programe unos minutos y recargue el panel de Wakapi: aparecen sus primeras cifras. El mismo archivo sirve para todas las extensiones de la máquina. Para enviar sus datos a WakaTime y a Wakapi a la vez, el cliente de WakaTime acepta una sección [api_urls] que añade destinos.

Leer sus estadísticas y la API

El panel muestra el tiempo por proyecto, lenguaje, editor, sistema operativo, máquina y rama, en el intervalo elegido. Las mismas cifras están disponibles en la API compatible con WakaTime, con autenticación Basic y la clave de API codificada en base64:

curl -s https://wakapi.example.com/api/compat/wakatime/v1/users/current/statusbar/today \
  -H "Authorization: Basic $(printf %s '<API_KEY>' | base64)"

Es el punto de acceso que leen las extensiones que muestran el tiempo del día en la barra de estado. Los ajustes ofrecen también insignias para un README, el uso compartido público de algunas estadísticas (desactivado por defecto) y la importación de su historial de WakaTime.

Copias de seguridad y actualizaciones

Todos los datos están en el volumen wakapi-data. Detenga el contenedor mientras copia la base SQLite, para que la copia sea coherente:

cd /opt/wakapi
docker compose stop wakapi
docker run --rm -v wakapi_wakapi-data:/data -v "$PWD":/backup alpine:3.22 \
  tar czf /backup/wakapi-$(date +%F).tar.gz -C /data .
docker compose start wakapi

Para actualizar, lea primero las notas de versión en GitHub, haga una copia de seguridad y cambie la etiqueta de la imagen:

cd /opt/wakapi
sed -i 's|wakapi:2.18.2|wakapi:<NUEVA_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -d

Instalar Wakapi en un clic en ServOrbit

En un VPS de ServOrbit, Wakapi se instala desde el Marketplace. El script despliega la imagen oficial, genera la contraseña de administrador y la sal de hash, crea la cuenta admin, cierra el registro público y desactiva la clasificación pública, y configura el proxy inverso nginx con HTTPS — en un subdominio de uno de sus dominios o en el subdominio gratuito del VPS. Inicia sesión con el usuario admin y la contraseña que se muestra en su área de cliente, y conecta su editor como se indica arriba.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-wakapi-vps-estadisticas-programacion