Превратите односторонние презентации в живое взаимодействие: развертывание Claper и практика доступа аудитории из публичной сети

Источник: оригинальная статья CSDN
Оригинальное название: «让演示从单向讲解变成现场互动：Claper部署与公网参与实践»
Примечание: это переработка оригинальной статьи на уровне тональности. Исходная структура, шаги, команды и логика размещения изображений сохранены.
Оригинальный материал распространяется по лицензии CC 4.0 BY-SA. При публикации сохраняйте указание источника и уведомление о лицензии.

---

Введение

В таких сценариях, как обучение в классе, презентации продуктов и рабочие выступления, завершение материала не всегда означает, что аудитория действительно приняла участие.

Часто живые вопросы и ответы проходят вяло. Голосовое голосование сложно подсчитать. Удаленным участникам также трудно вовремя поделиться своими мыслями. В итоге остается только собирать обратную связь через опрос после мероприятия, и результат часто оказывается не таким уж идеальным.

Claper позволяет загружать файлы PPT или PDF на независимую платформу для презентаций и добавлять во время выступления комментарии в реальном времени, опросы, голосования и сессии вопросов и ответов. Аудитории достаточно открыть страницу мероприятия в браузере, чтобы сразу принять участие. Ведущий также может видеть обратную связь в реальном времени прямо в интерфейсе презентации.

Таким образом, обычная односторонняя демонстрация слайдов превращается в процесс с мгновенными откликами и живым взаимодействием.

В этой конфигурации Claper отвечает за файлы презентаций и интерактивные функции. PostgreSQL хранит данные платформы. Docker обеспечивает развертывание. cpolar сопоставляет локальный порт 4000 внутри локальной сети с публичным URL-адресом.

Это решение подходит для обучения в классе, внутреннего обучения, онлайн-выступлений и небольших или средних мероприятий. Важно отметить: Claper — это не плагин, устанавливаемый напрямую в PowerPoint. Фактическая презентация проводится

через страницу Claper.

---

1. Разверните Claper с помощью Docker за один раз

Если у вас есть устройство с поддержкой Docker, вы сможете запустить Claper довольно быстро. Вам не потребуется сложная настройка окружения, и решение не привязано к какой-либо конкретной операционной системе.

В этом примере я использую CentOS 7. Давайте пройдем процесс развертывания.

Сначала установите и запустите его с помощью Docker, а также создайте каталог для хранения файлов:

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

Далее сохраните следующий содержимое в файл docker-compose.yml.

При первом запуске PostgreSQL, когда каталог данных пуст, пользователь и база данных создаются на основе переменных окружения POSTGRES_*:

POSTGRES_PASSWORD: claper
POSTGRES_USER: claper
POSTGRES_DB: claper

Вы можете сгенерировать SECRET_KEY_BASE с помощью следующей команды:

openssl rand -hex 64

Полная конфигурация docker-compose.yml выглядит следующим образом:

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:

Затем выполните следующую команду, чтобы запустить сервис:

# Запустить все сервисы
docker-compose up -d

После запуска сервиса вы можете войти в контейнер PostgreSQL, чтобы проверить его:

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

Если вы можете нормально попасть в приглашение psql, это означает, что пользователь и база данных были успешно созданы.

Вы также можете использовать пользователя postgres, чтобы просмотреть все роли:

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

![На этом изображении показан интерфейс командной строки системы CentOS 7, где выполняется команда для входа в контейнер PostgreSQL: docker exec -it claper-db-1 psql -U claper -d claper. После выполнения команды командная строка возвращает приглашение psql, версия 9.6.

24, и появится подсказка ввести «help» для получения справки. Эта операция соответствует шагу в документации «После запуска службы можно войти в контейнер PostgreSQL для проверки» и используется для проверки того, были ли успешно созданы пользователь и база данных.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/cdc2e614-7103-4028-a5b4-367a708009de-1-4.png)

После завершения запуска проверьте, доступен ли порт 4000:

curl http://192.168.42.140:4000

Откройте следующий адрес, и вы должны увидеть приветственную страницу Claper:

http://localhost:4000

Зарегистрируйтесь, а затем войдите в систему:

