Lemon AI重磅开源！5分钟部署你的专属全栈通用AI Agent，带你解锁智能体验

5月28日，我们正式开源了Lemon AI 全栈通用AI Agent（?GitHub仓库直达），上线32小时即收获160+Star！，这款支持多场景任务、单击部署、自订阅模型的全栈通用AI Agent，已吸引开发者、企业技术团队争相体验。

然而，部分用户在部署过程中遇到了Docker不会装、命令行看不懂、启动失败等。为此，我们整理了《5分钟Docker极简部署手册》，助你零门槛解锁Lemon AI全栈能力！

为什么选择Docker部署？

在介绍具体步骤之前，先让我们了解一下为什么Lemon AI选择Docker作为主要部署方式：

统一环境，告别"在我机器上能跑"

Docker容器化技术确保了Lemon AI在任何支持Docker的系统上都能保持一致的运行环境，无论你用的是Mac、Windows还是Linux。

一键启动，秒级部署

复杂的依赖安装？繁琐的环境配置？通通不存在！一个docker命令搞定一切。

隔离安全，保护主机环境

运行在容器中的Lemon AI不会影响你的主机系统，既安全又干净。

在开始之前，请确保你的系统满足以下要求：

系统要求

• 支持 Docker Desktop的 MacOS

• 支持WSL和Docker Desktop 的Windows

建议使用具有现代处理器（建议Intel i5/AMD Ryzen 5以上）和至少4GB RAM的系统来运行 Lemon AI。

一.下载云盘中Lemon AI 应用

1.访问LemonAI官网(lemonai.cc)，在Offline Install Package Downloads板块中选择网盘（当前截图为百度网盘），在网盘中根据Mac电脑的芯片（Intel芯片选择x86_64, 苹果芯片选择arm64）来下载对应的Lemon AI 文件夹。

2.在下载后的文件中，先阅读文件夹中的readme.txt文件，文件中展示了中英文安装包的安装流程以及安装先后顺序。（如果没阅读可以继续跟进下面的流程安装）

二.安装Docker桌面

1.在网盘下载的Mac文件夹中，首先进行Docker安装

2.安装完成后，双击启动Docker，按照客户端指示进行安装，安装完成后保持运行启动状态。

三.导入Lemon AI镜像

1.在网盘下载的Mac安装包文件夹，点击文件夹右键-服务-新建位于文件夹位置的终端窗口，启动终端。

2.在文件夹终端中，执行导入镜像文件 lemon-runtime-sandbox.tar 的命令。

docker load -i lemon-runtime-sandbox.tar

3.镜像导入成功后，在docker桌面Images中查看，展示镜像即为导入成功。

四.安装Lemon AI客户端

1.镜像导入完成后，在网盘下载的Mac文件夹中，选择Lemon AI客户端进行软件安装。

2.安装完成后，点击启动Lemon AI应用，在设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成，返回任务页面就可以进行Lemon AI 任务问答体验了。

一.安装Docker 桌面

1.在 Mac 上安装 Docker Desktop（www.docker.com），根据Mac电脑的芯片（Intel芯片选择x86_64, 苹果芯片选择arm64）来下载对应的Docker。

2.下载后进行软件安装流程安装，安装完成后，启动 Docker Desktop。

3.打开 Docker Desktop，转到Settings > Advanced并确保Allow the default Docker socket to be used已启用。

二.启动Lemon AI应用程序

1.Desktop启动状态下，在Mac电脑，启动台中搜索终端，并启动终端。

2.在终端中按顺序输入命令，开始执行命令，等待执行完成。

• 在终端中输入，执行拉取Lemon AI沙盒命令

docker pull hexdolemonai/lemon-runtime-sandbox:latest

如果执行拉取命令时，出现以下报错，证明拉取失败（可能不具备访问外网能力），建议去使用第一种方式网盘直接下载进行安装。

• 拉取沙盒命令执行完成后，在终端中，继续输入，运行Lemon AI 程序命令

docker run -it --rm --pull=always \  --name lemon-app \  --env DOCKER_HOST_ADDR=host.docker.internal \  --env ACTUAL_HOST_WORKSPACE_PATH=${WORKSPACE_BASE:-$PWD/workspace} \  --publish 5005:5005 \  --add-host host.docker.internal:host-gateway \  --volume /var/run/docker.sock:/var/run/docker.sock \  --volume ~/.cache:/.cache \  --volume ${WORKSPACE_BASE:-$PWD/workspace}:/app/workspace \  --volume ${WORKSPACE_BASE:-$PWD/data}:/app/data \  --interactive \  --tty \  hexdolemonai/lemon:latest make run

3.命令执行完成后，docker中展示Lemon-app文件，复制终端中的访问链接或者在docker 中的Containers中Lemon-app，点击端口链接，跳转页面进行访问。

4.在Lemon AI本地网页端，设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成就可以进行Lemon AI 任务问答体验了。

