ParadeDB Docker部署教程：3步启动PostgreSQL搜索服务

【免费下载链接】paradedb PostgreSQL for Search 项目地址: https://gitcode.com/gh_mirrors/pa/paradedb

ParadeDB是一个基于PostgreSQL的搜索解决方案，通过Docker可以快速部署并体验其强大的搜索功能。本教程将通过三个简单步骤，帮助你在几分钟内完成ParadeDB的Docker部署，无需复杂的配置即可拥有专业级的PostgreSQL搜索服务。

1. 准备工作：克隆项目与环境检查

首先，确保你的系统已安装Docker和Docker Compose。如果尚未安装，可以参考Docker官方文档进行安装。

接下来，克隆ParadeDB项目仓库：

git clone https://gitcode.com/gh_mirrors/pa/paradedb
cd paradedb

项目中提供了两种Docker Compose配置文件：

• docker/docker-compose.yml：适用于生产环境，直接拉取最新的ParadeDB镜像
• docker/docker-compose.dev.yml：适用于开发环境，本地构建Docker镜像

ParadeDB采用LSM树架构，提供高效的搜索性能和数据处理能力

2. 配置与启动：自定义参数并启动服务

进入项目的docker目录，编辑docker-compose.yml文件，设置安全的用户名、密码和数据库名称：

environment:
  POSTGRES_USER: myuser       # 替换为你的用户名
  POSTGRES_PASSWORD: mypassword # 替换为安全密码
  POSTGRES_DB: mydatabase     # 替换为数据库名称

保存配置后，执行以下命令启动服务：

cd docker
docker-compose up -d

Docker将自动拉取ParadeDB镜像并创建容器。启动过程中，bootstrap.sh脚本会自动安装必要的扩展（如pg_search、pg_ivm、vector等），并配置数据库环境。

3. 验证与连接：确认服务状态并开始使用

服务启动后，通过以下命令检查容器状态：

docker ps | grep paradedb

你应该能看到状态为"Up"的paradedb容器。此时，可以使用任何PostgreSQL客户端连接服务：

psql -h localhost -p 5432 -U myuser -d mydatabase

连接成功后，验证ParadeDB扩展是否已正确安装：

SELECT * FROM pg_extension WHERE extname = 'pg_search';

如果返回结果，则表示部署成功！你现在可以开始使用ParadeDB提供的强大搜索功能了。

ParadeDB支持多数据库复制和分布式部署，满足不同规模的应用需求

常见问题与解决方案

端口冲突怎么办？

如果5432端口已被占用，可以修改docker-compose.yml中的端口映射：

ports:
  - "5433:5432"  # 将主机端口5433映射到容器5432端口

如何持久化数据？

默认配置中已创建paradedb_data卷用于数据持久化，无需额外配置。如需备份数据，可使用：

docker volume inspect paradedb_data  # 查看数据卷位置

如何更新ParadeDB版本？

docker-compose pull
docker-compose down
docker-compose up -d

通过以上三个简单步骤，你已经成功部署了ParadeDB搜索服务。如需了解更多高级功能和配置选项，可以参考项目中的官方文档：docs/deploy/self-hosted/docker.mdx。现在，开始探索ParadeDB为PostgreSQL带来的强大搜索能力吧！🚀

【免费下载链接】paradedb PostgreSQL for Search 项目地址: https://gitcode.com/gh_mirrors/pa/paradedb