You need to enable JavaScript to run this app. DigitalOcean Kubernetes部署Unifi控制器后无法采纳设备如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

DigitalOcean Kubernetes部署Unifi控制器后无法采纳设备如何解决?

核心问题定位
  • 当前unifi-service未显式指定type字段,默认使用ClusterIP类型,这类Service仅允许集群内部网络的资源访问对应端口。你侧的Unifi设备处于集群外部网络,向unifi."domain".net:8080发送的inform请求根本无法路由到集群内部的Unifi Pod,自然不会在控制器管理界面显示。
  • K8s Ingress存在明确的能力边界:仅能转发基于HTTP/HTTPS协议的80/443端口流量,完全无法处理Unifi设备交互依赖的多TCP/UDP端口(8080 inform、3478 STUN、10001设备发现、6789网速测试等)流量,仅靠Ingress打通所有设备交互端口的思路从根本上无法实现。
  • Service配置存在缺漏:除443端口明确指定了targetPort: 8443外,其余所有端口(8080、6789、3478等)都未显式声明对应的容器目标端口,存在端口映射错配的风险。
对应修复方案
  1. 将unifi-service调整为LoadBalancer类型(适配DigitalOcean Kubernetes的云负载均衡能力,支持多TCP/UDP端口转发),同时补全所有端口的targetPort配置,修复后的Service参考片段:
apiVersion: v1
kind: Service
metadata:
  name: unifi-service
  namespace: unifi-ns
spec:
  type: LoadBalancer # 新增:使用云负载均衡对外暴露全量交互端口
  selector:
    app: unifi
  ports:
    - port: 443
      targetPort: 8443
      name: https
      protocol: TCP
    - port: 8080
      targetPort: 8080 # 补全目标端口映射
      name: inform
      protocol: TCP
    - port: 6789
      targetPort: 6789 # 补全目标端口映射
      name: ubnt-6789
      protocol: TCP
    - port: 8443
      targetPort: 8443 # 补全目标端口映射
      name: ubnt-8443
      protocol: TCP
    - port: 3478
      targetPort: 3478 # 补全目标端口映射
      name: ubnt-3478
      protocol: UDP
    - port: 8881
      targetPort: 8881 # 补全目标端口映射
      name: ubnt-8881
      protocol: TCP
    - port: 8882
      targetPort: 8882 # 补全目标端口映射
      name: ubnt-8882
      protocol: TCP
    - port: 10001
      targetPort: 10001 # 补全目标端口映射
      name: ubnt-10001
      protocol: UDP
  1. 调整DNS解析规则:将unifi."domain".net的A记录直接指向LoadBalancer分配的公网IP,不要让8080等非Web端口的流量经过Ingress转发。
  2. 保留原有Ingress配置继续承接8443端口的管理界面HTTPS流量即可,不需要为8080等交互端口额外配置Ingress规则。
  3. 完成Service调整后,进入Unifi控制器的系统设置页,手动将外部inform服务地址设置为http://unifi."domain".net:8080/inform,避免控制器自动检测到集群内部Pod地址,给设备推送错误的inform地址。
连通性验证步骤
  • 调整完成后,先从非集群网络测试telnet unifi."domain".net 8080,确认端口连通性正常,再重新通过SSH给设备下发inform地址。
  • 检查DigitalOcean侧云负载均衡的配置,确认没有默认拦截3478、10001的UDP流量,需要放开对应端口的UDP转发规则。

内容的提问来源于stack exchange,提问作者Kaije Henstra

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 01:36:03