一.安装Docker 桌面

1.在 Mac 上安装 Docker Desktop（www.docker.com），根据Mac电脑的芯片（Intel芯片选择x86_64, 苹果芯片选择arm64）来下载对应的Docker。

2.下载后进行软件安装流程安装，安装完成后，启动 Docker Desktop

3.打开 Docker Desktop，转到Settings > Advanced并确保Allow the default Docker socket to be used已启用。

二.拉取Lemon AI沙盒

• 在终端中输入，执行拉取Lemon AI沙盒命令

docker pull hexdolemonai/lemon-runtime-sandbox:latest

三.安装Lemon AI 客户端

1.访问LemonAI官网(lemonai.cc)，在Desktop Application Download板块中，根据Mac电脑的芯片（Intel芯片选择x86_64, 苹果芯片选择arm64）来下载对应的Lemon AI 应用。

2.下载应用后，点击安装Lemon AI客户端。

3.安装完成后，点击启动Lemon AI应用。

4.在启动Lemon AI客户端中，如果出现以下截图错误，说明没有安装Lemon AI沙盒成功，需要返回上一步执行拉取沙盒操作。

5.在设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成，返回任务页面就可以进行Lemon AI 任务问答体验了。

一.下载云盘中Lemon AI 应用

1.访问LemonAI官网(lemonai.cc)，在Offline Install Package Downloads板块中选择网盘（当前截图为百度网盘），在网盘中选择Windows文件夹，下载整个Lemon AI 文件夹。

2.在下载后的文件中，先阅读文件夹中的readme.txt文件，文件中展示了中英文安装包的安装流程以及安装先后顺序。（如果没阅读可以继续跟进下面的流程安装）

二.安装WSL

1.前提条件

您必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。

如果您使用的是早期版本，

请参阅手动安装页面。（learn.microsoft.com/en-us/windows/wsl/install-manual）

2.安装 WSL命令

现在，只需一个命令即可安装运行 WSL 所需的一切。右键单击并选择“以管理员身份运行”，以管理员模式打开 PowerShell 或 Windows 命令提示符，输入 wsl --install 命令，然后重新启动计算机。

wsl --install

此命令将启用运行 WSL 所需的功能并安装 Linux 的 Ubuntu 发行版。（此默认发行版可以更改）。

如果您正在运行旧版本，或者只是不想使用安装命令而希望获得分步指导，请参阅旧版本的 WSL 手动安装步骤。（learn.microsoft.com/en-us/windows/wsl/install-manual）

首次启动新安装的 Linux 发行版时，会打开一个控制台窗口，并提示您等待文件解压缩并存储到您的计算机上。之后的启动过程应该只需不到一秒钟。

3.wsl --version在 powershell 中运行并确认Default Version: 2。

wsl --version

4.安装完成后，重启计算机，在电脑应用中可以看到WSL。

三.安装Docker桌面

1.在网盘下载的Windows文件夹中，首先双击进行Docker安装。

2.安装完成后，双击启动Docker，按照客户端指示进行安装，安装完成后保持运行启动状态

3.打开Docker Desktop，前往Settings并确认以下内容：

• 常规：Use the WSL 2 based engine已启用。

• 资源 > WSL 集成：Enable integration with my default WSL distro已启用。

三.导入Lemon AI镜像

1.在网盘下载的Windows安装包文件夹，点击文件夹右键-在终端中打开，启动终端。

2.在文件夹终端中，执行导入镜像文件 lemon-runtime-sandbox.tar 的命令。

docker load -i lemon-runtime-sandbox.tar

3.镜像导入成功后，在docker桌面Images中查看，展示镜像即为导入成功。

四.安装Lemon AI客户端

1.镜像导入完成后，在网盘下载的Windows文件夹中，选择Lemon AI客户端按照指示步骤进行软件安装。

2.安装完成后，点击启动Lemon AI应用，在设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成，返回任务页面就可以进行Lemon AI 任务问答体验了。

一.安装WSL

1.前提条件

您必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。

如果您使用的是早期版本，

请参阅手动安装页面。（learn.microsoft.com/en-us/windows/wsl/install-manual）

2.安装 WSL命令

现在，只需一个命令即可安装运行 WSL 所需的一切。右键单击并选择“以管理员身份运行”，以管理员模式打开 PowerShell 或 Windows 命令提示符，输入 wsl --install 命令，然后重新启动计算机。

wsl --install

此命令将启用运行 WSL 所需的功能并安装 Linux 的 Ubuntu 发行版。（此默认发行版可以更改）。

如果您正在运行旧版本，或者只是不想使用安装命令而希望获得分步指导，请参阅旧版本的 WSL 手动安装步骤。（learn.microsoft.com/en-us/windows/wsl/install-manual）

首次启动新安装的 Linux 发行版时，会打开一个控制台窗口，并提示您等待文件解压缩并存储到您的计算机上。之后的启动过程应该只需不到一秒钟。

