apisix安装常见问题归纳

最新推荐文章于 2025-03-09 18:10:37 发布

admin-xl-2048

最新推荐文章于 2025-03-09 18:10:37 发布

阅读量5.8k

点赞数 3

分类专栏： apisix安装问题

本文链接：https://blog.csdn.net/qq_41829085/article/details/111028502

版权

本文总结了Apache APISIX在安装过程中常见的问题及解决方案，包括依赖访问失败、etcd版本冲突、unknown directive错误、加解密问题、make命令错误等，并提供了详细的解决步骤。此外，还涉及到了apisix-dashboard的构建错误和lua依赖安装问题，以及如何处理克隆后的dashboard无法运行的情况。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文为自己安装中所遇到的一些常见问题，保持长期更新，欢迎c友们批评指正，或者将自己遇到的问题私信给我，我会即时总结更新出来。

1.0 如果安装依赖访问github出现连接失败或者拒绝连接。

解决方法：

1   vim（vi） /etc/hosts

打开后会发现类似如下ip,现全部删除，
在这里插入图片描述
只需要新插入： 140.82.112.3 github.com 即可；这是github ip地址更换原因。

在这里插入图片描述

2.0 安装etcd3.4后，依旧无法开启apisix,提示etcd问题

在这里插入图片描述
这里需要检查自己的etcd版本，如果有其他项目需要etcd v2协议，那只能安装apisix1.5以下版本；（1.5和2.0版本为分水岭，一定需要统一etcd版本）
首先查看自己开启的版本是否为3.4（v3）

[root@localhost /]# etcd --version
etcd Version: 3.4.13
Git SHA: ae9734ed2
Go Version: go1.12.17
Go OS/Arch: linux/amd64

如果不是3.4那么需要卸载重新开启etcd
查看是否为rpm包安装

rpm -qa |grep etcd

如果是：

rpm -e --nodeps etcd-3.3xxx #卸载刚才的版本号
kill -9 端口 #同时杀死正在进行的etcd

确认全部杀死不同版本后后再重新启动即可。

3.0 unknown directive 问题

推荐使用centos7的方式进行安装依赖环境，如果不是上面的方式安装的依赖，启动网关时openresty可能会报unknown directive 问题，这是因为编译的openresty的时候，没有指定–with-http_realip_module 等模块，需将该模块加入重新编译安装openresty。