openJiuwen DeepSearch生产环境部署指南MySQLMilvusRedis分布式完整方案【免费下载链接】deepsearchopenJiuwen DeepSearch是一款知识增强的深度搜索与研究框架有业界领先的片段级引用和溯源推理能力提供精准Agentic搜索与研究能力项目地址: https://gitcode.com/openJiuwen/deepsearchopenJiuwen DeepSearch 是一款知识增强的深度搜索与研究框架具备业界领先的片段级引用与溯源推理能力提供精准的 Agentic 搜索与研究功能。当你准备把它推向生产环境时单机模式往往不再够用——本文手把手带你用MySQL Milvus Redis完成 DeepSearch 的多实例分布式生产部署一条命令拉起整个技术栈水平扩缩容只需改一个参数附完整安全加固清单 一、部署模式怎么选3 种 Compose 编排项目在deepsearch/docker/目录下提供了 3 份 Docker Compose 编排文件按场景三选一模式编排文件存储方案适用场景精简版docker-compose.ymlSQLite 内存会话快速体验、开发测试完整单机版docker-compose.full.ymlMySQL Milvus 本地持久化会话单机生产环境分布式版docker-compose.distributed.ymlMySQL Redis Milvus MinIO多实例水平扩展本文主角分布式模式的核心思路所有 DeepSearch 实例连接同一个 MySQL共享元数据、同一个 Redis共享会话状态和同一个对象存储共享知识库文件由 nginx 做负载均衡从而实现无状态的水平扩展。二、理解生产部署架构在动手之前先花 1 分钟认识 DeepSearch 的整体架构——它基于 openJiuwen agent-core 构建涵盖查询规划、知识检索、理解分析和结果生成四大核心模块分布式栈中每个组件的角色如下deepsearchN 个实例业务服务同时暴露 8000主 API与 8089Telemetry/流式事件端口nginx反向代理 负载均衡采用 least_conn最小连接数策略分发请求到各实例MySQL 8.0存储报告、任务、知识库元数据等多实例必须共享同一个库Redis 7存储 Agent 工作流的会话检查点Checkpointer支持会话暂停/恢复Milvus etcd MinIOMilvus 向量知识库其中 etcd 和 MinIO 是其 standalone 模式的标配依赖minio-init一次性容器自动创建知识库共享桶deepsearch-kb 各服务均配置了健康检查healthcheck并通过depends_on: condition: service_healthy保证基础设施全部就绪后才启动业务实例避免启动顺序踩坑。三、5 分钟准备.env 配置文件1. 获取源码git clone https://gitcode.com/openJiuwen/deepsearch cd deepsearch/docker2. 创建 .env⚠️关键细节.env必须放在deepsearch/docker/目录下与 compose 文件同级而不是仓库根目录cp ../.env.example .env # 然后编辑 .env 填入 LLM / 搜索密钥3. 修改 .env 中的关键配置打开 .env.example 模板重点改这几项变量说明示例DB_PASSWORDMySQL root 密码必须改掉默认的 rootYourStr0ngPssw0rdMINIO_ROOT_USER/MINIO_ROOT_PASSWORDMinIO 凭证必须改掉默认 minioadmin自定LLM / 搜索服务密钥按你使用的模型服务填写自定其余基础设施参数DB_TYPEmysql、CHECKPOINTER_TYPEredis、INDEX_MANAGER_TYPEmilvus、OBS_*等在 docker-compose.distributed.yml 中已预置好无需手动配置。四、一键启动拉起分布式技术栈一条命令拉起 Redis、MySQL、etcd、MinIO、Milvus、DeepSearch 多实例和 nginxcd deepsearch/docker docker compose -f docker-compose.distributed.yml up -d --scale deepsearch3其中--scale deepsearch3表示启动3 个 DeepSearch 业务实例。首次启动需要构建业务镜像基于 Dockerfile 用 uv 安装依赖耐心等待几分钟即可。启动后验证docker compose -f docker-compose.distributed.yml ps # 应全部 healthy curl -s http://127.0.0.1:8000/api/health五、水平扩缩容一条命令的事分布式部署最大的好处就是弹性伸缩。例如从 3 实例扩容到 5 实例docker compose -f docker-compose.distributed.yml up -d --scale deepsearch5 --force-recreate nginx⚠️注意扩缩容后必须加--force-recreate nginx重建 nginx 以刷新 upstream 地址列表——否则新实例收不到流量。nginx 配置见 nginx-distributed.conf它对 8000 与 8089 两个端口分别配置了代理其中 8089 端口支持 WebSocket 升级长连接超时放宽到 300s。六、端口速查与健康检查端口服务暴露方式8000主 API报告生成、知识库、运行等nginx → 宿主机8089Telemetry / 流式事件DeepSearch 模式nginx → 宿主机3306 / 6379 / 19530 / 9000 / 9001MySQL / Redis / Milvus / MinIO仅绑定 127.0.0.1 ️基础设施端口已默认只绑定回环地址不对外暴露业务端口 8000/8089 则需在防火墙或云安全组层面限制访问来源。七、生产环境安全加固清单 ️部署前逐项核对避免裸奔上线修改全部默认密码DB_PASSWORD默认 root、MINIO_ROOT_USER/MINIO_ROOT_PASSWORD默认 minioadmin收紧业务端口8000/8089 配置防火墙/安全组白名单或在上层再套一层网关启用生产服务模式将.env中SERVICE_MODE设为product并按要求设置SERVER_AES_MASTER_KEY_ENV敏感信息不落盘建议改用托管服务正式上云时推荐把 MySQL、Redis、对象存储替换为云托管服务修改对应环境变量指向即可八、关键配置参数速查分布式模式涉及的完整参数定义可参考 Linux 系统安装文档核心几组如下数据库DB_TYPEmysql 时生效参数说明DB_HOST/DB_PORTMySQL 地址与端口编排内为服务名mysql:3306DB_USER/DB_PASSWORD账号密码DEEPSEARCH_DB_NAME库名默认openjiuwen_deepsearch会话检查点CHECKPOINTER_TYPEredis 时生效参数说明默认值REDIS_URLRedis 连接串redis://redis:6379REDIS_CLUSTER_MODE是否集群模式falseREDIS_TTL/REDIS_REFRESH_ON_READ会话过期时间 / 读取时是否续期7200/true对象存储 OBSredis 模式下必填否则服务无法启动OBS_SERVER、OBS_REGION、OBS_BUCKET、OBS_ACCESS_KEY_ID、OBS_SECRET_ACCESS_KEY。编排中默认使用 MinIOpath-style 寻址也可替换为华为云 OBS / AWS S3 等任意 S3 兼容服务。九、避坑 FAQQ1为什么切到 Redis 模式后数据库必须是 MySQLA多实例下 SQLite 只是容器内的本地文件实例间不共享——会出现A 实例创建知识库、B 实例查不到的问题。因此CHECKPOINTER_TYPEredis时强制要求DB_TYPEmysql且共用同一库。Q2扩容后新实例不工作A检查是否遗漏了--force-recreate nginxupstream 列表未刷新是最高频的坑。Q3知识库文件存哪A分布式模式下知识库文档写入共享对象存储默认 MinIO 的deepsearch-kb桶由 minio-init 容器自动创建所有实例共享同一份无需各自上传。Q4只想用单机生产方案A用docker compose -f docker-compose.full.yml up -d即可它是 MySQL Milvus 本地持久化会话的组合无需 Redis 和对象存储。按照这套方案你可以用一条命令获得一个可水平扩展、状态共享、带负载均衡的 DeepSearch 生产集群。部署完成后建议再阅读项目 快速指引 了解 LLM 模型选型建议推荐 Qwen3.7-Max 等强模型生成报告让深度搜索能力充分发挥 【免费下载链接】deepsearchopenJiuwen DeepSearch是一款知识增强的深度搜索与研究框架有业界领先的片段级引用和溯源推理能力提供精准Agentic搜索与研究能力项目地址: https://gitcode.com/openJiuwen/deepsearch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
Dapr Cangjie SDK宏实现原理：Actor宏如何在编译期生成注册代码 Dapr Cangjie SDK宏实现原理：Actor宏如何在编译期生成注册代码 【免费下载链接】dapr-cangjie-sdk Dapr Cangjie SDK是Dapr SDK的仓颉实现，实现了一个支持使用 HTTP 协议访问 Dapr 边车的客户端。 项目地址: https://gitcode.com/Cangjie-SIG/dapr-can… · 2026/9/24 15:28:46
Qt Extension 1.16.0发布：MCP工具接入，AI Assistant退役 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 15:28:40
医疗行业专属Dynamics CRM解决方案：实体建模、合规安全与生态集成 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/24 15:28:34
Phoenix LDAP 认证安全深度剖析：从威胁模型到生产级防护实现 Phoenix LDAP 认证安全深度剖析：从威胁模型到生产级防护实现 【免费下载链接】phoenix AI Observability & Evaluation 项目地址: https://gitcode.com/gh_mirrors/phoenix13/phoenix
导读
本文以 Phoenix（AI Observability & Evaluatio… · 2026/9/24 16:05:27
ESP-IDF Windows 安装实战：EIM 装好环境，hello_world 一次跑通 ESP-IDF Windows 安装实战：EIM 装好环境，hello_world 一次跑通 【免费下载链接】esp-idf Espressif IoT Development Framework. Official development framework for Espressif SoCs. 项目地址: https://gitcode.com/GitHub_Trending/es/esp-idf … · 2026/9/24 16:05:27
从 Chat 到 Agent，2026 年到底变了什么？ 一、先说结论：变的不是模型，是"它有没有闭环"
咱们先把 Chat 那套老逻辑捋一遍。你给它一段话，它还你一段话，单次前向推理，无状态、无副作用。说白了就是个"嘴替"，说完就完了。
它的天… · 2026/9/24 16:05:13
webnovel-writer 冲突设计实战：5 步把网文冲突引擎铺进卷纲 webnovel-writer 冲突设计实战：5 步把网文冲突引擎铺进卷纲 【免费下载链接】webnovel-writer 基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。 项目地址: https://gitcode… · 2026/9/24 16:05:07
Accelerate 模型量化实战：基于 bitsandbytes 的 8-bit / 4-bit 模型加载与推理 人工智能深度学习分布式训练 【免费下载链接】accelerate 🚀 A simple way to launch, train, and use PyTorch models on almost any device and distributed configuration, automatic mixed precision (including fp8), and easy-to-configure FSDP and DeepSpee… · 2026/9/24 16:05:07
基于YOLOv8的渔船作业监控系统：从环境搭建到边缘部署全流程 简介：这是一套面向计算机、人工智能、自动化等专业学生与教师的毕业设计级项目资源，围绕YOLOv8实现渔船作业监控系统，可用于毕设、课程设计、大作业或项目立项演示。压缩包共97个文件，约24.21MB，以70个Python源码文件为… · 2026/9/24 0:00:13
1D-CNN时间序列建模实战：从Conv1d原理到工业落地 简介：面向时间序列数据建模的一维卷积神经网络完整实现，适合深度学习入门者及需要快速验证时序模型的研究者，能够从音频、文本、传感器或股价等序列中挖掘局部特征与时间依赖。压缩包体积很小，只有3KB，内含3个Python脚… · 2026/9/24 0:00:26
柔软的L：汉语语流中被忽视的舌肌张力控制 1. 这个“L”不是字母表里的L，而是舌尖上的L最近在几个方言群和语音教学社群里，反复看到有人发一句：“也说字母L：柔软的长舌”。初看以为是英语发音课笔记，点开才发现全是方言爱好者、播音系学生、语言康复师甚至戏曲演… · 2026/9/24 0:00:44