3.wsl --version在 powershell 中运行并确认Default Version: 2。

wsl --version

4.安装完成后，重启计算机，在电脑应用中可以看到WSL。

二.安装Docker 桌面

1.在 Windows 上安装 Docker Desktop（www.docker.com），来下载Windows对应的Docker进行docker安装。

2.下载后进行软件安装流程安装，安装完成后，双击启动Docker，按照客户端指示进行安装，安装完成后保持运行启动状态。

3.打开Docker Desktop，前往Settings并确认以下内容：

• 常规：Use the WSL 2 based engine已启用。

• 资源 > WSL 集成：Enable integration with my default WSL distro已启用。

三.启动Lemon AI应用程序

1.在Windows电脑应用中，启动WSL，必须在 WSL 终端内运行以下用于启动应用程序的 docker 命令。

2.在WSL中按顺序输入命令，开始执行命令，等待执行完成。

• 在WSL中输入，执行拉取Lemon AI沙盒命令

docker pull hexdolemonai/lemon-runtime-sandbox:latest

如果执行拉取命令时，出现以下报错，证明拉取失败（可能不具备访问外网能力），建议去使用第一种方式网盘直接下载进行安装。

• 拉取沙盒命令执行完成后，在WSL中，继续输入，运行Lemon AI 程序命令

docker run -it --rm --pull=always \  --name lemon-app \  --env DOCKER_HOST_ADDR=host.docker.internal \  --env ACTUAL_HOST_WORKSPACE_PATH=${WORKSPACE_BASE:-$PWD/workspace} \  --publish 5005:5005 \  --add-host host.docker.internal:host-gateway \  --volume /var/run/docker.sock:/var/run/docker.sock \  --volume ~/.cache:/.cache \  --volume ${WORKSPACE_BASE:-$PWD/workspace}:/app/workspace \  --volume ${WORKSPACE_BASE:-$PWD/data}:/app/data \  --interactive \  --tty \  hexdolemonai/lemon:latest make run

3.命令执行完成后，docker中展示Lemon-app文件，复制终端中的访问链接或者在docker 中的Containers中Lemon-app，点击端口链接，跳转页面进行访问。

4.在Lemon AI本地网页端，在设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成就可以进行Lemon AI 任务问答体验了。

一.安装WSL

1.前提条件

您必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。

如果您使用的是早期版本，

请参阅手动安装页面。（learn.microsoft.com/en-us/windows/wsl/install-manual）

2.安装 WSL命令

现在，只需一个命令即可安装运行 WSL 所需的一切。右键单击并选择“以管理员身份运行”，以管理员模式打开 PowerShell 或 Windows 命令提示符，输入 wsl --install 命令，然后重新启动计算机。

wsl --install

此命令将启用运行 WSL 所需的功能并安装 Linux 的 Ubuntu 发行版。（此默认发行版可以更改）。

如果您正在运行旧版本，或者只是不想使用安装命令而希望获得分步指导，请参阅旧版本的 WSL 手动安装步骤。（learn.microsoft.com/en-us/windows/wsl/install-manual）

首次启动新安装的 Linux 发行版时，会打开一个控制台窗口，并提示您等待文件解压缩并存储到您的计算机上。之后的启动过程应该只需不到一秒钟。

3.wsl --version在 powershell 中运行并确认Default Version: 2。

wsl --version

4.安装完成后，重启计算机，在电脑应用中可以看到WSL。

二.安装Docker 桌面

1.在 Windows 上安装 Docker Desktop（www.docker.com），来下载Windows对应的Docker进行docker安装。

2.下载后进行软件安装流程安装，安装完成后，双击启动Docker，按照客户端指示进行安装，安装完成后保持运行启动状态。

3.打开Docker Desktop，前往Settings并确认以下内容：

• 常规：Use the WSL 2 based engine已启用。

• 资源 > WSL 集成：Enable integration with my default WSL distro已启用。

二.拉取Lemon AI沙盒

• 在终端中输入，执行拉取Lemon AI沙盒命令

三.安装Lemon AI 客户端

1.访问LemonAI官网(lemonai.cc)，在Desktop Application Download板块中，根据Windows电脑来下载对应的Lemon AI 应用。

2.下载应用后，点击安装Lemon AI客户端，弹出安装窗口，点击更多信息，点击仍要运行，按照安装步骤进行一键安装。

3.安装完成后，点击启动Lemon AI应用，进行镜像验证，验证成功后，展示任务页面，启动应用成功

4.在启动Lemon AI客户端中，如果出现以下截图错误，说明没有安装Lemon AI沙盒成功，需要返回上一步执行拉取沙盒操作。

5.在设置中依次需要配置自订阅模型服务、搜索服务、默认模型，配置完成，返回任务页面就可以进行Lemon AI 任务问答体验了。