Transforme apresentações unidirecionais em interação ao vivo: implantação do Claper e prática de acesso público do público

Fonte: artigo original do CSDN
Título original: “让演示从单向讲解变成现场互动：Claper部署与公网参与实践”
Nota: Esta é uma reescrita em nível de tom baseada no artigo original. A estrutura original, as etapas, os comandos e a lógica de posicionamento das imagens foram preservados.
O conteúdo original segue a licença CC 4.0 BY-SA. Mantenha o aviso de fonte e licença ao publicar.

Introdução

Em cenários como aulas, lançamentos de produtos e apresentações de trabalho, concluir o conteúdo nem sempre significa que o público realmente participou.

Muitas vezes, as sessões de perguntas e respostas ao vivo acabam sem engajamento. Votações verbais são difíceis de contabilizar. Participantes remotos também têm dificuldade para compartilhar suas opiniões a tempo. No fim, resta apenas depender de uma pesquisa pós-evento para coletar feedback, e o resultado muitas vezes não é tão ideal.

O Claper permite carregar arquivos PPT ou PDF em uma plataforma de apresentação independente e adicionar comentários em tempo real, pesquisas, enquetes e perguntas e respostas durante a apresentação. O público só precisa abrir a página do evento em um navegador para participar diretamente. O apresentador também pode ver o feedback em tempo real a partir da interface da apresentação.

Dessa forma, aquilo que antes era uma apresentação de slides unidirecional pode se tornar um processo com respostas instantâneas e interação ao vivo.

Nesta configuração, o Claper gerencia os arquivos de apresentação e os recursos interativos. O PostgreSQL armazena os dados da plataforma. O Docker cuida da implantação. O cpolar mapeia a porta local 4000 dentro da LAN para uma URL pública.

Esta solução é adequada para aulas, treinamentos internos, compartilhamentos online e eventos de pequeno a médio porte. Um ponto a observar: o Claper não é um plugin instalado diretamente dentro do PowerPoint. A apresentação real é realizada

pela página do Claper.

1. Implantar o Claper com Docker de uma só vez

Desde que você tenha um dispositivo compatível com Docker, é possível colocar o Claper em funcionamento com bastante rapidez. Não é necessária uma configuração de ambiente complicada, e ele não fica vinculado a um sistema operacional específico.

Neste exemplo, estou usando o CentOS
7. Vamos percorrer o processo de implantação.

Primeiro, instale e execute com Docker e crie um diretório para armazenar os arquivos:

mkdir -p /docker/Claper
cd /docker/Claper

Em seguida, salve o conteúdo abaixo como um arquivo docker-compose.yml.

Quando o PostgreSQL é iniciado pela primeira vez e o diretório de dados está vazio, ele cria o usuário e o banco de dados com base nas variáveis de ambiente POSTGRES_*:

POSTGRES_PASSWORD: claper
POSTGRES_USER: claper
POSTGRES_DB: claper

Você pode gerar SECRET_KEY_BASE com o seguinte comando:

openssl rand -hex 64

A configuração completa do docker-compose.yml é a seguinte:

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:

Em seguida, execute o seguinte comando para iniciar o serviço:

# Iniciar todos os serviços
docker-compose up -d

Depois que o serviço iniciar, você pode entrar no contêiner do PostgreSQL para verificá-lo:

docker exec -it claper-db-1 psql -U claper -d claper

Se você conseguir acessar normalmente o prompt do psql, isso significa que o usuário e o banco de dados foram criados com sucesso.

Você também pode usar o usuário postgres para visualizar todos os papéis:

docker exec -it claper-db-1 psql -U postgres -c '\du'

![A imagem mostra, na linha de comando de um sistema CentOS 7, a interface em que é executado o comando usado para entrar no contêiner PostgreSQL, especificamente docker exec -it claper-db-1 psql -U claper -d claper. Após a execução do comando, a linha de comando retorna o prompt do psql, na versão 9.6.

24, e solicita que você digite “help” para obter ajuda. Essa operação corresponde à etapa “após iniciar o serviço, entrar no contêiner PostgreSQL para verificar” na documentação, confirmando se o usuário e o banco de dados foram criados com sucesso.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/cdc2e614-7103-4028-a5b4-367a708009de-1-4.png)

Depois que a inicialização for concluída, verifique se a porta 4000 está acessível:

curl http://192.168.42.140:4000

Abra o endereço a seguir, e você deverá ver a página de boas-vindas do Claper:

http://localhost:4000

Registre-se e, em seguida, faça login:

Após fazer login com sucesso, você poderá acessar o painel de administração:

Em seguida, você pode criar um evento de apresentação:

