Convierte presentaciones unidireccionales en interacción en vivo: implementación de Claper y práctica de acceso público para la audiencia
*Versión 1: Este artículo recorre el proceso completo de implementar Claper con Docker y PostgreSQL, y luego mapear el puerto local 4000 a Internet público con cpolar. Es adecuado para enseñanza en el aula, demostraciones de productos, formación en línea y escenarios de intercambio interactivo.

Convierte las presentaciones unidireccionales en interacción en vivo: despliegue de Claper y práctica de acceso público para la audiencia
Fuente: artículo original de CSDN
Título original: “让演示从单向讲解变成现场互动:Claper部署与公网参与实践”
Nota: Esta es una reescritura a nivel de tono basada en el artículo original. Se conservan la estructura original, los pasos, los comandos y la lógica de ubicación de las imágenes.
El contenido original sigue la licencia CC 4.0 BY-SA. Conserva el aviso de fuente y licencia al publicarlo.
Introducción
En escenarios como la enseñanza en el aula, los lanzamientos de productos y las presentaciones de trabajo, terminar de exponer el contenido no siempre significa que la audiencia haya participado realmente.
Muchas veces, las sesiones de preguntas y respuestas en vivo no logran dinamizarse. La votación verbal es difícil de contabilizar. A los asistentes remotos también les resulta complicado compartir sus ideas a tiempo. Al final, solo queda recurrir a una encuesta posterior al evento para recopilar comentarios, y el resultado a menudo no es tan ideal.
Claper permite subir archivos PPT o PDF a una plataforma de presentación independiente y añadir comentarios en tiempo real, encuestas, votaciones y preguntas y respuestas durante la presentación. La audiencia solo necesita abrir la página del evento en un navegador para participar directamente. El presentador también puede ver los comentarios en tiempo real desde la interfaz de presentación.
De este modo, lo que antes era una presentación de diapositivas unidireccional puede convertirse en un proceso con respuestas instantáneas e interacción en vivo.
En esta configuración, Claper se encarga de los archivos de presentación y las funciones interactivas. PostgreSQL almacena los datos de la plataforma. Docker gestiona el despliegue. cpolar asigna el puerto local 4000 dentro de la LAN a una URL pública.
Esta solución es adecuada para la enseñanza en el aula, la formación interna, las presentaciones en línea y eventos pequeños o medianos. Un aspecto a tener en cuenta: Claper no es un complemento que se instale directamente dentro de PowerPoint. La presentación real se realiza
a través de la página de Claper.

1. Desplegar Claper con Docker de una sola vez
Siempre que tengas un dispositivo compatible con Docker, puedes poner Claper en funcionamiento con bastante rapidez. No necesitas una configuración de entorno complicada, y no está ligado a un sistema operativo específico.
En este ejemplo, estoy usando CentOS 7. Veamos paso a paso el proceso de despliegue.
Primero, instálalo y ejecútalo con Docker, y crea un directorio para almacenar archivos:
mkdir -p /docker/Claper
cd /docker/Claper
![Esta imagen muestra las operaciones de comandos relacionadas con la inicialización del directorio durante el despliegue de Claper en la interfaz de línea de comandos de CentOS 7. En concreto, con permisos del usuario [root@zookeeper1 docker], primero se ejecuta el comando mkdir claper para crear un directorio llamado claper; luego se entra en ese directorio mediante el comando cd claper; finalmente, se ejecuta el comando ls para ver el contenido del directorio actual. Esto corresponde al paso “instalar y ejecutar Docker, y crear el directorio para almacenar archivos” dentro del proceso de despliegue de Claper.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/72da0e03-72c8-442c-aec2-e57a34ce8f08-claper-docker-cpolar-public-access-1.png)
A continuación, guarda el siguiente contenido como un archivo docker-compose.yml.
Cuando PostgreSQL se inicia por primera vez y el directorio de datos está vacío, crea el usuario y la base de datos según las variables de entorno POSTGRES_*:
POSTGRES_PASSWORD: claper
POSTGRES_USER: claper
POSTGRES_DB: claper
Puedes generar SECRET_KEY_BASE con el siguiente comando:
openssl rand -hex 64

