메뉴
端到端在一台 VPS 上部署 k3s + domain-manager + DNS/SSL 的總流程。依序串起六個子 skill：k3s-preflight → k3s-install →（條件式）k3s-migrate-proxy → k3s-domain-manager → k3s-dns-ssl → k3s-kubeconfig，並在每個 關卡驗證、遇到既有正式服務時停下確認。當使用者要「完整一次跑完」整套 VPS 上的 k3s 部署與 DNS/SSL 設定時使用； 若只想做其中一段，直接呼叫對應的子 skill 即可。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
處理 k3s 上的 DNS 與 Let's Encrypt SSL——診斷 DNS 委派（dig +trace 從 parent 找真權威、用 MX 當指紋比對 面板 vs 對外權威、SOA serial 驗有沒有真的發布）、讓子網域指向叢集、用 cert-manager 自動簽憑證；並提供上線前 用 --resolve + 真實 ACME challenge token 預驗整條鏈路的方法。當子網域或 HTTPS 憑證沒生效要排查、DNS「設了卻 不通」、或上線前要先確認機器端 100% 就緒時使用。
在 k3s 上用 Helm 部署 domain-manager（github.com/timcsy/domain-manager）與其相依的 cert-manager， 設定 Traefik ingress class 與 Let's Encrypt ClusterIssuer，並掛上 domain-manager UI 的 ingress。 當要部署 domain-manager 來用 Web UI/API/MCP 管理子網域→service 對應與自動 SSL 時使用。內含 image tag 與 admin 密碼的已知 chart 陷阱與規避方式。
在 VPS 上安裝單節點 k3s（保留內建 Traefik 與 ServiceLB），設定免 sudo 的 kubeconfig，並安裝 Helm 3。 當要從零建立 k3s 叢集、或為部署應用準備 Kubernetes 環境時使用。執行前建議先跑 k3s-preflight 確認 80/443 的處理方式；若 80/443 已被既有服務占用，安裝會即時搶占 port，需搭配 k3s-migrate-proxy。
產生可攜的 k3s kubeconfig，讓本機/CI 從任何地方操作叢集——幫 k3s API 憑證加 tls-san、把 server 從 127.0.0.1 改成 domain、確認 6443 對外可達、把 context/cluster/user 改名避免與其他 kubeconfig 撞名， 並用 .gitignore 保護內含的 cluster-admin 憑證。當要遠端 kubectl/helm 操作 k3s、或把 kubeconfig 交給 其他機器使用時用。
把 VPS 上既有的反向代理（systemd nginx/apache/caddy 等，正佔用 80/443 服務正式網站）安全遷移到 k3s 的 Traefik——後端用 external Service+Endpoints 指向原本的容器/程序、沿用既有 TLS 憑證、用 per-router middleware 做 HTTP→HTTPS 轉址，驗證無誤後才停用舊 proxy，不中斷服務。當 k3s 要接管已被占用的 80/443、或要把既有 reverse proxy 收進叢集時使用。這是條件式步驟：只有偵測到既有 80/443 服務才需要。
部署 k3s 前偵測 VPS 環境是否就緒——OS/arch、使用者與 sudo、公網 IP、資源、既有 k8s，以及最關鍵的 80/443 佔用者與既有正式服務。當要在一台 VPS 上裝 k3s、或評估某主機現況、或排查「裝 k3s 會不會打斷既有服務」時使用。 輸出一份環境摘要與建議的處理路線，供後續 k3s-install / k3s-migrate-proxy 參考。
| name | k3s-vps-deploy |
| description | 端到端在一台 VPS 上部署 k3s + domain-manager + DNS/SSL 的總流程。依序串起六個子 skill：k3s-preflight → k3s-install →（條件式）k3s-migrate-proxy → k3s-domain-manager → k3s-dns-ssl → k3s-kubeconfig，並在每個 關卡驗證、遇到既有正式服務時停下確認。當使用者要「完整一次跑完」整套 VPS 上的 k3s 部署與 DNS/SSL 設定時使用； 若只想做其中一段，直接呼叫對應的子 skill 即可。 |
把六個子 skill 串成完整流程。先一次收齊參數，再依序呼叫各子 skill（用 Skill 工具）；子 skill 共用對話中的參數與偵測結果。
| 參數 | 說明 |
|---|---|
SSH_TARGET | user@host |
ADMIN_EMAIL | Let's Encrypt 信箱 |
UI_HOST | domain-manager UI 網址（如 dns.app.example.com） |
SSL_MODE | http01（DNS 已/將指向本機）或 dns01（Cloudflare token，可簽 wildcard） |
CF_TOKEN | 僅 dns01 |
KUBECONFIG_DOMAIN | 可攜 kubeconfig 的 API domain |
k3s-preflight偵測環境，特別看 80/443 是否被占用。把摘要與建議路線交使用者確認。
→ 決定變數 MIGRATE_EXISTING：80/443 被既有服務占用 = 需要遷移。
k3s-installMIGRATE_EXISTING=true：兩種策略擇一——(a) 安裝時 --disable traefik servicelb，遷移資源備好後再啟用；或 (b) 保留 Traefik 但把 k3s-migrate-proxy 的資源緊接著套上，把中斷壓到最短。動既有正式服務前先向使用者確認。k3s-migrate-proxy僅當 MIGRATE_EXISTING=true 才執行：把既有反代遷到 Traefik、沿用既有憑證、驗證後才停舊 proxy。乾淨主機跳過此步。
k3s-domain-managerHelm 部署 domain-manager + cert-manager，掛 UI ingress。注意 image tag→main、admin 初始密碼 admin/admin。
k3s-dns-ssl讓 UI_HOST 解析到本機（必要時先做委派診斷），用 cert-manager 自動簽憑證。DNS 由外部單位管時：先用該 skill 的 --resolve 預驗證明機器端就緒，把「加 DNS 記錄 / 發布」這一步交回使用者，待生效後回來完成驗證。
k3s-kubeconfig加 tls-san、產生可攜 kubeconfig、.gitignore 保護。
curl -s -o /dev/null -w "UI HTTPS %{http_code} verify=%{ssl_verify_result}\n" "https://$UI_HOST/"
KUBECONFIG=<out>/cluster.yaml kubectl get nodes
全綠＝對外 HTTPS verify=0、cert Ready、可攜 kubeconfig 能操作叢集。
--resolve 預驗先證明機器端 OK，再把球交回使用者。image.tag=main。--set 密碼無效，初始 admin/admin，登入後改。dig +trace 找真權威、MX 指紋、SOA serial 驗發布；面板要「發布」。.gitignore。ss 看不到 80/443 listener 正常（klipper 走 DNAT），以 curl 為準。