直接用 Helm 部署 pgAdmin 会失败，因其在 Bitnami PostgreSQL Chart 中仅为 sidecar 组件，不单独暴露服务且不支持自定义配置；推荐用 kubectl port-forward 调试连接，或手动部署独立 pgAdmin 实例，注意 Secret key 必须为 pgadmin-password、ConfigMap 中 servers.json 的 Host 需填 Kubernetes 全限定服务名，Service targetPort 应设为 80；本地 Docker 启动 pgAdmin 更轻量高效，首次访问需等待 20–30 秒初始化。
直接用 Helm 部署 pgAdmin 会失败
Bitnami 的 postgresql Chart 里虽然带了 pgAdmin，但它是作为 sidecar 或可选组件集成的，并不单独暴露服务，也不支持自定义配置（比如初始用户、服务器列表）。硬启这个内置 pgAdmin 很容易连不上，或者登录后看不到数据库。真要用，得单独部署一个独立的 pgAdmin 实例。
kubectl port-forward 是调试阶段最稳的连接方式
别急着暴露 Service 或 Ingress——尤其在开发/测试环境。用 kubectl port-forward 能绕过网络策略、RBAC、TLS、DNS 解析等一堆潜在问题。只要能 kubectl get pods 看到 PostgreSQL Pod 在运行，就能连。
- 先确认 PostgreSQL 服务名：
kubectl get svc -n，找名字含postgresql的项（如my-postgres-postgresql） - 执行端口转发：
kubectl port-forward svc/my-postgres-postgresql 5432:5432 -n - 外部工具（DBeaver/pgAdmin Desktop）连
127.0.0.1:5432，用户名密码按你 Helmvalues.yaml里配的填（比如global.postgresql.auth.postgresPassword）
手动部署 pgAdmin 要绕开两个坑
自己写 YAML 部署 pgAdmin 时，Secret 和 ConfigMap 的 key 名必须和容器内预期的一致，否则启动就报错或登录失败。
-
Secret中密码字段必须叫pgadmin-password（不是PASSWORD或PGADMIN_PASSWORD），值是 base64 编码后的字符串（echo -n 'mypass123' | base64） -
ConfigMap里若挂载servers.json，路径得对应容器内的/pgadmin4/servers.json，且 JSON 结构里Host字段不能写成localhost—— Kubernetes 内部 DNS 解析不到，得填 PostgreSQL Service 的全名，比如my-postgres-postgresql..svc.cluster.local - pgAdmin 容器默认监听
80端口，Service 的targetPort必须设为80，不是5050或5432
用 Docker 启本地 pgAdmin 连 K8s 里的 PostgreSQL 更快
如果你只是想快速查数据、跑 SQL，根本不用把 pgAdmin 也塞进集群。用 Docker 启一个本地实例，让它直连 K8s 内的 PostgreSQL Service（通过 port-forward 或 ClusterIP + NodePort）更轻量、更可控。
命令示例：docker run -d --name pgadmin -p 5050:80 -e 'PGADMIN_DEFAULT_EMAIL=admin@local' -e 'PGADMIN_DEFAULT_PASSWORD=pass123' -v pgadmin-data:/var/lib/pgadmin dpage/pgadmin4:7.14。然后在网页打开 http://127.0.0.1:5050，添加服务器时 Host 填 127.0.0.1，Port 填 5432（前提是已 port-forward）。
真正容易被忽略的是：pgAdmin 容器启动后，第一次访问页面要等 20–30 秒才响应，它在初始化内部 SQLite 数据库；别以为挂了就重试，多等一会儿就行。
