关于项目

市面上有许多自托管的Perplexity克隆项目。我选择自己开发一个，是因为对它们无法与其他自托管服务集成以及缺乏多用户支持感到不满。Perplexideez后端使用Postgres数据库，并对接Ollama或OpenAI兼容的API端点。它通过SearXNG实例来搜索网络。

目录

1. 关于项目
2. 功能
   1. 网络搜索
   2. 了解结论的来源
      1. 进一步学习
   3. 跟踪你最感兴趣的搜索
   4. 个性化体验
   5. 多用户支持与SSO
   6. 分享搜索结果
      1. 简洁的界面
      2. 访问控制
      3. 美观的嵌入式预览
   7. 部署
      1. 安全性
      2. 无状态设计
3. 部署
   1. 容器镜像
   2. Docker
   3. Kubernetes
   4. 裸金属服务器
   5. 关于依赖的一般说明
      1. SearXNG
   6. 环境变量
      1. 数据存储
      2. 应用配置
      3. SSO
         1. 注意事项
      4. SearXNG
      5. AI配置
         1. OpenAI
         2. Ollama
4. 构建技术
5. 本地开发
   1. 前提条件
   2. 安装
6. 路线图
7. 贡献
8. 许可证
9. 联系方式
10. 致谢

功能

网络搜索

让AI帮你完成繁琐的搜索结果筛选工作。

了解结论的来源

不用担心幻觉影响你的研究。只需将鼠标悬停在LLM插入的来源标注上，即可查看其引用的原始来源。点击它，就能直接跳转到该页面。

进一步学习

你的LLM会为你生成一些很棒的后续问题。这样，你就可以针对回复中感兴趣的内容继续提问，而无需再手动输入任何内容。

跟踪你最感兴趣的搜索

将你喜欢的搜索保存为收藏，这样你就永远不会丢失它们。

个性化体验

Perplexideez允许你根据不同的任务选择合适的模型。强大的环境变量和UI配置功能，可以帮助你确保自托管资源不会被过度使用。

多用户支持与SSO

Perplexideez支持多个用户账号，每个账号的数据相互隔离，并且可以使用OIDC SSO登录。你可以选择禁用注册、密码登录，或者两者都禁用。

分享搜索结果

简洁的界面

Perplexideez允许你将搜索结果的链接分享给他人。这样，你就可以轻松地把有趣的内容发送给朋友。

访问控制

在分享链接时，你可以确保只有指定的人才能访问。你可以重新生成链接ID、要求认证才能查看，或者直接禁用该链接。

美观的嵌入式预览

Perplexideez会为所有公开分享的链接生成精美的嵌入式预览。这样，接收者就能清楚地知道他们即将看到的内容。

部署

安全性

该项目提供的所有容器默认以非root用户运行。它们可以直接部署在无root权限的环境中。

无状态设计

除了正在进行中的生成任务外，这些容器都是完全无状态的。虽然阻止响应生成过程中退出的功能仍在开发中，但它们已经可以放心地部署在Kubernetes环境中，无需担心滚动更新或增加副本数量导致的问题。

部署

容器镜像

• ghcr.io/brunostjohn/perplexideez/migrate 用于执行必要的数据库迁移，并将你的Postgres实例准备好供Perplexideez使用。它仅需一个环境变量：DATABASE_URL。
• ghcr.io/brunostjohn/perplexideez/app 是应用程序本身。它需要下面提到的所有环境变量。

Docker

使用deploy/docker目录下的示例Compose文件来配置你自己的堆栈。这些文件包含了应用、SearXNG和数据库。请先使用.env.example作为起点，然后将其重命名为.env，并确保填写了下表中所有必需的值。该示例堆栈不提供Ollama或OpenAI兼容的API端点。这部分需要你自己设置。

Kubernetes

我仍在为这个应用编写 Helm Chart。编写 Helm Chart 是一个相当复杂的过程，所以我一直在拖延。目前，请参考 我的家庭实验室 Kubernetes 清单，作为在你的集群上部署此应用的示例。

裸金属

由于我们无法控制这些环境，并且它们之间存在很大差异，因此不支持不使用容器镜像进行部署。此类问题将被视为超出范围而直接关闭。

关于依赖的一般说明

SearXNG

• 根据我的测试，Perplexideez 很可能会触发 SearXNG 的限流机制。因此，除非有人找到更好的解决方案，否则最好将其禁用。
• 所有对 SearXNG 的请求 都会 失败，除非 启用了 JSON 输出。这一点非常重要，请务必调整你的配置。

环境变量

数据存储

名称	必需	值	示例
DATABASE_URL	✅	一个指向 Postgres 数据库的 URL。	postgresql://postgres:postgres@localhost:5432/postgres?schema=public

应用设置

