配置
| Flag |
默认值 |
描述 |
--config FILE, -c FILE |
"/etc/rancher/k3s/config.yaml" |
通过文件加载配置 |
日志
| Flag |
默认值 |
环境变量 |
描述 |
--debug
|
N/A |
K3S_DEBUG
|
打开 debug 日志 |
-v value |
0 |
N/A |
日志级别详细程度的数字 |
--vmodule value |
N/A |
N/A |
以逗号分隔的 pattern=N 设置列表，用于文件过滤的日志记录 |
--log value, -l value |
N/A |
N/A |
记录到文件 |
--alsologtostderr
|
N/A |
N/A |
记录到标准错误输出和文件（如果设置） |
集群选项
| Flag |
环境变量 |
描述 |
--token value, -t value |
K3S_TOKEN
|
用于身份认证的 token |
--token-file value |
K3S_TOKEN_FILE
|
用于身份认证的 token 文件 |
--server value, -s value |
K3S_URL
|
要连接的 k3s Server |
数据
| Flag |
默认值 |
描述 |
--data-dir value, -d value |
"/var/lib/rancher/k3s" |
存放数据的目录 |
节点
| Flag |
默认值 |
环境变量 |
描述 |
--node-name value |
N/A |
K3S_NODE_NAME
|
节点名 |
--with-node-id
|
N/A |
N/A |
将 ID 添加到节点名后 |
--node-label value |
N/A |
N/A |
使用标签组来注册和启动 kubelet |
--node-taint value |
N/A |
N/A |
使用污点组来注册 kubelet |
--image-credential-provider-bin-dir value |
"/var/lib/rancher/credentialprovider/bin" |
N/A |
凭证提供商插件二进制文件的路径 |
--image-credential-provider-config value |
"/var/lib/rancher/credentialprovider/config.yaml" |
N/A |
凭证提供商插件配置文件的路径 |
--protect-kernel-defaults
|
N/A |
N/A |
内核调优参数。如果设置，且内核的可设参数与 kubelet 默认值不同，则会出现错误 |
--selinux
|
N/A |
K3S_SELINUX
|
在 containerd 中启用 SELinux |
--lb-server-port value |
6444 |
K3S_LB_SERVER_PORT
|
Supervisor 客户端负载均衡器的本地端口。如果 supervisor 和 apiserver 不在同一地点，则 apiserver 客户端负载均衡器也将使用比该端口少 1 的额外端口。 |
运行时
| Flag |
默认值 |
描述 |
--docker
|
N/A |
用 docker 代替 containerd |
--container-runtime-endpoint value |
N/A |
禁用嵌入式 containerd，使用替代的 CRI 实现 |
--pause-image value |
"docker.io/rancher/pause:3.1" |
针对 containerd 或 Docker 的自定义 pause 镜像 |
--snapshotter value |
overlayfs
|
覆盖默认 containerd snapshotter |
--private-registry value |
/etc/rancher/k3s/registries.yaml
|
私有镜像仓库配置文件 |
网络
| Flag |
环境变量 |
描述 |
--node-ip value, -i value |
N/A |
为节点发布的 IP 地址 |
--node-external-ip value |
N/A |
对外发布节点的 IP 地址 |
--resolv-conf value |
K3S_RESOLV_CONF
|
Kubelet resolv.conf 文件 |
--flannel-iface value |
N/A |
覆盖默认的 flannel 接口 |
--flannel-conf value |
N/A |
覆盖默认的 flannel 文件 |
注意：
如果你想直接设置 kubelet 的 --resolv-conf 值，请使用 --kubelet-arg=resolv-conf=value。只有在设置为有效的 resolv.conf 文件路径时，k3s 标志才会传递给 kubelet。
定制标志
| Flag |
描述 |
--kubelet-arg value |
自定义 kubelet 进程的参数 |
--kube-proxy-arg value |
自定义 kube-proxy 进程的参数 |
实验性
| Flag |
描述 |
--rootless
|
运行 rootless |
弃用
| Flag |
环境变量 |
描述 |
--no-flannel
|
N/A |
使用 --flannel-backend=none
|
--cluster-secret value |
K3S_CLUSTER_SECRET
|
使用 --token
|
Agent 节点的 标签和污点
K3s agent 可以用--node-label和--node-taint这两个选项进行配置，这两个选项可以给 kubelet 添加标签和污点。这两个选项只在注册时添加标签和/或污点，所以只能添加一次，之后不能再通过运行 K3s 命令来改变。
下面这个例子来说明如何添加标签和污点：
--node-label foo=bar \
--node-label hello=world \
--node-taint key1=value1:NoExecute
如果你想在节点注册后更改节点标签和污点，你应该使用kubectl。
K3s Agent CLI 帮助
如果一个选项出现在下面的括号里，例如[$K3S_URL]，则意味着该选项可以作为该名称的环境变量传递进来。
名称:
k3s agent - 运行agent节点
使用:
k3s agent [选项]
选项:
--config FILE, -c FILE (config) 通过文件加载配置 (默认值："/etc/rancher/k3s/config.yaml") [$K3S_CONFIG_FILE]
--debug (logging) 打开 debug 日志 [$K3S_DEBUG]
-v value (logging) 日志级别详细程度的数字 (默认值：0)
--vmodule value (logging) 以逗号分隔的 pattern=N 设置列表，用于文件过滤的日志记录
--log value, -l value (logging) 记录到文件
--alsologtostderr (logging) 记录到标准错误输出和文件（如果设置）
--token value, -t value (cluster) 用于身份认证的 token [$K3S_TOKEN]
--token-file value (cluster) 用于身份认证的 token 文件 [$K3S_TOKEN_FILE]
--server value, -s value (cluster) 要连接的 k3s Server [$K3S_URL]
--data-dir value, -d value (agent/data) 存储数据的目录 (默认值："/var/lib/rancher/k3s")
--node-name value (agent/node) 节点名 [$K3S_NODE_NAME]
--with-node-id (agent/node) 将 ID 添加到节点名后
--node-label value (agent/node) 使用标签组来注册和启动 kubelet
--node-taint value (agent/node) 使用污点组来注册 kubelet
--image-credential-provider-bin-dir value (agent/node) 凭证提供商插件二进制文件的路径 (默认值："/var/lib/rancher/credentialprovider/bin")
--image-credential-provider-config value (agent/node) 凭证提供商插件配置文件的路径 (默认值："/var/lib/rancher/credentialprovider/config.yaml")
--docker (agent/runtime) 用 docker 代替 containerd
--container-runtime-endpoint value (agent/runtime) 禁用嵌入式 containerd，使用替代的 CRI 实现
--pause-image value (agent/runtime) 针对 containerd 或 docker sandbox 的自定义 pause 镜像 (默认值："rancher/mirrored-pause:3.6")
--snapshotter value (agent/runtime) 覆盖默认的 containerd snapshotter (默认值："overlayfs")
--private-registry value (agent/runtime) 私有镜像仓库配置文件 (默认值："/etc/rancher/k3s/registries.yaml")
--node-ip value, -i value (agent/networking) 发布节点的 IPv4/IPv6 地址
--node-external-ip value (agent/networking) 对外发布节点的 IPv4/IPv6 IP 地址
--resolv-conf value (agent/networking) Kubelet resolv.conf 文件 [$K3S_RESOLV_CONF]
--flannel-iface value (agent/networking) 覆盖默认的 flannel 接口
--flannel-conf value (agent/networking) 覆盖默认的 flannel 配置文件
--kubelet-arg value (agent/flags) kubelet 进程的自定义标志
--kube-proxy-arg value (agent/flags) kube-proxy 进程的自定义标志
--protect-kernel-defaults (agent/node) 内核调优参数。如果设置，且内核的可设参数与 kubelet 默认值不同，则会出现错误
--rootless (experimental) 运行 rootless
--selinux (agent/node) 在 containerd 中启动 SELinux [$K3S_SELINUX]
--lb-server-port value (agent/node) Supervisor 客户端负载均衡器的本地端口。如果 supervisor 和 apiserver 不在同一地点，则 apiserver 客户端负载均衡器也将使用比该端口少 1 的额外端口 (默认值：6444) [$K3S_LB_SERVER_PORT]
--no-flannel (deprecated) 使用 --flannel-backend=none
--cluster-secret value (deprecated) 使用 --token [$K3S_CLUSTER_SECRET]
更多建议：