Lemon Docs
  • 入门
    • 快速了解 Lemon
  • 功能介绍
    • 快速上手
    • 设置
      • 基本设置
      • 模型服务设置
        • 万界数据
        • DeepSeek
        • 硅基流动
        • 火山引擎
        • 阿里云百炼
        • O3
        • OpenAI
        • 自定义服务商
      • 搜索服务设置
        • 搜索服务
          • Tavily 联网登录注册教程
      • 默认模型设置
      • 经验库
  • 开发部署指南
    • 快速开始本地开发
    • Docker快速部署
      • Mac Docker部署教程
        • 方式一(推荐)Docker部署 Mac 网盘安装
        • 方式二 Docker Mac命令部署文档
        • 方式三 Docker Mac客户端安装部署
      • Windows Docker部署教程
        • 方式一(推荐)Docker部署 Windows 网盘安装
        • 方式二 Docker Windows命令部署文档
        • 方式三 Docker Windows客户端安装部署
    • 配置文件介绍
    • 部署常见问题
    • 版本更新
      • Lemon v0.1 更新说明
  • 协议
    • 开源协议
    • 服务协议
    • 隐私政策
Powered by GitBook
On this page
  • 一、错误排查方式
  • 二、通用问题
  1. 开发部署指南

部署常见问题

Previous配置文件介绍Next版本更新

Last updated 15 days ago

一、错误排查方式

可以先找找,或新提 Issue,私有部署错误,务必提供详细的操作步骤、日志、截图,否则很难排查。

获取后端错误

  1. docker ps -a 查看所有容器运行状态,检查是否全部 running,如有异常,尝试docker logs 容器名查看对应日志。

  2. 容器都运行正常的,docker logs 容器名 查看报错日志

前端错误

前端报错时,页面会出现崩溃,并提示检查控制台日志。可以打开浏览器控制台,并查看console中的 log 日志。还可以点击对应 log 的超链接,会提示到具体错误文件,可以把这些详细错误信息提供,方便排查。

二、通用问题

1.启动 Docker 客户端失败

描述

运行Lemon 时出现以下错误:

Launch docker client failed. Please make sure you have installed docker and started docker desktop/daemon.

解决

按顺序尝试以下操作:

  • 确认docker正在你的系统上运行。你应该能够docker ps在终端中成功运行。

  • 如果使用 Docker Desktop,请确保Settings > Advanced > Allow the default Docker socket to be used已启用。

  • 根据您的配置,您可能需要Settings > Resources > Network > Enable host networking在 Docker Desktop 中启用。

  • 重新安装 Docker Desktop。

2.如何删除镜像

在docker中找到已拉取的镜像,您可能需要在Containers 中暂停镜像,然后在从images 中删除镜像,然后再通过WSL命令进行重新拉取镜像。

3.端口冲突

如果端口冲突,可以修改主机端口映射。例如,将主机的 8080 端口映射到容器的 8000 端口:

docker run -d -p 8080:8000 --name my-app-container my-app

4.docker客户端报错Docker Engine stopped

  • 检查Docker服务状态:

在Linux上,你可以使用命令sudo systemctl status docker来查看Docker服务的状态。

在Windows或Mac上,你可能需要打开Docker Desktop应用程序并确保其正在运行。

  • 启动Docker服务:

如果服务未运行,可以尝试手动启动它。在Linux上,这可以通过命令sudo systemctl start docker实现。

对于Windows和Mac用户,尝试重启Docker Desktop应用程序。

  • 检查系统日志:

查看系统日志可以帮助确定为什么Docker服务停止。在Linux上,可以使用journalctl -u docker命令来查看与Docker相关的日志信息。

  • 更新或重新安装Docker:

如果问题持续存在,考虑更新到最新版本的Docker或者完全卸载后重新安装Docker。

  • 检查配置文件:

确认Docker的配置文件正确无误,有时候不正确的配置也可能导致服务无法启动。

  • 资源限制:

确保系统有足够的资源(如内存和CPU)来运行Docker服务。资源不足可能导致服务意外停止。

  • 权限问题:

确保当前用户对Docker有适当的权限。在Linux上,你可能需要将用户添加到docker组中。

Issue