名称	必需	值	示例
PUBLIC_BASE_URL	✅	您实例的公共访问 URL。	https://perplexideez.domain.com
RATE_LIMIT_SECRET	✅	使用 openssl rand -base64 32 生成的密钥，用于保护您的登录页面。	N/A
AUTH_SECRET	✅	使用 openssl rand -base64 32 生成的密钥，用于保护您的实例。	N/A
DISABLE_SIGN_UP	❌（默认：false）	是否禁用您实例的注册功能。	true/false
LOG_LEVEL	❌（默认：info）	应用应使用的日志级别。	trace/debug/info/warn/error
LOG_MODE	❌（默认：json）	是否以美观格式打印日志，或使用 JSON 日志格式。	pretty/json
METRICS_PORT	❌（默认：9001）	Prometheus 指标将在此端口暴露。	9001
SKIP_CSRF_CHECK	❌（默认：false）	使应用跳过 CSRF 检查。您很可能不需要此设置。只有在您清楚自己在做什么时才应启用。	true/false
USE_SECURE_COOKIES	❌（默认：true）	使应用使用安全 Cookie（仅通过 HTTPS 传输）。仅当您未公开应用时才应启用此设置。	true/false

SSO

名称	必需	值	示例
OIDC_CLIENT_ID	❌	您身份提供商的客户端 ID。	N/A
OIDC_CLIENT_SECRET	❌	您身份提供商的客户端密钥。	N/A
OIDC_ISSUER	❌	您身份提供商的 .well-known URL。	https://auth.authentik.com/application/o/perplexideez/.well-known/openid-configuration
OIDC_SCOPES	❌（默认：openid email profile）	您身份提供商应请求的 OIDC 范围。	openid email profile
PUBLIC_OIDC_NAME	❌	在应用 UI 中显示的身份提供商名称。	Zefir's Cloud
DISABLE_PASSWORD_LOGIN	❌（默认：false）	是否禁用密码认证并将其从 UI 中隐藏。	true/false

SSO 注意事项

• 此应用的重定向 URL 是 https://perplexideez.yourdomain.com/auth/callback/generic-oauth。

SearXNG

名称	必需	值	示例
SEARXNG_URL	✅	您 SearXNG 实例的 URL。	http://searxng:8080

AI 设置

名称	必需	值	示例
LLM_MODE	✅	ollama	使用哪个 LLM 提供商。
LLM_SPEED_MODEL	✅	用于“速度”模式下生成响应的 LLM。	gemma2:2b
LLM_BALANCED_MODEL	✅	用于“平衡”模式下生成响应的 LLM。	llama3.1:latest
LLM_QUALITY_MODEL	✅	用于“质量”模式下生成响应的 LLM。	qwen2.5:32b
LLM_EMBEDDINGS_MODEL	✅	用于文本嵌入的 LLM。	nomic-embed-text:latest
LLM_TITLE_MODEL	✅	用于生成聊天标题的 LLM。	llama3.1:latest
LLM_EMOJI_MODEL	✅	用于生成聊天表情符号的 LLM。	llama3.1:latest
LLM_IMAGE_SEARCH_MODEL	✅	用于图像搜索的 LLM。	llama3.1:latest
LLM_VIDEO_SEARCH_MODEL	✅	用于视频搜索的 LLM。	llama3.1:latest

OpenAI

仅当 LLM_MODE 设置为 openai 时才需要。

名称	必需	值	示例
OPENAI_BASE_URL	✅	您 OpenAI 兼容端点的基本 URL。	https://chat.domain.com/v1
OPENAI_API_KEY	✅	用于请求的 API 密钥。	sk-1234

Ollama

仅当 LLM_MODE 设置为 ollama 时才需要。

名称	必需	值	示例
OLLAMA_URL	✅	您 Ollama 实例的 URL。	http://ollama:11434

技术栈

• SvelteKit
• TailwindCSS
• Shadcn Svelte
• tRPC
• Prisma
• AuthJS
• TanStack Query
• Docker
• Kubernetes
• Langchain

本地开发

要启动本地副本并运行，请按照以下简单步骤操作。

先决条件

您需要一个 OpenAI API 令牌/OpenAI 兼容 API，或者在某处运行一个 Ollama 实例。开发容器设置仅提供 Postgres 和 SearXNG。

• pnpm

  corepack install pnpm
  

安装

1. 克隆仓库

   git clone https://github.com/brunostjohn/perplexideez.git
   

2. 安装依赖

   pnpm install
   

3. 使用 .env.example 创建 .env 文件
4. 启动开发环境

   pnpm dev:up
   

5. 更新数据库模式

   pnpm db:push
   

6. 运行应用

   pnpm dev
   

路线图

• 完全支持网络搜索
• 可共享的无认证链接
• 完全无状态化
  • 阻止生成过程中退出，以防万一
  • 使用 Redis 持久化内部生成状态
• 查看和探索图片/视频建议。
• 侧边栏上的收藏夹
• 确保部署正常工作
  • 完成用于 Kubernetes 部署的 Helm Chart
• 更多代理
  • 网络代理
  • 自托管应用代理

请参阅未解决问题，以获取完整的提案功能列表（以及已知问题）。

参与贡献

正是这些贡献，让开源社区成为一个令人惊叹的学习、启发和创作之地。您所做的任何贡献都备受赞赏。

如果您有改进建议，请直接 fork 该仓库并创建一个 pull request。您也可以简单地打开一个带有“enhancement”标签的问题。

