将单向演示转变为实时互动：Claper 部署与公众观众访问实践

来源：CSDN 原创文章
原标题：“让演示从单向讲解变成现场互动：Claper部署与公网参与实践”
说明：本文是在原文基础上的语气级改写。原文结构、步骤、命令和图片位置逻辑均保持不变。
原文内容遵循 CC 4.0 BY-SA 许可证。发布时请保留来源和许可证声明。

引言

在课堂教学、产品发布、工作汇报等场景中，把内容讲完，并不代表观众真正参与了进来。

很多时候，现场提问容易冷场，口头投票不方便统计，远程参会人员也很难及时表达想法。最后只能依赖会后问卷来收集反馈，效果往往并不理想。

Claper 可以让你将 PPT 或 PDF 文件上传到一个独立的演示平台，并在演示过程中加入实时评论、问卷、投票和问答等互动内容。观众只需要在浏览器中打开活动页面，就可以直接参与。主持人也可以在演示界面实时看到反馈。

这样一来，原本单向播放的幻灯片演示，就可以变成一个带有即时响应和现场互动的过程。

在这套方案中，Claper 负责演示文件和互动功能，PostgreSQL 用来存储平台数据，Docker 负责部署，cpolar 则将局域网内本地 4000 端口映射为公网访问地址。

该方案适用于课堂教学、内部培训、线上分享以及中小型活动。需要注意的是，Claper 不是直接安装在 PowerPoint 内部的插件。实际演示是在 Claper 平台中进行的。

通过 Claper 页面。

1. 一键使用 Docker 部署 Claper

只要你有一台支持 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

![这是一张显示 CentOS 7 系统终端界面的截图，对应 Claper 的 Docker 部署流程。界面内容为执行 `docker-compose up` 命令的运行反馈，显示正在拉取并下载部署 Claper 所需的多个 Docker 镜像，每个镜像的下载进度、已完成大小、总大小及耗时清晰呈现，部分镜像已完成下载，部分处于拉取状态。该截图直观展示了 Docker 部署过程中镜像拉取的实时进度，是部署步骤里启动服务环节的实操反馈记录。](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/a27a45b6-052e-4d38-bbb7-80a2c650bbac-1-3.png)

服务启动后，可以进入 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 端口是否可访问：

```Bash
curl http://192.168.42.140:4000

打开以下地址，你应该会看到 Claper 欢迎页面：

http://localhost:4000

注册并登录：

成功登录后，你可以进入管理后台：

接下来，你可以创建一个演示活动：

![图片展示的是 Claper 平台的“我的活动”页面。页面上方有“Active”“Finished”“Shared

with you”三个标签，当前选中“Active”。页面中部显示“Create your first event”，下方有一个红色框突出显示的“+ Create event”按钮，旁边有一个指向该按钮的箭头。该图片与文档中“Next, you can create a presentation event”内容对应，指导用户在登录成功后进入admin dashboard，点击“+ 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 互动演示平台已部署完成。

现在，你可以创建一个演示活动并邀请观众加入。无论他们是在现场扫描二维码，还是打开远程链接，观众都可以通过评论、问卷调查、投票等方式参与互动。他们还可以在过程中留下有用的反馈数据。

无论是会议室汇报、课堂讲座，还是线上发布会，Claper 都能将单向讲解转变为更具参与感的双向互动。

1. 安装 cpolar

如果你已经在本地部署了 Claper，并且已配置好评论、问卷调查和实时反馈功能，那么当你希望同事、客户或学生远程参与时，可能仍会遇到一个问题。他们无法

访问：

http://your-internal-ip:4000

原因很简单：该服务运行在局域网内，没有公网 IP 地址，因此外部设备无法访问它。

这时，cpolar 可以帮助解决公网访问问题。

cpolar 可以将运行在本地计算机上的服务（例如 SSH、Web 服务和数据库）映射到公网。这意味着，即使服务运行在家中、办公室或虚拟机内，也仍然可以通过公网 URL 进行访问。

以下是 cpolar 的安装步骤。

使用一键脚本安装：

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

安装完成后，运行以下命令检查 cpolar 服务状态。如果状态正常，则表示服务已成功启动。

sudo systemctl status cpolar

![图片展示的是在 Z4S

• VJFL 系统中，使用 sudo systemctl status cpolar 命令查看 cpolar 服务状态的终端输出结果。显示 cpolar 服务已加载，状态为 active (running)，自 9 月 17 日 16:51:03 以来运行，持续 8 秒。还列出了主进程 ID、任务数、内存使用量等信息，以及 CGroup 相关信息。该图片与文档中安装 cpolar 后检查服务状态的内容相关，直观呈现了服务正常运行的状态。](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/article-images/2026/07/de719673-d864-44f7-8bf8-6f87105189f3-1-12.png)

cpolar 安装并成功启动后，在浏览器中输入虚拟机主机 IP 加端口 9200，即可访问管理界面：

http://ip:9200

也可以在本地打开：

http://localhost:9200

使用在 cpolar 上注册的账号登录后

cpolar 官方网站，你将看到 cpolar Web 配置界面。之后的隧道配置可以在此页面完成。

1. 配置公网 URL

登录 cpolar Web UI 管理界面后，点击左侧控制面板中的 隧道管理 → 创建隧道。

按以下参数进行配置：

• 隧道名称：自定义值。本示例使用 claper。请确保不要与现有隧道名称重复。
• 协议：http
• 本地地址：4000
• 域名类型：随机域名
• 地区：选择 China Top

创建成功后，打开左侧的 在线隧道列表。你将看到刚刚生成的公网 URL。

接下来，在另一台电脑或手机上使用该地址，即可从公网访问本地部署的 Claper 页面。

成功访问后，页面如下所示：

1. 预留固定公网 URL

随机公网 URL 可以临时使用。但如果你想长期将服务分享给他人，地址频繁变化就不太方便。

因此，这里可以在 cpolar 中配置一个固定的二级子域名。配置完成后，这个公网 URL 就不会每次随机变化了。

点击左侧的 预留，然后选择 预留二级子域名。区域选择 China Top，然后设置一个二级子域名。

本示例中使用的子域名是 capler。你可以根据自己的需要自定义。填写备注信息后，点击 预留。

然后返回 cpolar Web UI 管理界面。点击左侧仪表盘中的 隧道管理 → 隧道列表。找到要配置的隧道，点击右侧的 编辑。

![这张图片展示了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

完成设置后，点击 更新。

更新完成后，再次打开 在线隧道列表。你会看到原来的随机公网 URL 已变成固定的二级子域名 URL。

最后，在任意设备的浏览器中打开该固定公网 URL。如果页面能够正常打开，则说明固定二级子域名公网地址已配置成功。

![这张图片展示的是一个网页登录界面，背景为深紫色，中间有输入框及紫色的“Join”按钮，顶部带有代表该服务的品牌标识。界面右上角有“About”和“Login”按钮，右侧还有卡通风格的装饰图案。结合上下文可知，该界面是 cpolar 的 Web UI 管理界面相关的操作页面，用于用户完成相关服务的配置与登录操作，是配置固定公共 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。

总体而言，这个方案的核心思路很清晰：

首先，使用 Docker 让 Claper 运行起来。然后使用 cpolar 将本地 4000 端口映射到公网。这样一来，无论是现场活动还是远程演示，观众都可以通过浏览器加入。

对于课堂、培训课程、产品演示和在线分享，这种方式比单纯播放 PPT 能产生更多反馈，也更容易让观众参与进来。