После успешного входа вы можете перейти в панель администратора:

Далее вы можете создать презентационное мероприятие:

![На изображении показана страница «Мои мероприятия» платформы Claper. В верхней части страницы расположены вкладки «Active», «Finished» и «Shared

с вами»: текущая выбранная вкладка — «Active». В средней части страницы отображается «Create your first event», ниже находится выделенная красной рамкой кнопка «+ Create event», рядом с ней — стрелка, указывающая на эту кнопку. Это изображение соответствует разделу документа «Next, you can create a presentation event» и показывает пользователю, что после успешного входа нужно перейти в панель администратора и нажать кнопку «+ Create event», чтобы создать демонстрационное мероприятие.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/23ea88f7-cc63-4285-86ba-ed3f4dc7a95b-1-9.png)

Следуйте инструкциям на странице.

Нажмите Create в правом верхнем углу, загрузите PPT или PDF, а затем настройте интерактивные компоненты. Рекомендуется включить комментарии и опросы, поскольку так интерактивный эффект будет более заметным.

На этом этапе интерактивная платформа для презентаций Claper развернута.

Теперь вы можете создать презентационное мероприятие и пригласить аудиторию присоединиться. Независимо от того, сканируют ли участники QR-код на месте или открывают удаленную ссылку, они могут участвовать с помощью комментариев, анкет, опросов и других способов. В процессе они также могут оставлять полезные данные обратной связи.

Будь то доклад в переговорной комнате, лекция в классе или онлайн-презентация продукта, Claper может превратить одностороннее объяснение в двустороннее взаимодействие с более сильным ощущением вовлеченности.

---

2. Установка cpolar

Если вы уже развернули Claper локально и настроили комментарии, опросы и функции обратной связи в реальном времени, вы все равно можете столкнуться с проблемой, когда захотите, чтобы коллеги, клиенты или студенты участвовали удаленно. Они не могут

доступ:

http://your-internal-ip:4000

Причина проста: сервис работает внутри локальной сети и не имеет публичного IP-адреса, поэтому внешние устройства не могут получить к нему доступ.

Именно здесь cpolar может помочь решить проблему публичного доступа.

cpolar может отображать сервисы, запущенные на вашем локальном компьютере, такие как SSH, веб-сервисы и базы данных, в публичный интернет. Это означает, что даже если сервис работает дома, в офисе или внутри виртуальной машины, к нему всё равно можно получить доступ через публичный URL-адрес.

Ниже приведены шаги установки cpolar.

Установите его с помощью скрипта в один клик:

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

После установки выполните следующую команду, чтобы проверить состояние службы cpolar. Если состояние нормальное, значит служба успешно запущена.

sudo systemctl status cpolar

После успешной установки и запуска cpolar введите в браузере IP-адрес хоста виртуальной машины и порт 9200, чтобы открыть интерфейс управления:

http://ip:9200

Вы также можете открыть его локально:

http://localhost:9200

После входа с учетной записью, зарегистрированной на

официальный сайт cpolar, вы увидите интерфейс веб-конфигурации cpolar. Дальнейшую настройку туннеля можно выполнить на этой странице.

---

3. Настройка публичного URL

После входа в интерфейс управления cpolar Web UI нажмите Управление туннелями → Создать туннель на левой панели управления.

Настройте его со следующими параметрами:

• Имя туннеля: произвольное значение. В этом примере используется claper. Убедитесь, что оно не совпадает с именем уже существующего туннеля.
• Протокол: http
• Локальный адрес: 4000
• Тип домена: случайный домен
• Регион: выберите China Top

После успешного создания откройте Список онлайн-туннелей слева. Вы увидите только что сгенерированный публичный URL.

Затем используйте этот адрес на другом компьютере или телефоне, и вы сможете получить доступ к локально развернутой странице Claper из публичного интернета.

После успешного доступа страница выглядит так:

---

4. Зарезервируйте фиксированный публичный URL

Случайный публичный URL можно использовать временно. Но если вы хотите делиться сервисом с другими в течение более длительного времени, адрес, который часто меняется, не очень удобен.

