Files
kb/wiki/tech/k3s-homelab.md
T

1.2 KiB

title, created, updated, tags
title created updated tags
K3s Homelab 2026-07-13 2026-07-13
tech/k3s
tech/infra
tech/homelab

K3s Homelab

拓扑

  • 主节点: 192.168.1.2 (单节点 K3s)
  • 访问: SSH -p22422, kubectl via kubeconfig
  • NAS: 192.168.1.5, NFS at /mnt/nas

关键 Namespace

Namespace 用途
links Links App + API
apps 通用应用
ai AI/Agent 相关服务

核心服务

  • ArgoCD: GitOps 部署,repo = ~/Code/home-docker
  • Links App: http://go — 个人书签/文章管理
  • Demo Service: demo.junv.cc — 演示网站
  • SearXNG: searxng.home-apps — 元搜索引擎
  • Jackett: jackett.home-apps — Torrent 索引

域名分工

  • junv.cc → K3s 内部服务 (go, demo, sear)
  • heygo.cc → Cloudflare Workers/Pages 应用

部署原则

  • 优先使用官方 Docker 镜像
  • 不写自定义 Dockerfile
  • ConfigMap 管理配置
  • ArgoCD 自动同步

常见操作

# 查看 pod 状态
kubectl get pods -A

# 查看特定 namespace
kubectl get all -n apps

# 重启 deployment
kubectl rollout restart deploy/<name> -n <ns>

# 查看日志
kubectl logs -f deploy/<name> -n <ns>