什么是 Formbricks ?
Formbricks
是一个开源的调查和体验管理平台,旨在帮助用户在应用内、网站、链接和电子邮件中收集用户和客户的反馈。它为开发者提供了一个隐私优先的替代方案,支持自托管或使用Formbricks
云服务,并提供了丰富的数据分析工具。
体验调查管理平台,特别是基于开源基础构建的平台,相较于传统调查工具提供了更全面的客户互动视角。它们能够实时收集、分析和应用客户反馈,确保对客户旅程的深入理解。这种全面的洞察力有助于做出明智的决策,并提升客户满意度。
特点与优势
- 无代码编辑器,多样问题类型;
- 精准投放与团队协作;
- 隐私保护,定制化;
- 集成第三方工具;
应用场景
- 用户旅程各阶段反馈收集
- 应用内、网站、链接和电子邮件调查
安装
在群晖上以 Docker 方式安装。
本文写作时,
Formbricks
镜像的latest
版本对应为v2.5.3
;
采用 docker-compose
安装,将下面的内容保存为 docker-compose.yml
文件
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 中找到
然后执行下面的命令
# 新建文件夹 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