---
title: 自宅鯖紹介
description: 自宅で動かしているPC 4台のサーバー構成をまとめます．Proxmox と Talos Kubernetes，外部アクセス，構成管理，監視と今後やりたいことを書いておきます．
date: 2026-03-30
published: true
tags: ["proxmox", "kubernetes", "talos", "terraform", "gitops"]
emoji: 🖥
---

<Message type="alert">
  この記事はAIを利用して生成された内容を含みます。
</Message>

自宅で動かしているサーバーの紹介です．大した構成ではないですが，今の状態を記録として書いておきます．

ミニPC，デスクトップ，ノートPCを組み合わせて運用しています．
物理マシンは4台で，Proxmox で仮想化し，その上に Talos Linux の Kubernetes クラスタを構築しています．
アプリとプレビュー環境を動かしながら，構成管理，監視，バックアップを整えています．

## 全体の構成

仮想化基盤は Proxmox，Kubernetes のノード OS は Talos Linux です．
基盤の作成と設定には Terraform，Kubernetes 上のアプリの管理には Argo CD と Helm を使っています．
外部アクセスは Cloudflare Tunnel を経由し，管理画面などの認証を Cloudflare Access で行います．

<Image
  src="/images/onprem-kubernetes-architecture.svg"
  alt="物理PC 4台の Proxmox 上に Talos Kubernetes を配置し，Cloudflare Tunnel で外部と接続する構成．基盤は Terraform，アプリは Argo CD で管理し，監視アラートを Slack に通知する．"
/>

図1：仮想化基盤，Kubernetes，外部アクセスと構成管理の関係です．サービスごとに冗長化の範囲は異なります．

## 物理マシンと VM の配置

4台は同じスペックではありません．メモリを多く積んだデスクトップもあれば，CPU に余裕があってもメモリが制約になるノートPCもあります．
各マシンで余っている資源と，アプリが必要とする資源を見て配置を決めています．

モデムに RTX1200 と Wi-Fi アクセスポイントを接続しています．RTX1200 はスイッチとして使い，その先に4台のPCをつないでいます．

<Image
  src="/images/onprem-hardware.svg"
  alt="モデムから RTX1200 と Wi-Fi アクセスポイントに分岐し，スイッチとして使う RTX1200 に4台のPCを接続する構成．"
/>

図2：機器の接続関係の概略です．ポート番号や配線経路は省略しています．

各PCのスペックと主な配置は次のとおりです．

| PC | CPU | メモリ | 主な配置 |
| --- | --- | --- | --- |
| ミニPC | Core i5-7260U | 16 GB | Control Plane 2，開発用 LXC |
| デスクトップ | Xeon E-2174G | 32 GB | Control Plane 1，Worker 1，開発用 LXC，CI ランナー |
| ノートPC A | Ryzen 7 4800HS | 8 GB | Worker 2 |
| ノートPC B | Core i3-8145U | 8 GB | Control Plane 3，Worker 3，バックアップ先 |

メモリは物理マシンの公称容量です．

Proxmox 上には用途に応じて VM と LXC コンテナを配置しています．
Kubernetes は Talos Linux の VM で構成し，Control Plane が3台，Worker が3台です．
Control Plane は別々の物理ホストに分散しています．
Kubernetes 内のネットワークには Cilium，LAN 内でサービスに固定 IP を割り当てる用途には MetalLB を使っています．

開発環境は LXC で動かし，アプリやプレビュー環境は Kubernetes に配置しています．

## 動かしているアプリ

ブックマークサービスと，自作の記事推薦システムを構築して動かしています．
それぞれの仕組みや使い方は，後日，別の記事で紹介したいと思っています．

## Cloudflare Tunnel による外部アクセス

外部アクセスには Cloudflare Tunnel を使っています．
クラスタ内の `cloudflared` が外向きに接続するので，ルーターでサービスごとのポート開放をせずに公開できます．
`cloudflared` は2レプリカで，異なるワーカーノードに配置しています．

管理画面などには Cloudflare Access を設定し，GitHub 認証でアクセスを制御しています．
機械から送るテレメトリには Service Token を使い，人がブラウザで開く画面と認証方法を分けています．

## Terraform と Argo CD の分担

構成管理では，基盤の作成と設定，アプリの継続的な管理，ホストの設定を次のように分担しています．

- Terraform は Proxmox の VM，Talos，Cloudflare を管理し，Argo CD などの初期構築にも使います．
- Argo CD と Helm は Kubernetes 上のアプリを管理します．
- Ansible は Proxmox ホストへの監視エージェントの導入や定期処理の設定に使います．

Terraform は GitHub Actions から実行します．
LAN 内の API に接続する処理は，オンプレ側のセルフホストランナーで動かしています．
State の保存先は Cloudflare R2 です．

アプリの定義は Helm Chart として Git に置き，Argo CD で Kubernetes に同期しています．
設定変更は Git の履歴から確認できます．

## 監視・ログ・トレース

メトリクスの収集と可視化には Prometheus と Grafana を使っています．
ログは Alloy で集めて Loki に保存し，トレースは OpenTelemetry Collector と Tempo で扱っています．

アラートは Alertmanager を経由して Slack に通知しています．

Proxmox ホストの CPU・メモリに加え，次の項目も監視しています．

- Proxmox の VM・ストレージの使用状況
- LAN，インターネット，DNS の疎通
- 回線の実効速度
- アプリの状態
- Claude Code の使用量やコスト

外部から接続できない場合でも，原因は回線，物理ホスト，アプリのいずれにもあり得ます．
それぞれの状態を記録して，どこで問題が起きているかを切り分けられるようにしています．

## 今後やりたいこと

バックアップは restic で別の物理ホストへ保存する構成を用意しています．
今後はリストア試験を行い，バックアップ対象を追加し，オフサイトへの複製も進めたいです．
元データと保存先が同じ場所にあるため，別の物理ホストへ保存するだけでは対応できない障害もあります．

LXC も Terraform で管理できるようにしたいです．

今はメモリとストレージに余裕がなく，試せる構成が限られています．
もっと余裕のあるハードウェアを導入して，いろいろなソフトウェアや構成を試したいです．



