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

什么是 Formbricks ？

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

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

特点与优势

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

应用场景

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

安装

在群晖上以 Docker 方式安装。

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

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

yaml 复制代码

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 中找到

然后执行下面的命令

bash 复制代码

# 新建文件夹 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