PriceBuddy 开源项目安装与配置指南

PriceBuddy 开源项目安装与配置指南

pricebuddy A self hostable app that tracks prices and sends you notifications when prices match your preferences 项目地址: https://gitcode.com/gh_mirrors/pr/pricebuddy

1. 项目基础介绍

PriceBuddy 是一个开源的、自托管的 Web 应用程序，允许用户比较不同在线零售商的产品价格。用户可以搜索产品，并查看该产品在不同在线零售商的价格。该应用提供了创建和管理商店、产品、价格历史图表可视化、通过 CSS 选择器、正则表达式或 JSONPath 提取产品信息等功能。它还支持单页应用程序（SPA）/JavaScript 渲染的网站抓取，产品标签分类，多用户支持，价格变动通知等特性。

主要编程语言：PHP

2. 项目使用的关键技术和框架

• Laravel：一个流行的 PHP Web 框架，用于快速开发应用程序。
• Filament：一个用于 Laravel 的优雅的仪表板 UI 库。
• SearXNG：一个用于搜索产品的集成工具。
• Docker：用于容器化应用程序，简化部署和运行。

3. 项目安装和配置准备工作

在开始安装之前，请确保您的系统满足了以下要求：

• Docker
• Docker Compose
• PHP环境（如果不用Docker）

项目详细安装步骤

使用 Docker 的安装步骤

1. 克隆项目到本地：

   git clone https://github.com/jez500/pricebuddy.git
   cd pricebuddy
   

2. 复制 .env.example 文件为 .env 并根据需要进行编辑：

   cp .env.example .env
   

3. 创建 .env 文件并设置环境变量，如果需要禁用联盟代码，可以设置 AFFILIATE_ENABLED=false。

4. 运行以下命令以启动 Docker 容器：

   touch .env && docker-compose up -d
   

5. 如果使用默认设置，应用将在 http://localhost:8080 上可用，使用默认的 用户名 admin@example.com 和密码 admin。

不使用 Docker 的安装步骤（不推荐）

不使用 Docker 安装 PriceBuddy 比较复杂，需要手动配置 PHP 环境、数据库和所有依赖项。建议查看 docker-compose.yml 和 docker/php.dockerfile 文件了解需要安装哪些服务和依赖。

以上步骤为基本的安装流程，详细配置和高级设置可能需要进一步查阅项目的文档和代码库中的配置文件。在安装过程中遇到问题时，可以查看项目的 README.md 文件获取更多帮助信息。

pricebuddy A self hostable app that tracks prices and sends you notifications when prices match your preferences 项目地址: https://gitcode.com/gh_mirrors/pr/pricebuddy