零基础部署！Perplexica ClawCloud：5分钟搭建你的AI搜索引擎
项目地址: https://gitcode.com/GitHub_Trending/pe/Perplexica 还在为复杂的AI搜索部署烦恼？本文3步教你从零搭建云端智能搜索服务，无需专业运维知识，普通用户也能轻松上手。读完你将获得：
- 完整的Docker容器化部署流程
- 关键配置文件详解与示例
- 服务启动与验证的实操指南
- 常见问题解决方案
部署准备：环境与文件清单
部署Perplexica ClawCloud前需确保系统已安装Docker和Docker Compose。项目提供完整的容器化配置，核心文件包括：
- 编排配置：docker-compose.yaml 定义服务组合与网络关系
- 构建脚本：app.dockerfile 包含Node.js环境与应用构建步骤
- 配置模板：sample.config.toml 需复制为
config.toml并填写API密钥 - 启动脚本：entrypoint.sh 处理数据库迁移与服务启动
步骤一：配置文件修改
1.1 复制配置模板
cp sample.config.toml config.toml
1.2 关键参数配置
根据使用的AI模型提供商，在config.toml中填写对应API密钥：
[MODELS.OPENAI]
API_KEY = "你的OpenAI密钥"
[MODELS.GROQ]
API_KEY = "你的Groq密钥"
[API_ENDPOINTS]
SEARXNG = "http://searxng:8080" # 保持默认无需修改
1.3 容器网络配置
docker-compose.yaml已预设双服务架构，无需修改即可使用：
services:
searxng: # 元搜索引擎服务
ports:
- 4000:8080
app: # AI搜索主服务
ports:
- 3000:3000
步骤二：启动服务集群
2.1 构建并启动容器
docker-compose up -d --build
该命令会：
- 拉取SearXNG元搜索镜像
- 构建Perplexica应用镜像（基于app.dockerfile）
- 创建持久化数据卷（backend-dbstore和uploads）
- 启动服务并后台运行
2.2 验证服务状态
docker-compose ps
正常输出应显示两个服务均为"Up"状态：
Name Command State Ports
----------------------------------------------------------------------------------
perplexica_app_1 /home/perplexica/entrypoint.sh Up 0.0.0.0:3000->3000/tcp
perplexica_searxng_1 /sbin/tini -- /usr/local/b ... Up 0.0.0.0:4000->8080/tcp
步骤三：服务访问与功能验证
3.1 访问Web界面
打开浏览器访问 http://localhost:3000，出现以下界面表示部署成功：
3.2 核心功能测试
- 基础搜索：在输入框提问"什么是人工智能"，验证是否返回带来源引用的回答
- 多模型切换：通过设置页面切换不同AI模型（需提前配置对应API密钥）
- 文件上传：使用附件功能上传文档，测试知识库增强搜索
常见问题解决
4.1 服务启动失败
检查日志获取详细错误：
docker-compose logs app
常见原因包括：
- config.toml格式错误（使用TOML语法检查工具验证）
- 端口冲突（修改docker-compose.yaml中ports映射）
- 数据库迁移失败（执行
docker-compose exec app node migrate.js手动迁移）
4.2 AI模型无响应
确保：
- API密钥正确填写（区分不同模型提供商）
- 网络环境可访问模型API（如使用代理需配置容器网络）
- Ollama用户需在sample.config.toml中设置正确API_URL：
[MODELS.OLLAMA]
API_URL = "http://host.docker.internal:11434"
升级与维护
当需要更新版本时，参考docs/installation/UPDATING.md的步骤：
# 拉取最新代码
git pull
# 重建并重启服务
docker-compose up -d --build
点赞收藏本文，关注项目更新！下期将带来"Perplexica高级配置：自定义搜索引擎与知识库对接"。如有部署问题，欢迎在项目Issues中反馈。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