La configuración completa de docker-compose.yml es la siguiente:
version: "3.0"
services:
db:
image:
postgres:9
volumes:
- ./postgres-data:/var/lib/postgresql/data
environment:
POSTGRES_PASSWORD: claper
POSTGRES_USER: claper
POSTGRES_DB: claper
healthcheck:
test: ["CMD-SHELL", "pg_isready -U claper"]
interval: 5s
timeout: 5s
retries: 10
app:
image: ghcr.io/claperco/claper:latest
user: "0:0"
ports:
- "4000:4000"
volumes:
- uploads:/app/uploads
environment:
DATABASE_URL: postgres://claper:claper@db:5432/claper
SECRET_KEY_BASE: 08fdecbc274177363ad3e5457ae910005216dc6d27b470cf69d9524e4fc6b951156b3c4709290054cb76778899ef
ENDPOINT_PORT: 4000
ENDPOINT_HOST: 192.168.42.140
MAX_FILE_SIZE_MB: 50
depends_on:
db:
condition: service_healthy
volumes:
uploads:
Luego ejecuta el siguiente comando para iniciar el servicio:
```Bash
# Iniciar todos los servicios
docker-compose up -d

Una vez iniciado el servicio, puedes entrar en el contenedor de PostgreSQL para comprobarlo:
docker exec -it claper-db-1 psql -U claper -d claper
Si puedes acceder normalmente al prompt de psql, significa que el usuario y la base de datos se han creado correctamente.
También puedes usar el usuario postgres para ver todos los roles:
docker exec -it claper-db-1 psql -U postgres -c '\du'

Una vez completado el inicio, verifica si el puerto 4000 es accesible:
curl http://192.168.42.140:4000

Abre la siguiente dirección y deberías ver la página de bienvenida de Claper:
http://localhost:4000

Regístrate y luego inicia sesión:

Después de iniciar sesión correctamente, puedes acceder al panel de administración:

A continuación, puedes crear un evento de presentación:

Siga las instrucciones que aparecen en la página.
Haga clic en Create en la esquina superior derecha, cargue un archivo PPT o PDF y, a continuación, configure los componentes interactivos. Se recomienda habilitar los comentarios y las encuestas, ya que esto hace que el efecto de interacción sea más evidente.

En este punto, la plataforma de presentaciones interactivas Claper ya se ha desplegado.
Ahora puede crear un evento de presentación e invitar al público a unirse. Ya sea escaneando un código QR en el lugar o abriendo un enlace remoto, la audiencia puede participar mediante comentarios, cuestionarios, encuestas y otros métodos. También puede dejar datos de retroalimentación útiles durante el proceso.
Ya sea para un informe en una sala de reuniones, una clase o un evento de lanzamiento en línea, Claper puede convertir una explicación unidireccional en una interacción bidireccional con una mayor sensación de participación.
2. Instalar cpolar
Si ya ha desplegado Claper localmente y ha configurado los comentarios, cuestionarios y funciones de retroalimentación en tiempo real, es posible que aún se encuentre con un problema cuando quiera que colegas, clientes o estudiantes participen de forma remota. Ellos no pueden
acceso:
La razón es sencilla: el servicio se está ejecutando dentro de una LAN y no tiene una dirección IP pública, por lo que los dispositivos externos no pueden acceder a él.
Aquí es donde cpolar puede ayudar a resolver el problema del acceso público.
cpolar puede asignar servicios que se ejecutan en tu equipo local, como SSH, servicios web y bases de datos, a Internet pública. Esto significa que, aunque el servicio se ejecute en casa, en una oficina o dentro de una máquina virtual, seguirá siendo accesible mediante una URL pública.
A continuación se muestran los pasos de instalación de cpolar.
Instálalo con el script de un solo clic:
sudo curl https://get.cpolar.sh | sh

Después de la instalación, ejecuta el siguiente comando para comprobar el estado del servicio cpolar. Si el estado es normal, significa que el servicio se ha iniciado correctamente.
sudo systemctl status cpolar

Después de instalar e iniciar correctamente cpolar, introduce en el navegador la IP del host de la máquina virtual más el puerto 9200 para acceder a la interfaz de administración:
También puedes abrirla localmente:
Después de iniciar sesión con la cuenta registrada en el
sitio web oficial de cpolar, verás la interfaz de configuración web de cpolar. La configuración posterior del túnel se puede completar desde esta página.

3. Configurar una URL pública
Después de iniciar sesión en la interfaz de administración Web UI de cpolar, haz clic en Gestión de túneles → Crear túnel en el panel izquierdo.
Configúralo con los siguientes parámetros:
- Nombre del túnel: valor personalizado. En este ejemplo se usa
claper. Asegúrate de que no duplique el nombre de un túnel existente. - Protocolo:
http - Dirección local:
4000 - Tipo de dominio: dominio aleatorio
- Región: elige
China Top

Una vez que la creación se complete correctamente, abre Lista de túneles en línea en la izquierda. Verás la URL pública que se acaba de generar.
A continuación, utiliza esta dirección en otro ordenador o teléfono, y podrás acceder a la página de Claper desplegada localmente desde Internet público.

Después de acceder correctamente, la página se ve así:

4. Reservar una URL pública fija
Se puede usar temporalmente una URL pública aleatoria. Pero si quieres compartir el servicio con otras personas durante un período más largo, una dirección que cambia con frecuencia no resulta muy conveniente.
Por eso, aquí puedes configurar un subdominio fijo de segundo nivel en cpolar. Después de la configuración, esta URL pública ya no cambiará aleatoriamente cada vez.

Haz clic en Reservar a la izquierda y selecciona Reservar subdominio de segundo nivel. Elige China Top como región y luego establece un nombre de subdominio de segundo nivel.
En este ejemplo, el subdominio utilizado es capler. Puedes personalizarlo según tus propias necesidades. Después de completar la información de la nota, haz clic en Reservar.

Luego vuelve a la interfaz de administración web de cpolar. Haz clic en Gestión de túneles → Lista de túneles en el panel izquierdo. Busca el túnel que quieres configurar y haz clic en Editar a la derecha.

A continuación, modifica la información del túnel y configura en el túnel el subdominio de segundo nivel reservado:
- Tipo de dominio: elige subdominio de segundo nivel
- Sub Domain: introduce el subdominio de segundo nivel reservado correctamente
- Región:
China Top
Después de completar la configuración, haz clic en Update.

Una vez completada la actualización, abre de nuevo Online Tunnel List. Verás que la URL pública aleatoria original se ha convertido en una URL fija con subdominio de segundo nivel.

Por último, abre la URL pública fija en el navegador de cualquier dispositivo. Si la página se abre correctamente, significa que la dirección pública fija con subdominio de segundo nivel se ha configurado correctamente.

Conclusión
Claper no resuelve el problema del diseño de las diapositivas PPT. Resuelve el problema de la participación durante una presentación.
El público puede ver el contenido, enviar preguntas y participar en encuestas desde la misma página. El presentador también puede ver más rápidamente los comentarios recibidos en el lugar. Este enfoque es especialmente adecuado para conferencias, formaciones y eventos de lanzamiento que requieren comunicación bidireccional.
Antes de usarlo formalmente, conviene comprobar algunos puntos con antelación:
- Reemplace la contraseña predeterminada de la base de datos en
docker-compose.yml. - Use el siguiente comando para generar una
SECRET_KEY_BASEindependiente. No utilice directamente el valor de ejemplo de este artículo.
openssl rand -hex 64
- Después de configurar la URL pública, compruebe si
ENDPOINT_HOSTdebe cambiarse al dominio de acceso real. De lo contrario, los enlaces de invitación o la comunicación en tiempo real podrían seguir apuntando a la IP de la LAN. - Para la imagen de PostgreSQL, se recomienda usar una versión actualmente compatible con el proyecto. No se recomienda seguir usando la versión antigua
postgres:9durante mucho tiempo.
En general, la idea central de esta solución es clara:
Primero, use Docker para poner Claper en marcha. Luego use cpolar para mapear el puerto local 4000 a internet público. De este modo, ya sea en un evento presencial o en una presentación remota, el público puede unirse a través de un navegador.
Para aulas, sesiones de formación, demostraciones de producto y presentaciones compartidas en línea, este enfoque genera más interacción que simplemente reproducir un PPT, y también facilita la participación del público.