---
title: "K3s Homelab"
created: 2026-07-13
updated: 2026-07-13
tags: [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 自动同步

## 常见操作

```bash
# 查看 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>
```
