本指南介绍在 Linux 系统采用 Docker 一键拉起方式安装 Deepsearch 完整版服务。
一、环境准备
请确保机器满足以下要求：
-
硬件：
- CPU：最低 2 核，推荐 4 核及以上
- RAM：最低 4GB，推荐 8GB 及以上
-
操作系统：
- Ubuntu：最低 Ubuntu 20.04，推荐 Ubuntu 22.04 (Jammy) 及以上
注意：Ubuntu 官方与主流软件源已停止支持 Ubuntu 20.04 (Focal) 及以下版本系统。
- EulerOS：Huawei Cloud EulerOS 2.0及以上
- Ubuntu：最低 Ubuntu 20.04，推荐 Ubuntu 22.04 (Jammy) 及以上
-
软件
- Docker 和 Docker Compose：安装方法详见下文
注意：Docker 的镜像、容器运行时数据、数据卷、网络配置等核心存储，默认路径是：/var/lib/docker/， 而多数 Linux 发行版（CentOS、Ubuntu、Debian）默认不单独划分 /var 分区，/var 只是根分区 / 下的普通目录，共用 ** 系统盘（根分区）** 的空间。建议客户把 /var 单独挂载到空间充足的独立分区 / 独立数据盘，和系统盘隔离，即便 /var 占满，也不会影响根分区的系统核心运行。
安装 Docker 和 Docker Compose
-
请参照 Docker 官方安装指南 以及 Docker Compose 官方安装指南 完成配置。
-
请确保 Docker 和 Docker Compose 满足以下版本要求：
- Docker：20.10 版本及以上
- Docker Compose：v2.19.1 及以上版本
-
验证 Docker 和 Docker Compose 安装:
docker version docker-compose version
二、DeepSearch 安装（以下以 Ubuntu 22.04 为例）
1. 下载版本包（若已获取版本包跳过此步骤）
-
根据机器架构下载版本包：
-
下载 x86_64 架构版本包
wget https://openjiuwen-ci.obs.cn-north-4.myhuaweicloud.com/deepsearch/deployTool_0.1.6_amd64.zip -
下载 arm 架构版本包：
wget https://openjiuwen-ci.obs.cn-north-4.myhuaweicloud.com/deepsearch/deployTool_0.1.6_arm64.zip
-
2. 启动 DeepSearch
-
将版本包放至安装目录。
-
安装 unzip 工具
sudo apt update && sudo apt install unzip -y -
解压对应的架构版本包。
-
解压 x86_64 架构版本包
unzip deployTool_0.1.6_amd64.zip -
解压 arm 架构版本包
unzip deployTool_0.1.6_arm64.zip
-
-
进入 deployTool_0.1.6_xxx64 目录，输入以下命令确认 Docker 已启动：
sudo systemctl start docker sudo systemctl status docker说明：若输出 “inactive” ，请参考 Docker 官方安装指南 以及 Docker Compose 官方安装指南。
-
如需修改前端页面服务的端口号，请参考这里。
-
在部署工具所在目录中，找到并编辑 .env.custom 配置文件，根据实际运行环境添加以下配置项：
IP=<运行部署工具的本机 IP 地址>
-
输入以下命令启动 DeepSearch：
./service.sh up注意：可能会因为网络原因出现 “up Plugin + Sandbox Server failed” 报错，请重新执行
./service.sh up。 -
启动成功后会输出
Local access: 本地访问地址
注意：关于容器部署的更多使用细节，可参考部署工具使用手册
3. 访问系统
-
若在本地查看，复制上述 本地访问地址 到浏览器地址栏，按下“回车键”将看到 openJiuwen 的界面。
-
若在外部机器查看，复制上述 网络访问地址 到浏览器地址栏，按下 “回车键” 将看到 openJiuwen 的界面。
-
连接 openJiuwen 的界面时，可能会弹出页面提示“您的连接不是私密连接”，原因是使用了自签名证书加密 SSL 证书来启用 HTTPS 加密通信。此提示并不表示连接本身存在恶意风险，而是提醒用户当前证书未经第三方权威机构认证。
-
可点击左下方“高级”选择“继续前往”进入 openJiuwen 的界面。
-
在任务空间中选择 DeepSearch 智能体即可开始使用。
三、常见问题（FAQ）
问题一：如何停止服务
输入以下命令停止 ：
./service.sh down