如何禁用k3s集群认证，以便在Testcontainers测试中用kubectl调试

你遇到的问题是k3s默认启用了认证机制，这里提供两种可行的解决办法：

方法一：启动k3s时直接禁用认证 #

启动k3s容器时，给server命令添加--disable-auth参数即可关闭认证。用Testcontainers配置的话，以Java代码为例：

K3sContainer k3s = new K3sContainer(DockerImageName.parse("rancher/k3s:latest"))
    .withCommand("server", "--disable-auth");

其他语言的Testcontainers配置逻辑一致，只要给k3s的启动命令加上该参数。这样启动后，你之前配置kubectl上下文的命令就能直接生效，不会再要求提供凭证。

方法二：使用Testcontainers生成的kubeconfig（更推荐） #

Testcontainers的k3s容器本身自带可用的kubeconfig，直接复用它既能正常访问集群，又能保留认证机制，更贴近真实生产环境的测试场景。

以Java代码为例，可直接获取kubeconfig内容：

// 容器启动后获取内置kubeconfig的内容
String kubeConfigContent = k3s.getKubeConfigContent();

// 将内容写入本地文件，或直接设置环境变量指定配置文件路径
Files.write(Paths.get(System.getProperty("user.home") + "/.kube/config-test"), kubeConfigContent.getBytes());
System.setProperty("KUBECONFIG", System.getProperty("user.home") + "/.kube/config-test");

设置完成后，直接运行kubectl get pods就能正常访问集群，无需手动配置上下文。

如果是断点时手动操作，可从容器中拷贝kubeconfig：

# 将容器内的kubeconfig文件拷贝到本地
docker cp <容器ID>:/etc/rancher/k3s/k3s.yaml ~/.kube/k3s-test.yaml
# 让kubectl使用这个配置文件
export KUBECONFIG=~/.kube/k3s-test.yaml
# 验证集群访问
kubectl get pods

注意：拷贝出来的kubeconfig中server字段是容器内部IP，需要修改为你映射的https://localhost:52067才能正常访问。

总结 #

• 追求快速调试：直接添加--disable-auth参数禁用认证
• 贴近真实场景：复用容器自带的kubeconfig，保留认证机制

内容的提问来源于stack exchange，提问作者Fabrizio Fortino