303 lines
10 KiB
Markdown
303 lines
10 KiB
Markdown
|
# 最終アーキテクチャ決定版（Synology中心構成）
|
|||
|
|
|
|||
|
|
**作成日**: 2026-01-19
|
|||
|
|
**決定**: Synology VM内でDokployを動かす構成を採用
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 **最終構成の全体像**
|
|||
|
|
|
|||
|
|
### **基本思想**
|
|||
|
|
```
|
|||
|
|
全てをSynology内で完結させる
|
|||
|
|
↓
|
|||
|
|
外部VPSは使わない（コストゼロ化）
|
|||
|
|
↓
|
|||
|
|
DokployはSynology VM内で動かす
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📐 **物理構成**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
┌─────────────────────────────────────────────────┐
|
|||
|
|
│ あなたの自宅 Synology NAS (16GB) │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───────────────────────────────────────────┐ │
|
|||
|
|
│ │ DSM（Synology OS） │ │
|
|||
|
|
│ │ - Container Manager │ │
|
|||
|
|
│ │ - Virtual Machine Manager (VMM) │ │
|
|||
|
|
│ └───────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───────────────────────────────────────────┐ │
|
|||
|
|
│ │ VM #1: Ubuntu Server (4GB RAM割当) │ │
|
|||
|
|
│ │ ┌─────────────────────────────────────┐ │ │
|
|||
|
|
│ │ │ Dokploy (自動デプロイエンジン) │ │ │
|
|||
|
|
│ │ │ - Traefik (リバースプロキシ) │ │ │
|
|||
|
|
│ │ │ - Docker (アプリコンテナ) │ │ │
|
|||
|
|
│ │ └─────────────────────────────────────┘ │ │
|
|||
|
|
│ └───────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───────────────────────────────────────────┐ │
|
|||
|
|
│ │ Docker Containers (DSM直下) │ │
|
|||
|
|
│ │ - PostgreSQL (データベース) │ │
|
|||
|
|
│ │ - Redis (キャッシュ) │ │
|
|||
|
|
│ │ - Immich (写真管理+AI検索) │ │
|
|||
|
|
│ │ - Ollama (ローカルAI) │ │
|
|||
|
|
│ └───────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
│ ┌───────────────────────────────────────────┐ │
|
|||
|
|
│ │ Gitea (DSM直下Dockerコンテナ) │ │
|
|||
|
|
│ │ - コード管理 │ │
|
|||
|
|
│ │ - Webhook → Dokploy連携 │ │
|
|||
|
|
│ └───────────────────────────────────────────┘ │
|
|||
|
|
│ │
|
|||
|
|
└─────────────────────────────────────────────────┘
|
|||
|
|
↑
|
|||
|
|
│ Tailscale VPN (安全な通信)
|
|||
|
|
│
|
|||
|
|
┌─────────────────────────────────────────────────┐
|
|||
|
|
│ あなたのPC (開発環境) │
|
|||
|
|
│ - Cursor / Claude Code │
|
|||
|
|
│ - Git → Giteaにプッシュ │
|
|||
|
|
└─────────────────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔌 **ネットワーク構成**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
外部インターネット
|
|||
|
|
↓
|
|||
|
|
Tailscale Funnel (HTTPS公開エンドポイント)
|
|||
|
|
↓
|
|||
|
|
https://posimai.ts.net
|
|||
|
|
↓
|
|||
|
|
Synology VM (Dokploy)
|
|||
|
|
↓
|
|||
|
|
┌─────────────────────────────────────┐
|
|||
|
|
│ VM内のDockerコンテナ │
|
|||
|
|
│ - sake-app (日本酒アプリAPI) │
|
|||
|
|
│ - incense-app (お香アプリAPI) │
|
|||
|
|
│ - nail-salon (ネイルサロンWeb) │
|
|||
|
|
└─────────────────────────────────────┘
|
|||
|
|
↓ データアクセス
|
|||
|
|
┌─────────────────────────────────────┐
|
|||
|
|
│ Synology DSM直下 │
|
|||
|
|
│ - PostgreSQL (100.x.x.x:5432) │
|
|||
|
|
│ - Redis (100.x.x.x:6379) │
|
|||
|
|
└─────────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 💾 **メモリ配分（16GB）**
|
|||
|
|
|
|||
|
|
| コンポーネント | 割当メモリ | 用途 |
|
|||
|
|
|---------------|-----------|------|
|
|||
|
|
| **DSM本体** | 2GB | Synology OS |
|
|||
|
|
| **VM (Ubuntu + Dokploy)** | 4GB | 自動デプロイ + アプリ実行 |
|
|||
|
|
| **PostgreSQL** | 2GB | データベース |
|
|||
|
|
| **Immich** | 2-3GB | 写真管理+CLIP検索 |
|
|||
|
|
| **Ollama** | 4GB | ローカルAI（夜間起動） |
|
|||
|
|
| **Redis + その他** | 1-2GB | キャッシュ等 |
|
|||
|
|
| **予備** | 1GB | バッファ |
|
|||
|
|
|
|||
|
|
**合計**: 16GB（ギリギリだが実現可能）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔄 **自動化フロー**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
1. コード編集
|
|||
|
|
┌─────────────────┐
|
|||
|
|
│ Cursor/Claude │
|
|||
|
|
│ Code → Git編集 │
|
|||
|
|
└────────┬────────┘
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
2. Git Push
|
|||
|
|
┌─────────────────┐
|
|||
|
|
│ Gitea (Synology)│
|
|||
|
|
│ リポジトリ受信 │
|
|||
|
|
└────────┬────────┘
|
|||
|
|
│ Webhook
|
|||
|
|
▼
|
|||
|
|
3. 自動デプロイ
|
|||
|
|
┌─────────────────┐
|
|||
|
|
│ Dokploy (VM内) │
|
|||
|
|
│ - コードpull │
|
|||
|
|
│ - Build │
|
|||
|
|
│ - Deploy │
|
|||
|
|
└────────┬────────┘
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
4. 本番更新
|
|||
|
|
┌─────────────────┐
|
|||
|
|
│ アプリ稼働 │
|
|||
|
|
│ (VM内Docker) │
|
|||
|
|
└─────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**所要時間**: Git Pushから30秒-2分
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🚀 **なぜこの構成が最適か**
|
|||
|
|
|
|||
|
|
### **1. コストゼロ**
|
|||
|
|
- ✅ 外部VPS不要
|
|||
|
|
- ✅ 月額費用: Synology電気代のみ（¥800程度）
|
|||
|
|
- ✅ 年間コスト: ¥9,600
|
|||
|
|
|
|||
|
|
### **2. レイテンシ最小**
|
|||
|
|
- ✅ VM ↔ PostgreSQL: 同一物理マシン内（<1ms）
|
|||
|
|
- ✅ データ転送ゼロ（内部通信）
|
|||
|
|
|
|||
|
|
### **3. データ主権**
|
|||
|
|
- ✅ すべてのデータが手元
|
|||
|
|
- ✅ クラウド依存ゼロ
|
|||
|
|
|
|||
|
|
### **4. Synologyの強みを最大活用**
|
|||
|
|
- ✅ 16GBメモリを全て使い切る
|
|||
|
|
- ✅ VMM（仮想マシン機能）の活用
|
|||
|
|
- ✅ Container Managerとの共存
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ⚠️ **この構成の注意点**
|
|||
|
|
|
|||
|
|
### **1. ポート80/443問題の解決**
|
|||
|
|
```
|
|||
|
|
問題: DSMとDokploy（Traefik）が両方Port 80/443を使いたい
|
|||
|
|
|
|||
|
|
解決: VM内で完結させる
|
|||
|
|
- DSM: Port 80/443を維持（管理画面用）
|
|||
|
|
- VM: 独自のIPアドレス（Tailscaleで公開）
|
|||
|
|
- → ポート競合なし
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **2. メモリ不足リスク**
|
|||
|
|
```
|
|||
|
|
対策:
|
|||
|
|
- Ollamaは夜間バッチのみ起動（常駐させない）
|
|||
|
|
- Immichは必要時のみ起動
|
|||
|
|
- Dokploy VM: 必要最低限の4GB
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **3. CPU負荷**
|
|||
|
|
```
|
|||
|
|
懸念: VM + Docker二重仮想化でCPU負荷増
|
|||
|
|
|
|||
|
|
現実:
|
|||
|
|
- Synology CPU（Intel/AMD）は十分強力
|
|||
|
|
- アプリがシンプルなら問題なし
|
|||
|
|
- 負荷テストで要確認
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📊 **VPS案との比較**
|
|||
|
|
|
|||
|
|
| 観点 | VPS + Synology案 | Synology VM案（最終採用） |
|
|||
|
|
|------|-----------------|------------------------|
|
|||
|
|
| **月額コスト** | ¥1,300 | **¥800** |
|
|||
|
|
| **レイテンシ** | VPS↔Synology: 1-5ms | **VM↔DB: <1ms** |
|
|||
|
|
| **メモリ余裕** | Synology: 10GB余裕 | Synology: 1GB余裕 |
|
|||
|
|
| **設定複雑度** | VPS設定 + Tailscale | **VMM設定のみ** |
|
|||
|
|
| **障害時影響** | VPS停止 or Synology停止 | **Synology停止のみ** |
|
|||
|
|
|
|||
|
|
**結論**: Synology VM案が最適
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🛠️ **実装手順（Week 1-4）**
|
|||
|
|
|
|||
|
|
### **Week 1: VM準備**
|
|||
|
|
```bash
|
|||
|
|
1. Synology VMM (Virtual Machine Manager) インストール
|
|||
|
|
- パッケージセンターから検索
|
|||
|
|
|
|||
|
|
2. Ubuntu Server 22.04 LTS ダウンロード
|
|||
|
|
- https://ubuntu.com/download/server
|
|||
|
|
|
|||
|
|
3. VM作成
|
|||
|
|
- CPU: 2コア
|
|||
|
|
- メモリ: 4GB
|
|||
|
|
- ストレージ: 40GB
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **Week 2: Dokployインストール**
|
|||
|
|
```bash
|
|||
|
|
# VM内で実行
|
|||
|
|
curl -sSL https://dokploy.com/install.sh | sh
|
|||
|
|
|
|||
|
|
# 管理画面アクセス
|
|||
|
|
# Synology DSM → VMM → VM IPアドレス確認
|
|||
|
|
# http://vm-ip:3000
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **Week 3: Tailscale設定**
|
|||
|
|
```bash
|
|||
|
|
# VM内でTailscaleインストール
|
|||
|
|
curl -fsSL https://tailscale.com/install.sh | sh
|
|||
|
|
tailscale up
|
|||
|
|
|
|||
|
|
# Funnel有効化（HTTPS公開）
|
|||
|
|
tailscale funnel 3000
|
|||
|
|
# → https://vm-name.ts.net でアクセス可能
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **Week 4: Gitea連携**
|
|||
|
|
```yaml
|
|||
|
|
# Dokploy管理画面で設定
|
|||
|
|
Repository: http://synology-tailscale-ip:3000/user/sake-app.git
|
|||
|
|
Branch: main
|
|||
|
|
Auto Deploy: ON
|
|||
|
|
Environment Variables:
|
|||
|
|
DATABASE_URL: postgresql://user:pass@synology-ip:5432/posimai
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🎯 **開発者がやること（通常運用）**
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
1. Cursorでコード編集
|
|||
|
|
2. git add . && git commit -m "新機能追加"
|
|||
|
|
3. git push origin main
|
|||
|
|
|
|||
|
|
→ 30秒後、本番環境に自動反映
|
|||
|
|
|
|||
|
|
あなたがやること: これだけ。
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📝 **次のアクション**
|
|||
|
|
|
|||
|
|
### **今すぐできること**
|
|||
|
|
```
|
|||
|
|
1. Synology DSMにログイン
|
|||
|
|
2. パッケージセンター → "Virtual Machine Manager" インストール
|
|||
|
|
3. Ubuntu Server 22.04 ISOダウンロード
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**所要時間**: 15分
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🔗 **関連ドキュメント**
|
|||
|
|
|
|||
|
|
- [VPS比較分析](./VPS_CRITICAL_COMPARISON.md)
|
|||
|
|
- [自動化安全プロトコル](./AUTOMATION_SAFETY_PROTOCOL.md)
|
|||
|
|
- [アーキテクチャ決定記録](./ARCHITECTURE_DECISION_RECORD.md)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**更新履歴**:
|
|||
|
|
- 2026-01-19: VPS案からSynology VM案に変更（最終決定）
|