别忘了给这个项目点个赞哦！再次感谢！

1. Fork 该项目
2. 创建您的功能分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到该分支 (git push origin feature/AmazingFeature)
5. 打开一个 pull request

许可证

根据 AGPL 许可证进行分发。

联系方式

布鲁诺·圣约翰 - me@brunostjohn.com

致谢

• Perplexica 团队，感谢他们实现了自托管搜索 AI 助手的基础。

Perplexideez 快速上手指南

Perplexideez 是一个可自托管的 AI 驱动搜索引擎，旨在提供类似 Perplexity 的体验。它支持多用户、SSO 单点登录，并允许你自由选择后端大模型（通过 Ollama 或 OpenAI 兼容接口），同时使用 SearXNG 进行网络搜索。

1. 环境准备

在部署前，请确保你的环境中具备以下组件：

• 容器运行时：推荐安装 Docker 和 Docker Compose。
• 数据库：需要运行一个 PostgreSQL 实例。
• 搜索引擎：需要运行一个 SearXNG 实例。
  • ⚠️ 重要配置：必须在 SearXNG 配置中启用 JSON 输出 (search_format: json)，否则请求将失败。建议禁用 SearXNG 的频率限制器，以免被 Perplexideez 触发。
• 大模型服务（二选一）：
  • Ollama：本地运行开源模型（推荐国内开发者使用，可配合国内镜像拉取模型）。
  • OpenAI 兼容接口：如官方 API 或国内中转服务（需具备 v1/chat/completions 等标准接口）。

2. 安装步骤

推荐使用 Docker Compose 进行部署。

第一步：获取配置文件

克隆项目或手动创建目录，获取示例配置文件：

mkdir perplexideez && cd perplexideez
# 下载示例 docker-compose 文件 (需自行从 GitHub 获取 deploy/docker 目录下的文件)
# 此处假设你已准备好 docker-compose.yml 和 .env.example
cp .env.example .env

第二步：配置环境变量

编辑 .env 文件，填入必要的配置信息。以下是核心变量说明：

# --- 数据存储 ---
DATABASE_URL=postgresql://postgres:your_password@db:5432/perplexideez?schema=public

# --- 应用设置 ---
PUBLIC_BASE_URL=https://your-domain.com
# 生成随机密钥: openssl rand -base64 32
RATE_LIMIT_SECRET=your_generated_secret_1
AUTH_SECRET=your_generated_secret_2

# --- SearXNG 设置 ---
SEARXNG_URL=http://searxng:8080

# --- AI 模型设置 (以 Ollama 为例) ---
LLM_MODE=ollama
OLLAMA_URL=http://ollama:11434

# 指定不同任务使用的模型 (确保这些模型已在 Ollama 中 pull 下来)
LLM_SPEED_MODEL=gemma2:2b
LLM_BALANCED_MODEL=llama3.1:latest
LLM_QUALITY_MODEL=qwen2.5:32b
LLM_EMBEDDINGS_MODEL=nomic-embed-text:latest
LLM_TITLE_MODEL=llama3.1:latest
LLM_EMOJI_MODEL=llama3.1:latest
LLM_IMAGE_SEARCH_MODEL=llama3.1:latest
LLM_VIDEO_SEARCH_MODEL=llama3.1:latest

注意：如果你使用 OpenAI 兼容接口，请将 LLM_MODE 设为 openai，并配置 OPENAI_BASE_URL 和 OPENAI_API_KEY，同时移除 Ollama 相关变量。

第三步：初始化数据库

在启动主应用前，必须先运行迁移容器来初始化数据库结构：

docker run --rm \
  -e DATABASE_URL="postgresql://postgres:your_password@db:5432/perplexideez?schema=public" \
  ghcr.io/brunostjohn/perplexideez/migrate

(请将 DATABASE_URL 替换为你实际的值)

第四步：启动服务

确保你的 docker-compose.yml 中包含了 app, searxng, db (以及可选的 ollama) 服务，然后启动：

docker compose up -d

3. 基本使用

1. 访问界面： 打开浏览器，访问你在 PUBLIC_BASE_URL 中设置的地址（例如 http://localhost:3000 或你的域名）。

2. 注册/登录：

   • 默认情况下允许注册。你可以在 .env 中设置 DISABLE_SIGN_UP=true 关闭注册。
   • 支持配置 OIDC SSO（如 Authentik, Keycloak 等），配置后登录页会显示相应的第三方登录按钮。

3. 开始搜索：

   • 在搜索框输入自然语言问题。
   • 系统会自动调用 SearXNG 搜索网络，并利用配置的 LLM 总结答案。
   • 查看来源：将鼠标悬停在回答中的引用标记上，即可查看原始网页链接，避免幻觉。
   • 追问：系统会根据回答自动生成相关的后续问题，点击即可继续深入探讨。

4. 管理搜索：

   • 点击星号图标可将重要搜索收藏。
   • 点击分享按钮可生成带权限控制的公开链接，支持精美的 Embed 预览。

5. 切换模型： 在界面设置或搜索栏附近，你可以针对不同任务（速度优先、平衡、质量优先）切换已配置的大模型。