每个人都可以，
拥有SSL证书

想快速拥有强大的向量数据库？本指南教你如何在Docker Desktop上零门槛部署Weaviate！从Docker Compose一键启动，到集成text2vec-openai，再到Python/Java客户端轻松连接，我们手把手解决所有配置难题。告别复杂，立即为你的AI语义搜索和推荐系统注入强劲动力！

在Docker Desktop环境中部署Weaviate向量数据库的完整流程，涵盖基础配置、高级功能实现及客户端连接验证等核心环节。

基础部署流程

环境准备

• 已安装Docker Desktop（Windows/macOS/Linux）
• 确保Docker Compose功能可用（现代版本已内置）

配置文件编写

创建docker-compose.yml文件，核心配置如下：

version: '3.4'
services:
  weaviate:
    image: semitechnologies/weaviate:1.30.2
    ports:
      - "8080:8080"
      - "50051:50051"
    environment:
      QUERY_DEFAULTS_LIMIT: 25
      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: "true"
      PERSISTENCE_DATA_PATH: "/var/lib/weaviate"
      ENABLE_API_BASED_MODULES: "true"
    volumes:
      - weaviate_data:/var/lib/weaviate
    restart: unless-stopped

volumes:
  weaviate_data:

配置要点说明：

• 镜像版本选择建议使用稳定版（如1.30.2）
• 端口映射包含HTTP和gRPC协议
• 数据持久化通过volume实现

服务启动

执行以下命令启动服务：

docker-compose up -d

验证与测试

容器状态检查

docker ps | grep weaviate

正常状态应显示Up状态

API接口测试

curl http://localhost:8080/v1/meta

成功响应示例：

{
  "hostname": "http://[::]:8080",
  "modules": {
    "text2vec-openai": {
      "version": "...",
      "documentationHref": "..."
    }
  }
}

高级功能配置

向量化模块集成

以text2vec-openai为例的配置：

environment:
  ENABLED_MODULES: "text2vec-openai"
  DEFAULT_VECTORIZER_MODULE: "text2vec-openai"
  OPENAI_APIKEY: "your-openai-api-key"

TLS加密配置

environment:
  TLS_CERTIFICATE: "/etc/ssl/certs/tls.crt"
  TLS_PRIVATE_KEY: "/etc/ssl/private/tls.key"
volumes:
  - ./certs:/etc/ssl/certs

客户端连接实现

Python客户端

from weaviate import Client

client = Client(
    url="http://localhost:8080"
)

print(client.is_ready())  # 应返回True

Java客户端

import io.weaviate.client.Config;
import io.weaviate.client.WeaviateClient;

public class Main {
    public static void main(String[] args) {
        Config config = new Config("http", "localhost:8080");
        WeaviateClient client = new WeaviateClient(config);
        System.out.println(client.isReady());
    }
}

常见问题处理

端口冲突解决方案

修改端口映射配置：

ports:
  - "8081:8080"

数据持久化故障排查

Linux/macOS权限修复命令：

sudo chown -R 1000:1000 ./weaviate_data

部署清理

执行以下命令停止并删除容器：

不懂技术也能玩转SSL证书，lcjmSSL主打操作简单，将复杂的加密流程拆解为小白也能看懂的直观步骤。没有繁琐的命令行，无需深厚的编程功底，点点鼠标即可获取证书。即使是免费用户，也能享受到专业级的证书管理服务，是开启HTTPS之路的最佳拍档。

docker-compose down -v