Поэтому здесь вы можете настроить фиксированный поддомен второго уровня в cpolar. После настройки этот публичный URL больше не будет каждый раз случайно изменяться.

Нажмите Reserve слева и выберите Reserve second-level subdomain. В качестве региона выберите China Top, затем задайте имя поддомена второго уровня.

В этом примере используется поддомен capler. Вы можете настроить его в соответствии со своими потребностями. После заполнения информации в примечании нажмите Reserve.

Затем вернитесь в интерфейс управления cpolar Web UI. Нажмите Tunnel Management → Tunnel List на левой панели. Найдите туннель, который хотите настроить, и нажмите Edit справа.

![На этом изображении показана страница списка туннелей в интерфейсе управления cpolar Web UI, соответствующая этапу действий после «возврата в интерфейс управления cpolar Web UI» в документе.

В левой части страницы расположена функциональная навигационная панель, содержащая такие пункты, как панель управления, управление туннелями (включая список туннелей, создание туннеля и другие опции), статус и официальный сайт cpolar; справа в области списка туннелей отображается туннель с номером 1 и именем «capler», его статус — «active», а в колонке действий доступны кнопки редактирования, перезапуска, остановки и другие функции. Эта страница предназначена для просмотра состояния туннеля после завершения настройки фиксированного поддомена второго уровня.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/ecb5e619-4f88-4fdb-bd10-99aa83a54b73-1-19.png)

Далее измените информацию о туннеле и настройте зарезервированный поддомен второго уровня для туннеля:

• Тип домена: выберите поддомен второго уровня
• Sub Domain: введите успешно зарезервированный поддомен второго уровня
• Регион: China Top

После завершения настроек нажмите Update.

После завершения обновления снова откройте Online Tunnel List. Вы увидите, что исходный случайный публичный URL изменился на фиксированный URL поддомена второго уровня.

Наконец, откройте фиксированный публичный URL в браузере на любом устройстве. Если страница открывается нормально, значит фиксированный публичный адрес поддомена второго уровня успешно настроен.

![На этом изображении показан веб-интерфейс входа: фон темно-фиолетовый, в центре находятся поля ввода и фиолетовая кнопка «Join», сверху размещен фирменный логотип сервиса. В правом верхнем углу есть кнопки «About» и «Login», справа также присутствуют декоративные элементы в мультяшном стиле. С учетом контекста это страница, связанная с Web UI cpolar, используемая для настройки и входа в соответствующий сервис, а также как точка входа, необходимая в процессе настройки фиксированного публичного URL.](https://we0-cms.oss-cn-beijing.

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

---

Заключение

Claper решает не проблему оформления PPT, а проблему вовлечения аудитории во время презентации.

Аудитория может просматривать материалы, отправлять вопросы и участвовать в опросах на одной и той же странице. Докладчик также может быстрее видеть обратную связь с места проведения. Такой подход особенно подходит для лекций, обучающих мероприятий и презентаций запусков, где требуется двусторонняя коммуникация.

Перед официальным использованием стоит заранее проверить несколько моментов:

1. Замените стандартный пароль базы данных в docker-compose.yml.
2. Используйте следующую команду, чтобы сгенерировать отдельный SECRET_KEY_BASE. Не используйте напрямую пример значения из этой статьи.

openssl rand -hex 64

1. После настройки публичного URL проверьте, нужно ли изменить ENDPOINT_HOST на фактический домен доступа. В противном случае ссылки-приглашения или связь в реальном времени могут по-прежнему указывать на IP-адрес в локальной сети.
2. Для образа PostgreSQL рекомендуется использовать версию, которая в настоящее время поддерживается проектом. Не рекомендуется долго продолжать использовать устаревший postgres:9.

В целом основная идея этого решения понятна:

Сначала запустить Claper с помощью Docker. Затем использовать cpolar, чтобы вывести локальный порт 4000 в публичный интернет. Таким образом, будь то офлайн-мероприятие или удаленная презентация, аудитория сможет подключиться через браузер.

Для занятий в аудиториях, тренингов, демонстраций продуктов и онлайн-выступлений такой подход дает больше обратной связи, чем простое воспроизведение PPT, а также облегчает участие аудитории.