9. 常见问题

1、部署时，“coze-elasticsearch” 容器启动报错？

部署过程中如果出现以下报错： 使用代码编辑器（如 VS Code）打开 docker/volumes/elasticsearch/setup_es.sh。在编辑器的右下角，你会看到 CRLF 或 LF 的标识，点击它并选择 LF。保存文件后再重新启动 docker compose --profile "*" up -d。以及相关issue

2、windows本地部署，“Error response from daemon: Ports are not available: exposing port TCP 0.0.0.0:2379 -＞ 127.0.0.1:0:2379” 如何解决？

# 查看占用
netstat -ano | findstr :2379

net stop winnat
net start winnat

3、Agent 对话调试 “Something error:Internal server error” 错误？

可以通过以下命令查询具体错误日志

docker logs coze-server | grep -i 'node execute failed'

4、知识库上传文档之后，显示处理中0%？

知识库上传文档后，长时间显示‘处理中’，如下图所示： 知识库功能依赖向量化存储组件和Embedding模型，请检查对应配置是否已经正常配置，配置流程参考：向量化存储和向量化模型

5、Agent对话或者workflow大模型节点上传图片/文件后调试时模型报错？

大模型访问的图片/文件链接需要是公网可访问的链接，图片存组件需要在公网部署，具体可以参考：上传组件配置

6、服务启动后，“setup”相关的容器处于退出状态是正常的吗？

是正常的 ，setup相关的容器是做一些脚本初始化工作，执行完毕后会自动退出。