![A imagem mostra a página “Meus eventos” da plataforma Claper. Na parte superior da página, há as abas “Active”, “Finished” e “Shared

com você”, com a aba “Active” selecionada no momento. No centro da página aparece “Create your first event”, e abaixo há um botão “+ Create event” destacado por uma caixa vermelha, com uma seta apontando para esse botão. A imagem corresponde ao conteúdo “Next, you can create a presentation event” no documento, orientando o usuário a acessar o admin dashboard após fazer login com sucesso e clicar no botão “+ Create event” para criar um evento de apresentação.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/23ea88f7-cc63-4285-86ba-ed3f4dc7a95b-1-9.png)

Siga as instruções exibidas na página.

Clique em Create no canto superior direito, carregue um arquivo PPT ou PDF e, em seguida, configure os componentes interativos. Recomenda-se habilitar comentários e enquetes, pois isso torna o efeito de interação mais evidente.

Neste ponto, a plataforma de apresentações interativas Claper foi implantada.

Agora você pode criar um evento de apresentação e convidar o público a participar. Seja escaneando um código QR no local ou abrindo um link remoto, o público pode participar por meio de comentários, pesquisas, enquetes e outros métodos. Durante o processo, também é possível deixar dados úteis de feedback.

Seja em um relatório em sala de reuniões, uma aula em sala de aula ou um evento de lançamento online, o Claper pode transformar uma explicação unidirecional em uma interação bidirecional com maior sensação de participação.

1. Instalar o cpolar

Se você já implantou o Claper localmente e configurou os recursos de comentários, pesquisas e feedback em tempo real, ainda pode encontrar um problema quando quiser que colegas, clientes ou alunos participem remotamente. Eles não conseguem

acesso:

http://seu-ip-interno:4000

O motivo é simples: o serviço está sendo executado dentro de uma LAN e não possui um endereço IP público, portanto dispositivos externos não conseguem acessá-lo.

É aqui que o cpolar pode ajudar a resolver o problema de acesso público.

O cpolar pode mapear serviços em execução no seu computador local, como SSH, serviços Web e bancos de dados, para a internet pública. Isso significa que, mesmo que o serviço esteja sendo executado em casa, em um escritório ou dentro de uma máquina virtual, ele ainda poderá ser acessado por meio de uma URL pública.

Abaixo estão as etapas de instalação do cpolar.

Instale-o com o script de instalação em um clique:

sudo curl https://get.cpolar.sh | sh

Após a instalação, execute o seguinte comando para verificar o status do serviço cpolar. Se o status estiver normal, o serviço foi iniciado com sucesso.

sudo systemctl status cpolar

![A imagem mostra a saída do terminal no sistema Z4S

• VJFL ao usar o comando sudo systemctl status cpolar para verificar o status do serviço cpolar. Ela indica que o serviço cpolar foi carregado e está com o status active (running), em execução desde 17 de setembro às 16:51:03, por 8 segundos. Também são exibidos o ID do processo principal, o número de tarefas, o uso de memória e outras informações, além de dados relacionados ao CGroup. A imagem está relacionada à verificação do status do serviço após a instalação do cpolar no documento e mostra de forma visual que o serviço está em execução normalmente.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/de719673-d864-44f7-8bf8-6f87105189f3-1-12.png)

Depois que o cpolar for instalado e iniciado com sucesso, insira o IP do host da máquina virtual mais a porta 9200 no navegador para acessar a interface de gerenciamento:

http://ip:9200

Você também pode abri-la localmente:

http://localhost:9200

Após fazer login com a conta registrada no

site oficial do cpolar, você verá a interface de configuração Web do cpolar. A configuração posterior do túnel pode ser concluída nessa página.

1. Configurar uma URL pública

Depois de fazer login na interface de gerenciamento Web UI do cpolar, clique em Gerenciamento de túneis → Criar túnel no painel à esquerda.

Configure-o com os seguintes parâmetros:

• Nome do túnel: valor personalizado. Este exemplo usa claper. Certifique-se de que ele não duplique o nome de um túnel existente.
• Protocolo: http
• Endereço local: 4000
• Tipo de domínio: domínio aleatório
• Região: escolha China Top

Depois que a criação for concluída com sucesso, abra Lista de túneis online à esquerda. Você verá a URL pública que acabou de ser gerada.

Em seguida, use esse endereço em outro computador ou telefone, e você poderá acessar pela internet pública a página do Claper implantada localmente.

Após o acesso bem-sucedido, a página fica assim:

1. Reservar um URL público fixo

Um URL público aleatório pode ser usado temporariamente. Mas, se quiser compartilhar o serviço com outras pessoas por um período mais longo, um endereço que muda com frequência não é muito conveniente.

