install/faq/logs-terminal.md
极少数情况下,您可能能够正常访问 Kuboard 和使用 Kuboard 的各项功能,但是,访问 Kuboard 提供的日志界面和终端界面时,始终会出现弹窗提示,并将您指引到了现在的这个页面上来。本文描述了如何排查 Kuboard 日志/终端界面不能访问的问题
Kuboard 日志界面和终端界面都使用了 websocket 与服务器端通信,正常情况下,会工作得很好,但是当出现如下几种情况时,websocket 的连接就会出现问题:
如果您还有问题,请尝试:
当您排除了上述两个问题之后,剩下极有可能的情况就是:
此时,您可以为 Kuboard 启用 https (请在方向代理上配置 https);或者,您可以尝试使用 kubectl port-forward 的方式来访问 Kuboard。具体步骤如下:
请参考 在客户端电脑安装 kubectl
在客户端电脑上执行端口转发命令,此命令将监听您客户端机器的 8000 端口,并将请求转发到 kuboard 所在 Pod 的 80 端口
kubectl port-forward svc/kuboard -n kube-system 8000:80
在 chrome 打开地址 `http://localhost:8000/
登录重试,此时应该能够正常访问 kuboard 的日志界面和终端界面。
::: tip 如果还解决不了 请参考本文末尾的方式联系 Kuboard 团队 :::
如果通过 Ingress 的方式访问 Kuboard,需要在 IngressController 上开启 websocket,以 nginx-ingress 为例,下面的 YAML 可以开启 websocket。更多信息请参考 Ingress 注解配置
apiVersion: networking.k8s.io/v1beta1
kind: Ingress
metadata:
annotations:
k8s.kuboard.cn/displayName: kuboard
k8s.kuboard.cn/workload: kuboard
nginx.com/sticky-cookie-services: serviceName=kuboard srv_id expires=1h path=/
nginx.org/websocket-services: kuboard
labels:
k8s.kuboard.cn/layer: monitor
k8s.kuboard.cn/name: kuboard
name: kuboard
namespace: kube-system
spec:
rules:
- host: kuboard.demo.kuboard.cn
http:
paths:
- backend:
serviceName: kuboard
servicePort: http
path: /
如果您为 Kuboard 设置了 nginx 反向代理,请在 nginx 上开启 websocket,配置文件如下所示:
server {
listen 80;
server_name kuboard.yourdomain.com; # 替换成你的域名
location / {
proxy_pass http://192.168.2.39:32567; # 替换成你的节点地址
proxy_http_version 1.1;
proxy_pass_header Authorization;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# proxy_set_header X-Forwarded-Proto https; # 如果您在反向代理上启用了 HTTPS
}
location /k8s-ws/ {
proxy_pass http://192.168.2.39:32567; # 替换成你的节点地址
proxy_http_version 1.1;
proxy_pass_header Authorization;
proxy_set_header Upgrade "websocket";
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# proxy_set_header X-Forwarded-Proto https; # 如果您在反向代理上启用了 HTTPS
}
gzip on;
}