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 latidos | Servidores de WakaTime | Su VPS |
| Extensiones del editor | Extensiones de WakaTime | Las mismas extensiones |
| Historial conservado | Según el plan contratado | Mientras usted lo conserve |
| Cuentas del equipo | Cuentas de WakaTime | Cuentas en su instancia, por invitación |
| Licencia del servidor | Servicio propietario | MIT |
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
Preparar la carpeta y el archivo .env
WAKAPI_PASSWORD_SALTes 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 .envEscribir 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_ENABLEDdesactiva la clasificación pública, yWAKAPI_INSECURE_COOKIESenfalsereserva 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: {}Arrancar y crear su cuenta
Arranque la pila y compruebe el punto de salud, que debe responder
app=1ydb=1:docker compose up -d curl -s http://127.0.0.1:3000/api/healthCuando nginx y el certificado estén listos (sección siguiente), abra
https://wakapi.example.com/signupy cree su cuenta: la primera cuenta creada pasa a ser administradora.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 -dEl 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.comConectar 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 wakapiPara 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 -dInstalar 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.
servorbit.com/ma-es/blog/autoalojar-wakapi-vps-estadisticas-programacion