Então, aqui, você pode configurar um subdomínio de segundo nível fixo no cpolar. Após a configuração, esse URL público não mudará mais aleatoriamente a cada vez.

Clique em Reserved à esquerda e selecione Reserve second-level subdomain. Escolha China Top como região e, em seguida, defina um nome de subdomínio de segundo nível.

Neste exemplo, o subdomínio usado é capler. Você pode personalizá-lo de acordo com suas necessidades. Depois de preencher as informações da observação, clique em Reserve.

Em seguida, volte para a interface de gerenciamento Web UI do cpolar. Clique em Tunnel Management → Tunnel List no painel esquerdo. Encontre o túnel que deseja configurar e clique em Edit à direita.

![Esta imagem mostra a página da lista de túneis da interface de gerenciamento Web UI do cpolar, correspondente à etapa de operação no documento após “voltar para a interface de gerenciamento Web UI do cpolar”.]

A barra lateral esquerda da página é a barra de navegação de funções, contendo opções como Painel, Gerenciamento de túneis (incluindo Lista de túneis, Criar túnel etc.), Status e site oficial do cpolar; a área da lista de túneis à direita exibe o túnel de número 1, com o nome “capler”, cujo status é “active”. Na coluna de operações há botões de função como editar, reiniciar e parar. Esta página é a interface usada para verificar o status do túnel após concluir a configuração do subdomínio fixo de segundo nível.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/ecb5e619-4f88-4fdb-bd10-99aa83a54b73-1-19.png)

Em seguida, modifique as informações do túnel e configure no túnel o subdomínio de segundo nível reservado:

• Tipo de domínio: escolha subdomínio de segundo nível
• Sub Domain: insira o subdomínio de segundo nível reservado com sucesso
• Região: China Top

Após concluir as configurações, clique em Update.

Depois que a atualização for concluída, abra novamente a Lista de túneis online. Você verá que a URL pública aleatória original foi alterada para uma URL fixa de subdomínio de segundo nível.

Por fim, abra a URL pública fixa no navegador de qualquer dispositivo. Se a página abrir normalmente, isso significa que o endereço público fixo do subdomínio de segundo nível foi configurado com sucesso.

![Esta imagem mostra uma interface de login web, com fundo roxo-escuro, campos de entrada ao centro e um botão roxo “Join”. Na parte superior há o logotipo da marca que representa o serviço. No canto superior direito há botões “About” e “Login”, e à direita há também elementos decorativos em estilo cartoon. Pelo contexto, essa interface é uma página de operação relacionada à interface de administração Web UI do cpolar, usada pelos usuários para concluir a configuração e o login dos serviços relacionados, sendo a página de entrada necessária no processo de configuração de uma URL pública fixa.](https://we0-cms.oss-cn-beijing.

aliyuncs.com/cms-assets/article-images/2026/07/0d8ae4da-3ced-4377-9830-09cc8bc11487-1-22.png)

Conclusão

O Claper não resolve o problema do layout de PPT. Ele resolve o problema da participação durante uma apresentação.

O público pode visualizar o conteúdo, enviar perguntas e participar em sondagens na mesma página. O apresentador também consegue ver mais rapidamente o feedback no local. Esta abordagem é especialmente adequada para aulas, formações e eventos de lançamento que exigem comunicação bidirecional.

Antes de o utilizar formalmente, vale a pena verificar antecipadamente alguns pontos:

1. Substitua a palavra-passe padrão da base de dados em docker-compose.yml.
2. Utilize o seguinte comando para gerar uma SECRET_KEY_BASE independente. Não utilize diretamente o valor de exemplo deste artigo.

openssl rand -hex 64

1. Depois de configurar o URL público, verifique se ENDPOINT_HOST deve ser alterado para o domínio de acesso real. Caso contrário, os links de convite ou a comunicação em tempo real ainda poderão apontar para o IP da LAN.
2. Para a imagem do PostgreSQL, recomenda-se utilizar uma versão atualmente suportada pelo projeto. Não é recomendado continuar a utilizar a versão antiga postgres:9 durante muito tempo.

No geral, a ideia central desta solução é clara:

Primeiro, utilize o Docker para colocar o Claper em execução. Em seguida, utilize o cpolar para mapear a porta local 4000 para a internet pública. Desta forma, seja num evento presencial ou numa apresentação remota, o público pode participar através de um navegador.

Para salas de aula, sessões de formação, demonstrações de produto e partilhas online, esta abordagem gera mais feedback do que simplesmente reproduzir um PPT, além de facilitar a participação do público.