Guía de despliegue

Weblate en un VPS: traduzca sus aplicaciones desde Git

Desplegar en un VPS Cloud →

Weblate en un VPS: traduzca sus aplicaciones desde Git

Traducir una aplicación al árabe, al francés y al inglés suele acabar en archivos JSON enviados por correo, variables rotas y traducciones que llegan después de la versión. Weblate lo resuelve en el origen: se conecta a su repositorio Git, muestra cada cadena a los traductores en el navegador y devuelve las traducciones aprobadas como commits. Esta guía lo instala en un VPS con Docker Compose, lo cierra a desconocidos, lo publica en HTTPS detrás de nginx y conecta un primer repositorio.

6 min de lectura3 pasos
Contenido· Qué hace Weblate1/11
  1. 01Qué hace Weblate
  2. 02Lo que le ofrece Weblate
  3. 03Plataforma alojada o Weblate en su VPS
  4. 04Requisitos
  5. 05Instalar Weblate con Docker Compose
  6. 06No publique una instancia abierta
  7. 07Publicar Weblate en HTTPS con nginx
  8. 08Traducir su primer repositorio Git
  9. 09Conectar LibreTranslate para las sugerencias
  10. 10Copias de seguridad y actualización
  11. 11Weblate en un clic en ServOrbit

Qué hace Weblate

Weblate es una plataforma de traducción continua: en lugar de exportar archivos a mano, le da la dirección del repositorio Git de su aplicación. Lee los archivos de idioma — gettext PO, JSON (i18next, vue-i18n), XLIFF, YAML, Android, iOS, ARB, propiedades Java — y presenta cada cadena a los traductores en un editor web. Las traducciones aprobadas vuelven al repositorio como commits, o como pull requests si prefiere revisar.

El proyecto se publica bajo licencia GPL-3.0. La imagen Docker oficial se apoya en PostgreSQL y en Valkey (o Redis) para la caché y la cola de tareas. En un VPS, cuente con unos 1,7 GB de memoria en reposo con dos procesos de trabajo.

Lo que le ofrece Weblate

  • Una sola fuente de verdad: Git — los desarrolladores añaden las cadenas en el código y las traducciones vuelven al mismo repositorio.
  • Controles de calidad — variables que faltan, etiquetas rotas, espacios y puntuación, plurales incompletos.
  • Árabe sin apaños — edición de derecha a izquierda y seis formas de plural.
  • Revisión explícita — cada cadena puede marcarse como pendiente de edición, traducida o aprobada.
  • Memoria de traducción y glosario — los términos de su producto, siempre traducidos igual.
  • Sugerencias automáticas — desde su propio LibreTranslate u otro servicio de traducción.

Plataforma alojada o Weblate en su VPS

Desplace la tabla

Plataforma alojada (Crowdin, Lokalise…)Weblate en su VPS
Dónde viven las cadenasServidores del proveedorSu VPS
Vínculo con el códigoIntegración con GitIntegración con Git
Cuentas de traductoresSegún el planTantas como quiera
Textos no publicadosEn un terceroEn su servidor
Licencia del servidorServicio propietarioGPL-3.0

Requisitos

Un VPS Ubuntu 24.04 con 4 GB de RAM y 2 vCPU. Necesita Docker con el plugin Compose, nginx y certbot en el host, y un nombre (weblate.example.com en esta guía) que apunte a la IP del VPS. Prevea también una cuenta SMTP que escuche en el puerto 587 con TLS: Weblate envía por correo las invitaciones y los restablecimientos de contraseña.

Instalar Weblate con Docker Compose

  1. Preparar la carpeta y el archivo .env

    El mismo archivo sirve a Docker Compose y al contenedor de Weblate. WEBLATE_REGISTRATION_OPEN=0 cierra el registro y WEBLATE_REQUIRE_LOGIN=1 exige iniciar sesión para leer cualquier cosa. Sustituya las tres líneas SMTP por las de su proveedor.

    mkdir -p /opt/weblate && cd /opt/weblate
    cat > .env <<EOF
    WEBLATE_SITE_DOMAIN=weblate.example.com
    WEBLATE_ENABLE_HTTPS=1
    WEBLATE_SECURE_PROXY_SSL_HEADER=HTTP_X_FORWARDED_PROTO,https
    WEBLATE_IP_PROXY_HEADER=HTTP_X_FORWARDED_FOR
    [email protected]
    WEBLATE_ADMIN_PASSWORD=$(openssl rand -hex 16)
    WEBLATE_REGISTRATION_OPEN=0
    WEBLATE_REQUIRE_LOGIN=1
    [email protected]
    [email protected]
    WEBLATE_EMAIL_HOST=smtp.example.com
    [email protected]
    WEBLATE_EMAIL_HOST_PASSWORD=<SMTP_PASSWORD>
    POSTGRES_HOST=database
    POSTGRES_DB=weblate
    POSTGRES_USER=weblate
    POSTGRES_PASSWORD=$(openssl rand -hex 16)
    REDIS_HOST=cache
    REDIS_PASSWORD=$(openssl rand -hex 16)
    EOF
    chmod 600 .env
  2. Escribir el archivo docker-compose.yml

    Tres servicios: PostgreSQL, Valkey protegido con contraseña y Weblate. El puerto solo se publica en la interfaz local: solo nginx quedará expuesto a Internet.

    services:
      database:
        image: postgres:18.7-alpine
        restart: unless-stopped
        environment:
          POSTGRES_DB: weblate
          POSTGRES_USER: weblate
          POSTGRES_PASSWORD: "${POSTGRES_PASSWORD}"
        volumes:
          - weblate-db:/var/lib/postgresql
    
      cache:
        image: valkey/valkey:9.1.3
        restart: unless-stopped
        command: ["valkey-server", "--save", "60", "1", "--requirepass", "${REDIS_PASSWORD}"]
        volumes:
          - weblate-redis:/data
    
      weblate:
        image: weblate/weblate:2026.11.2.0
        restart: unless-stopped
        depends_on: [database, cache]
        env_file: .env
        ports:
          - "127.0.0.1:8080:8080"
        volumes:
          - weblate-data:/app/data
          - weblate-cache:/app/cache
        tmpfs: [/run, /tmp]
    
    volumes:
      weblate-db: {}
      weblate-redis: {}
      weblate-data: {}
      weblate-cache: {}
  3. Arrancar y comprobar

    El primer arranque crea la base de datos y la cuenta admin, lo que tarda de uno a dos minutos. El punto de salud debe responder 200, y el último comando muestra la contraseña de administrador:

    docker compose up -d
    docker compose ps
    curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8080/healthz/
    grep WEBLATE_ADMIN_PASSWORD .env

