开源用户体验调查管理平台Formbricks

什么是 Formbricks ?

Formbricks 是一个开源的调查和体验管理平台,旨在帮助用户在应用内、网站、链接和电子邮件中收集用户和客户的反馈。它为开发者提供了一个隐私优先的替代方案,支持自托管或使用 Formbricks 云服务,并提供了丰富的数据分析工具。

体验调查管理平台,特别是基于开源基础构建的平台,相较于传统调查工具提供了更全面的客户互动视角。它们能够实时收集、分析和应用客户反馈,确保对客户旅程的深入理解。这种全面的洞察力有助于做出明智的决策,并提升客户满意度。

特点与优势

  • 无代码编辑器,多样问题类型;
  • 精准投放与团队协作;
  • 隐私保护,定制化;
  • 集成第三方工具;

应用场景

  • 用户旅程各阶段反馈收集
  • 应用内、网站、链接和电子邮件调查

安装

在群晖上以 Docker 方式安装。

本文写作时, Formbricks 镜像的 latest 版本对应为 v2.5.3

采用 docker-compose 安装,将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
version: "3"

services:
postgres:
image: postgres:15-alpine
container_name: formbricks-db
restart: always
volumes:
- ./data:/var/lib/postgresql/data
environment:
POSTGRES_DB: formbricks
POSTGRES_USER: formbricks
POSTGRES_PASSWORD: formbricks

formbricks:
image: ghcr.io/formbricks/formbricks:latest
restart: always
container_name: formbricks-web
depends_on:
- postgres
ports:
- 3374:3000
volumes:
- ./uploads:/home/nextjs/apps/web/uploads/
environment:
WEBAPP_URL: http://192.168.0.197:3374
DATABASE_URL: "postgresql://formbricks:formbricks@postgres:5432/formbricks?schema=public"
NEXTAUTH_SECRET: 9tjukHzjQSa8moZpFkCFQhX8cXq8Mzc8
CRON_SECRET: rX3vQ4xay7nuSrN5bGXlgbmBbFBZy96W
MAIL_FROM: wbsu2003@88.com
SMTP_HOST: smtp.88.com
SMTP_PORT: 465
SMTP_SECURE_ENABLED: 1
SMTP_USER: wbsu2003@88.com
SMTP_PASSWORD: <第三方邮件客户端密码>
SMTP_REJECT_UNAUTHORIZED_TLS: 1
ENCRYPTION_KEY: bairajGTe3KJM6PkmCKpnWx3gNDUK5qk
EMAIL_VERIFICATION_DISABLED: 1
PASSWORD_RESET_DISABLED: 0
SIGNUP_DISABLED: 0
INVITE_DISABLED: 0
  • postgres 的环境变量
可变
POSTGRES_DB 数据库库名
POSTGRES_USER 数据库用户
POSTGRES_PASSWORD 数据库用户对应的密码
  • formbricks 的环境变量

邮件部分的设置,还是以 88 邮箱为例;

可变
WEBAPP_URL 应用的访问地址
DATABASE_URL 数据库访问地址,根据主机、库名、账号、密码拼接而成
NEXTAUTH_SECRET 加密密钥,用于验证和确认双因素身份验证
CRON_SECRET 运行 cron 作业的 API 密钥
MAIL_FROM 系统发件人地址
SMTP_HOST smtp 服务器地址
SMTP_PORT smtp 服务器端口
SMTP_SECURE_ENABLED 启用 TLS
SMTP_USER 邮件用户
SMTP_PASSWORD 第三方邮件客户端密码
SMTP_REJECT_UNAUTHORIZED_TLS 如果设置为 0,服务器将接受连接而不要求授权来自提供的 CA 列表(默认值为 1
ENCRYPTION_KEY 密钥
EMAIL_VERIFICATION_DISABLED 电子邮件验证。如果启用电子邮件验证,则还必须设置 SMTP 设置
PASSWORD_RESET_DISABLED 如果启用密码重置功能,则还必须设置 SMTP 设置。
SIGNUP_DISABLED 禁用新用户创建帐户的功能。默认情况下,自托管禁用注册。
INVITE_DISABLED 禁用受邀用户创建帐户的功能
  • 以上提到的秘钥,均可使用 openssl rand -hex 32 生成;
  • DATABASE_URL:需要根据数据库的设置,填写对应的参数postgresql://<POSTGRES_USER>:<POSTGRES_PASSWORD>@postgres:5432/<POSTGRES_DB>?schema=public

更多环境变量参数及说明,可以在 https://github.com/formbricks/formbricks/blob/main/.env.example 中找到

然后执行下面的命令

1
2
3
4
5
6
7
8
9
10
# 新建文件夹 formbricks 和 子目录
mkdir -p /volume1/docker/formbricks/{data,uploads}

# 进入 formbricks 目录
cd /volume1/docker/formbricks

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3374 就能看到欢迎界面

创建管理员账号

输入用户名、邮件和密码

创建成功后,点 login 登录

跳转到登录界面

Login with Email,输入邮箱和密码

再次点 Login with Email 登录,成功后需要输入组织,例如公司名称

可以通过输入邮件邀请成员,当然也可以先跳过

根据需要选择选择想要调查的人群

选择你的行业

背景颜色和你的产品名称

根据您的选择,显示的界面会有差异,可能会看到一段代码,也可能会看到主界面

点右上角的 + 号,开始创建你的调查表

可以更换左侧的模版

Formbricks 本身支持多语言,但似乎只能启用了 Enterprise 许可证才行

软件具体的使用,可以看官方的文档:https://formbricks.com/docs/app-surveys/quickstart,可惜不支持中文,只能借助翻译软件

参考文档

formbricks/formbricks: Open Source Survey Platform
地址:https://github.com/formbricks/formbricks

Formbricks | Privacy-first Experience Management
地址:https://formbricks.com/

Comprehensive Guide to Self-Hosting Formbricks - Formbricks Docs
地址:https://formbricks.com/docs/self-hosting/overview