部署Weaviate向量数据库服务需要申请的端口权限：9060   && 50055

（1）验证Weaviate向量数据库新机器的网络访问权限 

telnet  10.127.20.16 
端口：9060  && 50055 访问权限

若验证Weaviate向量数据库内网间的访问权限未开通，开发申请相关网络权限

         镜像：semitechnologies/weaviate:1.27.0

（3）防火墙规则设置（需要确认是否开启，未开启则无需设置）

# Ubuntu / UFW
sudo ufw allow from 10.127.20.0/24 to any port 9060 proto tcp

docker 最低配置 24.x+  含 Docker Compose v2

       执行验证脚本（http方式调用）

curl -H "Authorization: Bearer eUkX6Htx2Q1ITIEM@weaviate" \
     -H "Content-Type: application/json" \
     http://127.0.0.1:8060/v1/meta



curl -H "Authorization: Bearer eUkX6Htx2Q1ITIEM@weaviate" \
     -H "Content-Type: application/json" \
     -X POST http://127.0.0.1:8060/v1/graphql \
     -d '{"query":"{Get{DiskTest{msg}}}"}'


curl -H "Authorization: Bearer eUkX6Htx2Q1ITIEM@weaviate" \
     -H "Content-Type: application/json; charset=utf-8" \
     -X POST http://127.0.0.1:8060/v1/objects \
     -d '{"class":"DiskTest","properties":{"msg":"挂载磁盘测试数据"},"vector":[0.1,0.2]}'


curl -H "Authorization: Bearer eUkX6Htx2Q1ITIEM@weaviate" \
     -X DELETE http://127.0.0.1:8060/v1/schema/DiskTest

机器准备部署目录及机器（单台操作举例）

mkdir -p /app/deployee/test_env/weaviate/data
mkdir -p /app/deployee/test_env/weaviate/logs
sudo chmod -R 777 /app/deployee/test_env/weaviate

chown -R 1000:1000 /app/deployee/test_env/weaviate/data
chmod -R u+rwx /app/deployee/test_env/weaviate/data
chown -R 1000:1000 /app/deployee/test_env/weaviate/logs
chmod -R u+rwx /app/deployee/test_env/weaviate/logs

# 给 Weaviate  向量数据库 提供足够内存映射空间
# 虚拟内存
echo "vm.max_map_count=262144" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p

# 文件打开数
echo "* soft nofile 65536" | sudo tee -a /etc/security/limits.conf
echo "* hard nofile 65536" | sudo tee -a /etc/security/limits.conf

echo "环境初始化完成"

     创建文件 /app/deployee/test_env/weaviate/docker-compose.yml

name: weaviate-test
services:
  weaviate:
    image: semitechnologies/weaviate:1.27.0
    container_name: weaviate-test
    restart: always
    ports:
      - "9060:8080"
      - "50055:50051"
    volumes:
      - /app/deployee/test_env/weaviate/data:/var/lib/weaviate
      - /app/deployee/test_env/weaviate/logs:/var/log/weaviate
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - /app/deployee/test_env/weaviate/.env
    environment:
      - TZ=Asia/Shanghai
      - PERSISTENCE_DATA_PATH=/var/lib/weaviate
      - PERSISTENCE_MEMTABLES_FLUSH_INTERVAL=1s
      - AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED=false
      - AUTHENTICATION_APIKEY_ENABLED=true
      - AUTHENTICATION_APIKEY_ALLOWED_KEYS=${AUTH_API_KEY}
      - AUTHENTICATION_APIKEY_USERS=${AUTH_API_USER}
      - AUTHORIZATION_ADMINLIST_ENABLED=true
      - AUTHORIZATION_ADMINLIST_USERS=${AUTH_API_USER}
      - AUTOSCHEMA_ENABLED=false
      - QUERY_DEFAULTS_LIMIT=100
      - LOG_LEVEL=info
      - GOMEMLIMIT=6GiB
      - QUERY_LISTEN_HOST=0.0.0.0
      - QUERY_LISTEN_PORT=8080
      - GRPC_PORT=50051

      # ✅ 正确单机配置（1.27 专用）
      - CLUSTER_STATE=off
      - CLUSTER_GOSSIP_BIND_PORT=7100
      - CLUSTER_DATA_BIND_PORT=7101
      - CLUSTER_HOSTNAME=node1
      - RAFT_BOOTSTRAP_EXPECT=1
      - RAFT_JOIN=node1:8300
      - RAFT_BIND_PORT=8300
      - LOG_FORMAT=json          # 日志格式
      - LOG_FILE=/var/log/weaviate/weaviate.log  # 日志文件路径

