Fider：开源产品反馈平台完全指南：UserVoice替代方案的完整教程

Fider：开源产品反馈平台完全指南：UserVoice替代方案的完整教程

背景

在产品开发过程中，收集和管理用户反馈是持续改进产品的关键环节。UserVoice、Canny、ProductBoard 等 SaaS 服务提供了便捷的反馈管理功能，但存在数据隐私、费用高昂、定制受限等问题。

Fider 正是为解决这一需求而生的开源产品反馈平台。作为 UserVoice 的开源替代方案，Fider 提供了收集、组织和优先处理用户反馈的完整功能，同时支持完全私有化部署。

本文将提供一份保姆级教程，详细讲解 Fider 的部署与配置，帮助团队快速搭建用户反馈收集与管理平台。

一、项目概述

1.1 Fider 简介

Fider 是一款开源的产品反馈管理平台，GitHub Star 数超过 5K。它由 Gojek 团队开发，以简洁设计和易用性著称。

Fider 的核心特点：

• 开源自由：基于 MIT 协议，完全开源
• 用户投票：用户可以对反馈投票
• 标签管理：灵活的标签分类
• 评论互动：用户可以评论反馈
• 多站点：支持管理多个产品反馈
• 私有部署：数据完全自主掌控

1.2 核心功能

1.2.1 反馈管理

Fider 提供了完整的反馈管理能力：

• 提交反馈：用户提交功能请求和反馈
• 投票系统：用户对反馈投票
• 状态管理：跟踪反馈处理状态
• 标签分类：使用标签组织反馈
• 搜索过滤：快速找到相关反馈

1.2.2 用户互动

• 评论系统：用户可以对反馈评论
• 邮箱通知：反馈更新时通知用户
• 用户认证：支持多种登录方式
• 个人主页：用户管理自己的反馈

1.2.3 管理功能

• 站点管理：管理多个产品站点
• 角色权限：管理员和版主角色
• 自定义域名：支持自定义域名
• 主题定制：自定义站点外观

1.3 与其他方案对比

特性	Fider	UserVoice	Canny
部署方式	自托管/云	仅云	仅云
开源	是	否	否
免费计划	完全免费	限制功能	限制功能
定制性	高	中	中

二、Docker Compose 部署

2.1 环境准备

确保服务器已安装：

• Docker 20.10+
• Docker Compose 2.0+
• 内存：最低 512MB，推荐 1GB+
• 磁盘：至少 1GB

Fider 支持 PostgreSQL 和 MySQL 数据库。

2.2 创建部署目录

mkdir -p /opt/fider
cd /opt/fider

2.3 创建 docker-compose.yml

cat > docker-compose.yml << 'EOF'
version: "3.8"

services:
  fider:
    image: getfider/fider:latest
    container_name: fider
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://fider:your_db_password@db:5432/fider?sslmode=disable
      - JWT_SECRET=your-jwt-secret-change-this
      - URL=http://feedback.your-domain.com
      - EMAIL_NOREPLY=noreply@your-domain.com
      - EMAIL_FROM=noreply@your-domain.com
      - EMAIL_SMTP_HOST=smtp.example.com
      - EMAIL_SMTP_PORT=587
      - EMAIL_SMTP_USER=user@example.com
      - EMAIL_SMTP_PASSWORD=your_smtp_password
      - EMAIL_SMTP_FROM=noreply@your-domain.com
    depends_on:
      - db

  db:
    image: postgres:15-alpine
    container_name: fider-db
    environment:
      - POSTGRES_USER=fider
      - POSTGRES_PASSWORD=your_db_password
      - POSTGRES_DB=fider
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:
EOF

2.4 环境变量说明

变量	说明	示例
DATABASE_URL	数据库连接	postgres://…
JWT_SECRET	JWT 密钥	随机字符串
URL	站点 URL	https://…
EMAIL_*	邮件配置	SMTP 设置

生成 JWT 密钥：

openssl rand -hex 32

2.5 启动服务

# 启动服务
docker compose up -d

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f

2.6 初始化配置

首次访问 http://your-server-ip:3000，系统会引导创建第一个站点和管理员账户。

1. 创建站点：输入站点名称和域名
2. 创建管理员：设置管理员邮箱和密码
3. 完成配置：开始使用

2.7 Nginx 反向代理

