安装
使用docker-compose安装是最方便的
在/opt/目录下创建kong文件夹，然后创建一个docker-compose.yml文件并编辑
cd /opt
mkdir kong
cd kong
vi docker-compose.yml
在docker-compose.yml添加如下配置（20220528亲测可用）
version: '3'
services:
kong-database:
image: postgres:9.6
restart: always #每次总是启动
networks:
- kong-net
environment:
POSTGRES_USER: kong
POSTGRES_DB: kong
POSTGRES_PASSWORD: kong
ports:
- "5432:5432"
#######################
# 执行数据库迁移
######################
kong-migration:
image: kong:latest
command: "kong migrations bootstrap"
networks:
- kong-net
restart: on-failure
environment:
- KONG_DATABASE=postgres
- KONG_PG_DATABASE=kong
- KONG_PG_PASSWORD=kong
- KONG_PG_HOST=kong-database
links:
- kong-database #连接的是kong-database服务的
depends_on:
- kong-database #依赖于kong-database服务
#####################
# kong gateway
#####################
kong:
image: kong:latest
restart: always
networks:
- kong-net
environment:
KONG_DATABASE: postgres
KONG_PG_HOST: kong-database
KONG_PG_PASSWORD: kong
KONG_PROXY_LISTEN: 0.0.0.0:8000 # 代理监听http
KONG_PROXY_LISTEN_SSL: 0.0.0.0:8443 # 代理监听https
KONG_ADMIN_LISTEN: 0.0.0.0:8001 # Kong的管理API，不可暴露在公网
depends_on:
- kong-migration
links:
- kong-database
healthcheck:
test: ["CMD", "curl", "-f", "http://kong:8001"]
interval: 5s
timeout: 2s
retries: 15
ports:
- "8001:8001"
- "8000:8000"
- "8443:8443"
#######################
#以下两个是konga GUI
#######################
konga-prepare:
image: pantsel/konga:latest
command: "-c prepare -a postgres -u postgresql://kong:kong@kong-database:5432/konga" #注意是用户名：密码@数据库服务名称：端口
networks:
- kong-net
restart: on-failure
links:
- kong-database
depends_on:
- kong #依赖kong服务
- kong-database #依赖kong-database服务
konga:
image: pantsel/konga:latest
restart: always
networks:
- kong-net
environment:
DB_ADAPTER: postgres
DB_HOST: kong-database
DB_USER: kong
DB_DATABASE: konga
DB_PASSWORD: kong #必须加上密码，不然会失败
depends_on:
- kong
- kong-database
ports:
- "1337:1337" #控制台访问端口
networks:
kong-net:
driver: bridge
docker-compose.yml文件参考自
https://wenku.baidu.com/view/eda035c19889680203d8ce2f0066f5335a81670e.html
访问Konga控制台
假设使用的是本地搭建
使用浏览器访问127.0.0.1:1337
注：端口号在docker-compose.yml中指定了1337
若是使用云服务器，注意做好DNS解析以及Nginx配置
这里给出一份可用的kong.conf
server{
listen 80;
server_name kong.YOUR_DOMAIN.com;
charset utf-8;
# 接口
location / {
proxy_pass http://127.0.0.1:1337;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Port $server_port;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
使用浏览器访问kong.YOUR_DOMAIN:1337
首次进入配置管理员
打开界面后，是要创建一个管理员账号的，按说明填写即可
配置Kong管理API
先理解一下概念：
我们现在操作的可视化平台是Konga
Konga通过调用Kong的admin url，对Kong网关进行配置管理
所以这一步我们需要将Konga和Kong搭上线
在Connection页面配置要管理的Kong网关
主要填写参数说明：
Name：必填，唯一，用于备忘
Kong Admin URL：Kong网关的管理路径，默认端口是8001，在docker-compose.yml可修改对外暴露的端口号
这里有个提示很显眼：Kong's admin API should not be publicly exposed
故我们在云服务器部署时，都应该注意8001的这个端口不应随意暴露出去，以免发生黑客攻击风险
为什么配置出来是http://kong:8001？
因为本次使用的是docker-compose部署，Kong和Konga还有Postgres这几个容器都处于kong-net这个网络环境下，可以直接通过容器名访问到对方
Konga是在接收到浏览器请求后，通过后台服务调用Kong admin URL
如果用了其他方式部署，则需要按实际情况填写Kong admin URL，并且注意不要暴露到公网上！
ADD NEW SERVICE 添加一个要代理的服务
进入Service菜单，点击 ADD NEW SERVICE（添加新服务）
这里我们假设要代理某度的服务
主要填写参数说明：
Name：非必填，服务名称，用于备忘这是一个什么服务
Protocol：必填，填写http或https，指请求转发到该服务时，使用哪种协议
Host：必填，填写被代理的主机地址
Port：必填，填写被代理的主机的端口号，默认80
ADD ROUTE 在代理服务中添加一条路由
点击刚才创建的服务，点击进入Route管理界面
点击ADD ROUTE
主要填写参数说明：
Name：非必填，路由名称，用于备忘识别这是一个什么路由
Paths：这是重点！具体看效果就明白了，这边添加“/”和“/api/baidu”，注意要回车
访问已添加的服务
访问服务的接口为8000（在docker-compose.yml已配置）
若使用的是本地搭建
使用浏览器访问
- 127.0.0.1:8000
- 127.0.0.1:8000/api/baidu
若是部署到云服务器，并做好了域名解析
使用浏览器访问
- kong.YOUR_DOMAIN
- kong.YOUR_DOMAIN/api/baidu
都会被解析Route，指向对应的Service，返回的是某度的页面，搭建成功
Upstream配置
当同一个服务为分布式或存在多个域名、ip时，我们可以通过配置Upstream，将这些服务统一起来
进入Upstream页面
点击ADD UPSTREAM
主要填写参数说明：
Name：必填，名称，用于关联Service中Host字段
进入刚添加的Upstream的Detail
进入Target管理页
点击ADD TARGET
主要填写参数说明：
Target：该服务具体的域名+端口，注意这里默认端口8000，故需要手动写80
Weight：权重
添加好后是这个样子
之后我们回到Service配置
将Host填写为刚刚命名，并保存
之后我们再次访问
- 127.0.0.1:8000
- 127.0.0.1:8000/api/baidu
- kong.YOUR_DOMAIN
- kong.YOUR_DOMAIN/api/baidu
能发现不仅能访问某度，还能访问到某奇广告网（因为baidu1.com、baidu2.com并不是某度搜索）
至于每次访问结果都有变化，是因为Upstream做了权重的负载均衡，因此实际访问的服务是