实际部署生效的配置（验证版存在问题，不适配业务，按需完成部署配置即可）：

name: weaviate-test

services:
  weaviate:
    image: semitechnologies/weaviate:1.27.0
    container_name: weaviate-test
    restart: always
    user: "1000:1000"
    ports:
      - "9060:8080"
      - "50055:50051"
    volumes:
      - /app/deployee/test_env/weaviate/data:/var/lib/weaviate
      - /app/deployee/test_env/weaviate/logs:/var/log/weaviate
      - /etc/localtime:/etc/localtime:ro
    env_file:
      - /app/deployee/test_env/weaviate/.env
    environment:
      - TZ=Asia/Shanghai
      - PERSISTENCE_DATA_PATH=/var/lib/weaviate
      - PERSISTENCE_MEMTABLES_FLUSH_INTERVAL=1s
      - AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED=false
      - AUTHENTICATION_APIKEY_ENABLED=true
      - AUTHENTICATION_APIKEY_ALLOWED_KEYS=${AUTH_API_KEY}
      - AUTHENTICATION_APIKEY_USERS=${AUTH_API_USER}
      - AUTHORIZATION_ADMINLIST_ENABLED=true
      - AUTHORIZATION_ADMINLIST_USERS=${AUTH_API_USER}
      - AUTOSCHEMA_ENABLED=false
      - QUERY_DEFAULTS_LIMIT=100
      - LOG_LEVEL=info
      - LOG_FORMAT=json
      - GOMEMLIMIT=6GiB
      - QUERY_LISTEN_HOST=0.0.0.0
      - QUERY_LISTEN_PORT=8080
      - GRPC_PORT=50051
      - CLUSTER_STATE=off
      - CLUSTER_GOSSIP_BIND_PORT=7100
      - CLUSTER_DATA_BIND_PORT=7101
      - CLUSTER_HOSTNAME=node1
      - RAFT_BOOTSTRAP_EXPECT=1
      - RAFT_JOIN=node1:8300
      - RAFT_BIND_PORT=8300
    entrypoint: ["/bin/sh", "-c"]
    command:
      - "exec /bin/weaviate --host 0.0.0.0 --port 8080 --scheme http >> /var/log/weaviate/weaviate.log 2>&1"
    mem_limit: 8g
    cpus: 4
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://127.0.0.1:8080/v1/.well-known/ready"]
      interval: 15s
      timeout: 5s
      retries: 3
      start_period: 30s
    networks:
      - weaviate-network

networks:
  weaviate-network:
    driver: bridge

日志文件会一直增长，定时做个清理：

# crontab 每周日凌晨清空
0 0 * * 0 truncate -s 0 /app/deployee/test_env/weaviate/logs/weaviate.log

③ 在 /app/deployee/test_env/weaviate/ 目录下创建 .env 文件

# 认证账号密码（你要的配置）
AUTH_API_KEY=admin-key-001
AUTH_API_USER=admin

# 第 1 步：启动 Node-1
cd /app/deployee/test_env/weaviate && docker compose up -d
# 等待 30 秒
sleep 30

echo "Weaviate 单机版启动完成" 
echo "HTTP API: http://10.127.20.16:9060" 
echo "gRPC: 10.127.20.16:50055"

可能需要从跳板机打包镜像文件，scp文件到对应机器的安装目录，导入镜像后，再删除安装包

##参考示例上传：

docker save -o D:\weaviate_1.27.0.tar semitechnologies/weaviate:1.27.0

scp weaviate_1.27.0.tar root@10.127.20.94:/app/deployee/weaviate/

docker load -i weaviate_1.27.0.tar 

Weaviate向量数据库单机搭建--docker方式部署

数据库

云计算

开发工具

Weaviate向量数据库部署指南：详细说明如何在Ubuntu 24.04服务器上部署Weaviate v1.27.0，包括环境准备、端口配置（9060/50055）、Docker Compose部署步骤、权限设置及验证方法。提供完整的部署脚本和配置参数，确保向量数据库服务稳定运行。

向量数据库

文件存储

内存映射

数据中心

数据管理

日志文件

服务器

防火墙

Docker

容器

Ubuntu

2026上云采购 | AI焕新·智启新局

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Weaviate向量数据库单机搭建--docker方式部署

Weaviate向量数据库单机搭建--docker方式部署

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