cat > /etc/nginx/sites-available/fider << 'EOF'
server {
    listen 80;
    server_name feedback.your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF

ln -s /etc/nginx/sites-available/fider /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx

# 启用 HTTPS
apt-get install -y certbot python3-certbot-nginx
certbot --nginx -d feedback.your-domain.com

三、快速入门

3.1 界面布局

Fider 反馈站点主要包含：

• 首页：展示热门反馈
• 反馈列表：浏览所有反馈
• 提交反馈：提交新反馈
• 标签筛选：按标签筛选
• 搜索：搜索反馈

3.2 用户注册登录

用户可以使用以下方式登录：

• 邮箱注册：使用邮箱和密码注册
• 社交登录：Google、GitHub 等（需配置）

3.3 提交反馈

3.3.1 创建反馈

1. 点击"提交反馈"按钮
2. 填写反馈信息：
   • 标题：简洁明了
   • 描述：详细说明
   • 标签：选择相关标签
3. 点击"提交"

3.3.2 反馈示例

标题：希望支持深色模式
描述：目前网站只有浅色模式，希望能够支持深色模式，
      这样在夜间浏览时更加护眼。
标签：UI/UX

3.4 投票和评论

3.4.1 投票

用户可以对反馈投票，表示支持：

• 点击反馈右侧的投票按钮
• 投票数显示支持人数
• 已投票可以取消投票

3.4.2 评论

用户可以对反馈评论：

1. 打开反馈详情页
2. 在评论框输入内容
3. 点击发送评论

四、管理功能

4.1 反馈管理

4.1.1 查看反馈

管理员可以查看所有反馈：

• 全部反馈：所有用户提交的反馈
• 待处理：需要处理的反馈
• 已实现：已实现的反馈
• 已关闭：已关闭的反馈

4.1.2 更新状态

管理员可以更新反馈状态：

• 待处理：收到反馈，等待评估
• 已计划：计划在将来实现
• 进行中：正在实现
• 已实现：已完成实现
• 已关闭：不予处理

4.1.3 合并反馈

可以将相似的反馈合并：

1. 选择要合并的反馈
2. 点击"合并"
3. 选择保留的主反馈

4.2 标签管理

4.2.1 创建标签

1. 进入管理后台 → “标签”
2. 点击"新建标签"
3. 填写标签信息：
   • 名称：标签名称
   • 颜色：标签颜色
   • 描述：标签说明

4.2.2 常用标签示例

标签	说明
功能请求	新功能建议
Bug	问题报告
UI/UX	界面相关
性能	性能相关
文档	文档改进

4.3 页面定制

4.3.1 基本设置

在管理后台 → “设置” 中配置：

• 站点名称：反馈站点名称
• 标语：站点标语
• 标志：上传站点 Logo

4.3.2 主题定制

自定义站点外观：

• 主色调：网站主色调
• 背景色：背景颜色
• 文字色：文字颜色

4.3.3 自定义 CSS

添加自定义 CSS：

1. 进入管理后台 → “高级设置”
2. 输入自定义 CSS
3. 保存设置

4.4 邮箱通知

4.4.1 通知类型

可以配置以下通知：

• 新反馈：有新反馈时通知
• 新评论：有评论时通知
• 状态更新：状态变更时通知

4.4.2 SMTP 配置

在 .env 中配置 SMTP：

EMAIL_SMTP_HOST=smtp.example.com
EMAIL_SMTP_PORT=587
EMAIL_SMTP_USER=user@example.com
EMAIL_SMTP_PASSWORD=your_password

五、用户管理

5.1 用户角色

角色	说明
访客	未登录用户，仅能查看
用户	登录用户，可提交和投票
版主	管理反馈和评论
管理员	完全控制站点

5.2 添加版主

1. 进入管理后台 → “用户”
2. 找到目标用户
3. 点击"设为版主"

5.3 用户管理

管理员可以：

• 查看用户列表
• 禁用/启用用户
• 设置用户为管理员

六、集成配置

6.1 Webhook

配置 Webhook 接收反馈事件：

1. 进入管理后台 → “Webhooks”
2. 点击"添加 Webhook"
3. 输入目标 URL
4. 选择触发事件

6.1.1 触发事件

事件	说明
post.created	新反馈创建
post.updated	反馈更新
post.status_changed	状态变更
post.vote_changed	投票变更
comment.created	新评论

6.2 API

Fider 提供 RESTful API：

# 获取反馈列表
curl https://feedback.your-domain.com/api/posts

# 获取单个反馈
curl https://feedback.your-domain.com/api/posts/1

七、备份恢复

7.1 备份数据

# 备份数据库
docker compose exec -T db pg_dump -U fider > fider_backup_$(date +%Y%m%d).sql

7.2 恢复数据

# 恢复数据库
docker compose exec -T db psql -U fider < fider_backup_20260325.sql

八、常见问题

8.1 部署问题

Q：服务启动失败

A：检查数据库连接和配置：

docker compose logs fider

Q：邮件发送失败

A：检查 SMTP 配置是否正确。

8.2 使用问题

Q：如何关闭公开注册

A：在管理后台 → “设置” → “认证"中关闭"允许公开注册”。

Q：如何自定义域名

A：在 DNS 中添加 CNAME 记录指向你的服务器。

九、总结

Fider 作为开源的产品反馈平台，以其简洁的设计和完整的反馈管理功能，为团队提供了一个优秀的用户反馈收集解决方案。

通过本文的保姆级教程，读者应该已经掌握了：

1. Docker 部署：使用 Docker Compose 快速部署 Fider
2. 反馈管理：提交、投票、评论反馈
3. 状态管理：更新和管理反馈状态
4. 标签管理：创建和使用标签
5. 页面定制：自定义站点外观
6. 集成配置：Webhook 和 API

对于需要搭建用户反馈平台的团队，Fider 是一个值得考虑的开源选择。

---

© 版权归无边界科技所有，版权所有。