OrbStack — 本地 K8s 环境的域名映射优化，开发者的新宠-技术圈

接上回的篇章，在《云原生小技巧 #3：在本地 K8s 中轻松部署自签 TLS 证书》中，我向大家展示了如何使用 Dnsmasq^[1] 来搞定本地 DNS 的问题。那是一种相对传统的做法，简单易行。但是，对于我们这些追求效率的开发者来说，能够即插即用显然更加令人兴奋。

今天，我要介绍的这个新伙伴: OrbStack^[2]，它的 Slogan 是: Say goodbye to slow, clunky containers and VMs。不过，说实话，我最喜欢的还是它的 Local domain names 的能力，因为它是零配置的。

Container domain names

OrbStack 对待容器的态度可谓是亲(强)密(大)无间，它为每个容器赋予了一个独一无二的域名。

举个例子，假设我在本地启动了一个名为 getting-started 的容器，并将容器内的 80 端口映射到了本地的 3000 端口

docker run -d -p 3000:80 --name getting-started docker/getting-started

下面是我本地容器运行的情况

在以往，我需要通过 localhost + port 的方式来访问这个容器。

现在呢？只需通过 OrbStack 分配的域名，我就可以畅通无阻地访问它，而且不需要指定端口，非常的丝滑。

mDNS

通过一系列的命令和检查，我们可以看到 getting-started.orb.local 这个域名确实被解析到了容器的 IP 地址：192.168.215.3。

➜ ping getting-started.orb.local
PING getting-started.orb.local (192.168.215.3): 56 data bytes
64 bytes from 192.168.215.3: icmp_seq=0 ttl=63 time=1.714 ms
64 bytes from 192.168.215.3: icmp_seq=1 ttl=63 time=0.472 ms
64 bytes from 192.168.215.3: icmp_seq=2 ttl=63 time=1.204 ms

➜ docker inspect getting-started \
  -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}'
192.168.215.3

我本机的 /etc/hosts 文件内容也没发生过变化，那么它是怎么做到的呢？我们先来看下系统的 DNS 配置信息。

➜ scutil --dns
DNS configuration

resolver #1
  ...

resolver #2
  domain   : local
  options  : mdns
  timeout  : 5
  flags    : Request A records
  reach    : 0x00000000 (Not Reachable)
  order    : 300000

resolver #3
  ...

在 scutil --dns 命令的输出中，resolver #2 部分的 options 字段包含 mdns，这表示该解析器配置用于处理 .local 域名的多播 DNS 查询。

mDNS 即多播 DNS（Multicast DNS^[3]）它是一种在本地网络上无需传统 DNS 服务器即可解析主机名的协议。这是 Bonjour（Apple 的实现）用来在本地网络上发现服务和主机名的一种机制。

# 获取本地 getting-started.orb.local 域名的地址
➜ dns-sd -G v4v6 getting-started.orb.local
DATE: ---Sat 04 Nov 2023---
 9:52:21.350  ...STARTING...
Timestamp     A/R  Flags         IF  Hostname                               Address                                      TTL
 9:52:21.351  Add  40000003      18  getting-started.orb.local.             FD07:B51A:CC66:0000:A617:DB5E:C0A8:D703%<0>  300
 9:52:21.352  Add  40000002      18  getting-started.orb.local.             192.168.215.3                                300

# 再查看特定主机的解析信息
➜ dns-sd -Q getting-started.orb.local
DATE: ---Sat 04 Nov 2023---
 9:55:31.664  ...STARTING...
Timestamp     A/R  Flags         IF  Name                          Type   Class  Rdata
 9:55:31.668  Add  40000002      18  getting-started.orb.local.    Addr   IN     192.168.215.3

Cool...有了这个能力就非常赞了，我可以轻松地将我的本地 Mysql 连接调整成这个样子。

自定义域名

OrbStack 允许用户自定义容器的域名，在启动容器时通过标签的方式方便的注入。

docker run --rm -l dev.orbstack.domains=foobar.local docker/getting-started

正如上面提到的 OrbStack 是通过 mDNS 来实现域名到 IP 的解析，所以它只对 .local 这个 TLD 有效，在做自定义域名的时候需要注意下。

Domain names

通过访问 http://orb.local 我们可以看到所有正在运行的容器链接。

甚至可以在它的客户端上查看容器列表，单击信息图标获取。

OrbStack + Kind

接下来，我们利用 Local domain names 的能力，重新部署下自签 TLS 证书的流程，看下和上次的分享有什么区别？

1. 获取集群的域名

通过 UI，获取到 Kind 集群的域名：local-control-plane.orb.local

2. 创建 K8s TLS Secret

然后，我们利用 mkcert^[4] 创建了一个通配符证书

➜ mkcert '*.local-control-plane.orb.local'

Created a new certificate valid for the following names 📜
 - "*.local-control-plane.orb.local"

Reminder: X.509 wildcards only go one level deep, so this won't match a.b.local-control-plane.orb.local ℹ️

The certificate is at "./_wildcard.local-control-plane.orb.local.pem" and the key at "./_wildcard.local-control-plane.orb.local-key.pem" ✅

It will expire on 4 February 2026 🗓

并将其作为 K8s TLS Secret 添加到我们的集群中。

kubectl create secret tls tls-secret \
  --key=_wildcard.local-control-plane.orb.local-key.pem \
  --cert=_wildcard.local-control-plane.orb.local.pem

3. 配置 K8s Ingress 使用 TLS Secret

# 创建一个 Nginx Deployment
kubectl create deployment nginx-deployment --image=nginx:1.25.3
# 暴露 Deployment 作为一个 Service
kubectl expose deployment nginx-deployment --port=80

最后，我们在 K8s Ingress 资源中引用了这个 TLS Secret，以启用 HTTPS，对应的域名为：nginx.local-control-plane.orb.local。

kubectl apply -f - <<EOF
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: nginx
spec:
  tls:                                          # 以下 4 行是为了支持 TLS
  - hosts:                                      #
    - nginx.local-control-plane.orb.local       #
    secretName: tls-secret                      #
  rules:
  - host: nginx.local-control-plane.orb.local
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: nginx-deployment
            port:
              number: 80
EOF