Guia Claper + cpolar: hospede uma plataforma de apresentações interativas do ambiente local ao acesso público

Introdução

Em cenários como ensino em sala de aula, 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 não gerando engajamento. A votação verbal é difícil de contabilizar. Participantes remotos também têm dificuldade para compartilhar suas opiniões a tempo. No fim, resta contar apenas com uma pesquisa pós-evento para coletar feedback, e o resultado muitas vezes não é tão ideal.

O Claper permite enviar arquivos PPT ou PDF para 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 na interface de apresentação.

Dessa forma, o 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 ensino em sala de aula, treinamento interno, compartilhamento on-line e eventos de pequeno a médio porte. Um ponto a observar: o Claper não é um plugin instalado diretamente no PowerPoint. A apresentação real é realizada por meio da página do Claper.

1. Implante 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 rapidamente. Você não precisa de uma configuração de ambiente complicada, e ele não fica preso a um sistema operacional específico.

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

Primeiro, instale e execute com Docker, e crie um diretório para armazenar 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 PostgreSQL para verificá-lo:

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

Se você conseguir entrar no prompt psql normalmente, 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 todas as funções:

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

Após a inicialização ser concluída, verifique se a porta 4000 está acessível:

curl http://192.168.42.140:4000

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

http://localhost:4000

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

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

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

Siga as instruções na página.

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

Neste ponto, a plataforma de apresentação interativa 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. Eles também podem deixar dados úteis de feedback durante o processo.

Seja 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 um maior senso de participação.

2. Instale o cpolar

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

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 executados 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 pode 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 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

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

Depois de 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 dos túneis pode ser concluída a partir desta página.

3. 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 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á o URL público que acabou de ser gerado.

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

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

4. Reservar um URL público fixo

Um URL público aleatório pode ser usado temporariamente. Mas, se você 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.

Portanto, aqui você pode configurar um subdomínio fixo de segundo nível no cpolar. Após a configuração, este URL público não mudará mais aleatoriamente todas as vezes.

Clique em Reservar à esquerda e selecione Reservar subdomínio de segundo nível. 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 próprias necessidades. Depois de preencher as informações da observação, clique em Reserve.

Em seguida, volte para a interface de gerenciamento da Web UI do cpolar. Clique em Gerenciamento de Túneis → Lista de Túneis no painel esquerdo. Encontre o túnel que deseja configurar e clique em Editar à direita.

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

• Tipo de domínio: escolha subdomínio de segundo nível

• Subdomínio: insira o subdomínio de segundo nível reservado com sucesso

• Região: China Top

Depois de 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 se tornou uma URL fixa de subdomínio de segundo nível.

Por fim, abra a URL pública fixa no navegador em 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.

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 de enquetes na mesma página. O apresentador também pode ver o feedback no local mais rapidamente. Essa abordagem é especialmente adequada para palestras, treinamentos e eventos de lançamento que exigem comunicação bidirecional.

Antes de usá-lo formalmente, há alguns pontos que vale a pena verificar com antecedência:

1. Substitua a senha padrão do banco de dados em docker-compose.yml.

2. Use o comando a seguir para gerar um SECRET_KEY_BASE independente. Não use diretamente o valor de exemplo deste artigo.

openssl rand -hex 64

1. Após configurar a URL pública, 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 usar uma versão atualmente compatível com o projeto. Não é recomendado continuar usando a versão mais antiga postgres:9 por muito tempo.

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

Primeiro, use o Docker para colocar o Claper em execução. Em seguida, use o cpolar para mapear a porta local 4000 para a internet pública. Dessa forma, seja em um evento presencial ou em uma apresentação remota, o público pode participar por meio de um navegador.

Para salas de aula, treinamentos, demonstrações de produtos e compartilhamentos online, essa abordagem gera mais feedback do que simplesmente reproduzir um PPT, além de facilitar a participação do público.

Perguntas frequentes sobre o Claper

O que é o Claper?

O Claper é uma ferramenta de apresentação interativa de código aberto. Ele ajuda a transformar apresentações comuns em PPT ou PDF em sessões online com enquetes, perguntas e respostas e feedback do público. É útil para salas de aula, treinamentos online, demonstrações de produtos e eventos ao vivo.

O Claper pode ser implantado com Docker?

Sim. O Claper oferece suporte à implantação auto-hospedada, adequada para usuários que desejam gerenciar seus próprios dados de apresentação, links de acesso e ambiente de implantação.

Por que o Claper precisa de acesso público?

Se o Claper for executado apenas localmente ou dentro de uma rede privada, usuários externos não conseguirão abrir a página da apresentação. Ferramentas como cpolar ou Cloudflare Tunnel podem expor o serviço local à internet pública, para que o público possa participar a partir de um navegador.

O que o cpolar faz nesta configuração do Claper?

O cpolar mapeia o serviço local do Claper, geralmente executado na porta 4000, para uma URL pública. Isso é útil para demonstrações temporárias, aulas online, compartilhamento remoto e testes rápidos.

Para quais cenários o Claper é adequado?

O Claper é adequado para apresentações que exigem participação real do público, como interação em sala de aula, treinamentos online, lançamentos de produtos, demonstrações para clientes, sessões de compartilhamento interno e eventos remotos.

Ferramentas relacionadas

• Claper: Uma plataforma de apresentações interativas de código aberto para adicionar enquetes, perguntas e respostas e feedback do público a apresentações PPT ou PDF.

• Docker: Uma plataforma de contêineres para executar rapidamente serviços web como o Claper.

• Docker Compose: Uma ferramenta para gerenciar vários serviços, como Claper e PostgreSQL, em uma única implantação.

• PostgreSQL: O serviço de banco de dados comumente usado na implantação auto-hospedada do Claper.

• cpolar: Uma ferramenta de tunelamento que pode expor um serviço Claper local a uma URL pública.

• Cloudflare Tunnel: Outra opção de tunelamento para expor serviços locais à internet pública.

• Nginx: Uma ferramenta comum de proxy reverso para vinculação de domínio e encaminhamento de serviços em implantações de longo prazo.

• Let’s Encrypt: Um serviço gratuito de certificado SSL para ativar HTTPS em domínios personalizados.

Links relacionados

• Documentação do Claper: Aprenda os fundamentos do Claper e da sua configuração auto-hospedada.

• Repositório do Claper no GitHub: Veja o código-fonte, as versões, os problemas e as informações do projeto.

• Imagem Docker do Claper: Verifique a imagem de contêiner do Claper e os detalhes do pacote.

• Documentação do cpolar: Aprenda a criar túneis HTTP, URLs públicas e configurações da interface Web.

• Documentação do Cloudflare Tunnel: Aprenda a expor serviços locais à internet pública.

• Documentação do Docker Compose: Aprenda a executar e gerenciar aplicações com vários contêineres.

• Imagem Docker do PostgreSQL: Verifique as variáveis de ambiente do contêiner PostgreSQL e as configurações de inicialização.