# 日志终端访问的问题

极少数情况下,您可能能够正常访问 Kuboard 和使用 Kuboard 的各项功能,但是,访问 Kuboard 提供的日志界面和终端界面时,始终会出现弹窗提示,并将您指引到了现在的这个页面上来。本文描述了如何排查 Kuboard 日志/终端界面不能访问的问题

# 第一步

Kuboard 日志界面和终端界面都使用了 websocket 与服务器端通信,正常情况下,会工作得很好,但是当出现如下几种情况时,websocket 的连接就会出现问题:

  • 您所访问的容器已经停止
  • 您当前使用的浏览器不支持 WebSocket,推荐使用最新版本的 chrome 浏览器,也可以尝试最新版本的 firefox

如果您还有问题,请尝试:

  • (如果刚完成 Kuboard 的升级)退出 Kuboard 登录,重新输入 token 登录 Kuboard
  • 清空浏览器缓存

# 第二步

当您排除了上述两个问题之后,剩下极有可能的情况就是:

  • 您访问服务器时,网络链路上存在代理,比如:
    • 您配置了 Nginx 反向代理,通过 Nginx 将请求转发到 Kuboard 的节点端口 32567
    • 您的浏览器设置了代理程序,并通过代理访问网站内容
    • 您使用了科学上网的工具
    • 您通过 VPN 接入到服务器所在的网络,然后访问 Kuboard 的节点端口 32567
    • 您的网络运营商(如长城宽带、小区宽带、电力猫等)为了节省出口带宽,对所有的 HTTP 服务都做了代理和缓存

此时,您可以为 Kuboard 启用 https (请在方向代理上配置 https);或者,您可以尝试使用 kubectl port-forward 的方式来访问 Kuboard。具体步骤如下:

  • 请参考 在客户端电脑安装 kubectl

  • 在客户端电脑上执行端口转发命令,此命令将监听您客户端机器的 8000 端口,并将请求转发到 kuboard 所在 Pod 的 80 端口

    kubectl port-forward svc/kuboard -n kube-system 8000:80
    
    1
  • 在 chrome 打开地址 `http://localhost:8000/

    登录重试,此时应该能够正常访问 kuboard 的日志界面和终端界面。

如果还解决不了

请参考本文末尾的方式联系 Kuboard 团队

# Ingress设置

如果通过 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: /
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 反向代理设置

如果您为 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;
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
更新时间: 2020-07-25 21:08:14