No publique una instancia abierta

Con WEBLATE_REGISTRATION_OPEN=1, cualquiera puede crear una cuenta en su instancia, y sin WEBLATE_REQUIRE_LOGIN=1 los proyectos públicos se leen sin cuenta — incluidas las cadenas de una función aún no anunciada. Mantenga los dos ajustes de esta guía y deje el puerto en 127.0.0.1.

Publicar Weblate en HTTPS con nginx

Cree /etc/nginx/sites-available/weblate con este bloque de servidor y actívelo con un enlace simbólico en sites-enabled. La cabecera X-Forwarded-Proto es imprescindible: es la que indica a Weblate que la petición llegó por HTTPS.

server {
    listen 80;
    server_name weblate.example.com;
    client_max_body_size 100m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        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 weblate.example.com

Después abra https://weblate.example.com/accounts/login/ e inicie sesión con el usuario admin.

Traducir su primer repositorio Git

Cree un proyecto y después un componente. Indique la URL del repositorio, la rama y la máscara de archivos de idioma — por ejemplo locales/*.json para vue-i18n o locale/*/LC_MESSAGES/django.po para Django. Weblate clona el repositorio, detecta los idiomas presentes y le propone añadir otros.

Para que devuelva las traducciones, abra Gestión › Claves SSH, genere la clave de la instancia y añádala como clave de despliegue con permiso de escritura en el repositorio; luego indique la URL de push del componente por SSH. Weblate agrupa los cambios y los envía como commits. Para que se actualice en cuanto un desarrollador envíe código, declare un webhook hacia https://weblate.example.com/hooks/github/ (también existen /hooks/gitlab/ y /hooks/gitea/).

Todo se controla también por la API REST, con el token que aparece en su perfil:

curl -s https://weblate.example.com/api/projects/ \
  -H "Authorization: Token <API_TOKEN>"

Conectar LibreTranslate para las sugerencias

Weblate ofrece sugerencias automáticas bajo cada cadena. Si tiene su propia instancia de LibreTranslate, abra Gestión › Servicios de traducción y añada el servicio LibreTranslate con la URL de su instancia y su clave de API. Los traductores ven entonces una propuesta en árabe, francés, inglés o español, que corrigen antes de aprobar: el texto no sale de sus servidores. El mismo ajuste existe a nivel de proyecto si quiere reservarlo a algunos.

Copias de seguridad y actualización

Hay dos cosas que respaldar: la base PostgreSQL y el volumen weblate-data, que contiene la clave secreta de la instancia, las claves SSH y los clones de los repositorios.

cd /opt/weblate
docker compose exec -T database pg_dump -U weblate weblate | gzip > weblate-db-$(date +%F).sql.gz
docker run --rm -v weblate_weblate-data:/data -v "$PWD":/backup alpine:3.22 \
  tar czf /backup/weblate-data-$(date +%F).tar.gz -C /data .

Para actualizar, lea primero las notas de versión en GitHub, haga una copia y cambie la etiqueta de la imagen; Weblate aplica sus migraciones al arrancar:

cd /opt/weblate
sed -i 's|weblate/weblate:2026.11.2.0|weblate/weblate:<NEW_VERSION>|' docker-compose.yml
docker compose pull && docker compose up -d

Weblate en un clic en ServOrbit

En un VPS de ServOrbit, Weblate se instala desde el Marketplace. El script despliega la imagen oficial con PostgreSQL y Valkey, genera la contraseña de administrador y las de los servicios, cierra el registro, exige iniciar sesión y configura el proxy inverso nginx en 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 de su área de cliente, y conecta su primer repositorio como arriba. Solo queda configurar el SMTP para invitar a sus traductores.

Compartir este artículoservorbit.com/ma-es/blog/autoalojar-weblate-vps-plataforma-traduccion