0
代码
代码
Issues
Pull Requests
讨论
Wiki
分析
0
OopenJiuwen-botdoc:update version in doc
1b8c44b2创建于 14 天前历史提交

本指南介绍在 Windows 系统采用 Docker 一键拉起方式安装 Deepsearch 完整版服务。

一、环境准备

请确保机器满足以下要求：

  • 硬件：

    • CPU：最低 2 核，推荐 4 核及以上
    • RAM：最低 4GB，推荐 8GB 及以上

  • 操作系统：Windows10及以上

  • 软件

    • Git：点击 下载 进行下载并安装，安装配置保持默认即可
    • Docker：推荐使用 Docker Desktop 进行安装，安装方法详见下文

安装Docker Desktop

Windows 上运行 Docker Desktop 推荐使用 WSL 2（Windows Subsystem for Linux 2） 作为虚拟化后端，相比 LinuxKit 兼容性更好、资源占用更低，且能避免已知的僵尸容器 Bug。

1. 安装 WSL

对于符合条件的 Windows 系统（Windows 10 版本 2004 及更高版本<内部版本 19041 及更高版本>或 Windows 11），仅运行 wsl --install就能一键安装配置 WSL。

  • 按下 Windows + S，输入 PowerShell 进行搜索。

  • 在搜索结果中，右键点击 Windows PowerShell，选择 以管理员身份运行。

  • 在 PowerShell 执行如下命令，当提示 请求的操作成功，在重新启动系统前更改将不会生效 后，重新启动计算机即可完成 WSL 安装。
    首次安装 WSL 需要一定的时间下载必备组件，请耐心等待。

    wsl --install

而旧版本 Windows 不支持这个一键命令的完整自动化功能，可能需要补充操作，具体请参考 如何使用 WSL 在 Windows 上安装 Linux

2. 安装 Docker Desktop

  • 下载安装包：前往 Docker 官网 下载 Docker Desktop 的 Windows 版本安装包（X86 机器请选择 AMD64 版本），建议下载最新版本以满足以下内置组件版本要求：

    • Docker Engine：20.10 版本及以上
    • Docker Compose：v2.19.1 及以上版本

  • 运行安装包：​仅勾选​「Use WSL 2 instead of Hyper-V」、​「Add shortcut to desktop」选项，点击​「OK」开始安装；

  • 安装完成后，请重启电脑；

  • 重启后，打开 Docker Desktop，等待加载完成（首次启动可能需要 5 ~ 10 分钟）；

  • Docker Desktop 启动后，若临时试用，可点击欢迎界面的 Continue without signing in 直接进入；长期使用请参考 官方指导 注册后使用。

  • 至此 Docker Desktop 安装完成。

说明：若安装过程中出现报错，或了解官方安装过程，请参考 Docker Desktop 官方安装指导。

二、DeepSearch 服务安装

1. 下载版本包（若已获取版本包跳过此步骤）

2. Docker Desktop 设置 Virtual file shares

  • 新建 DeepSearch 安装目录，例如：D:\DeepSearch。

  • 打开 Docker Desktop，单击右上方 ⚙ 进入设置界面；

  • 单击左侧竖列导航栏​「Resources」，进入 Resources 配置界面；

  • 单击​「File sharing」，并在输入框中填写 DeepSearch 的安装目录，最后单击右侧 ➕ 进行添加；

  • 点击 “Apply & restart” 重启 Docker Desktop。

3. 启动 DeepSearch

  • 将版本包放至 DeepSearch 安装目录 并解压。

  • 进入 service.sh 所在目录，在空白处右键打开 Git Bash，输入以下命令确认 Docker Desktop 已启动：

    docker info >nul 2>&1 && (echo Docker Desktop 已启动) || (echo Docker Desktop 未启动)

    说明：若提示 “Docker Desktop 未启动”，请参考 Docker Desktop 官方指导。

  • 如需修改前端页面服务的端口号，请参考这里。

  • 在部署工具所在目录中，找到并编辑 .env.custom 配置文件，根据实际运行环境添加以下配置项：

IP=<运行部署工具的本机 IP 地址>

  • 输入以下命令启动 DeepSearch：

    ./service.sh up

    注意：可能会因为网络原因出现 “up Plugin + Sandbox Server failed” 报错，请重新执行 ./service.sh up。

  • 启动成功后会输出 Local access：访问地址。

    注意：关于容器部署的更多使用细节，可参考部署工具使用手册

4. 访问系统

复制上述 访问地址 到浏览器地址栏，按下“回车键”将看到 openJiuwen 的界面。

  • 连接 openJiuwen 的界面时，可能会弹出页面提示“您的连接不是私密连接”，原因是使用了自签名证书加密 SSL 证书来启用 HTTPS 加密通信。此提示并不表示连接本身存在恶意风险，而是提醒用户当前证书未经第三方权威机构认证。

  • 可点击左下方“高级”选择“继续前往”进入 openJiuwen 的界面。

  • 在任务空间中选择 DeepSearch 智能体即可开始使用。

三、常见问题（FAQ）

问题一：如何停止服务

输入以下命令停止 ：

./service.sh down