> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 基础简介 | Infra Introduction

# 🏗️ 基础设施概览 | Infrastructure Overview

## 🏗️ 集群架构 | Cluster Architecture

### 节点配置

| 节点            | 规格   | 磁盘  | 主要服务                      |
| ------------- | ---- | --- | ------------------------- |
| **master-01** | 2C4G | SSD | NPM 网关、K8s 控制平面、Ghost     |
| **worker-01** | 4C8G | HDD | 初始计算节点、基础应用               |
| **worker-02** | 2C4G | HDD | 纯计算节点、n8n 工作流             |
| **worker-03** | 4C8G | SSD | 核心存储中心、PostgreSQL、MongoDB |

<CardGroup cols={3}>
  <Card title="控制节点" icon="server">
    master-01 负责集群管理和核心服务
  </Card>

  <Card title="工作节点" icon="network-wired">
    worker-01/02 运行业务应用和数据服务
  </Card>

  <Card title="高可用" icon="shield">
    多节点部署确保服务稳定性
  </Card>
</CardGroup>

## 🌐 服务访问 | Service Access

### 核心服务域名

| 域名                                               | 服务                  | 说明         | 账号                |
| ------------------------------------------------ | ------------------- | ---------- | ----------------- |
| [`kuber.akria.net`](https://kuber.akria.net)     | Nginx Proxy Manager | 流量网关和管理面板  | `admin@akria.net` |
| [`monitor.akria.net`](https://monitor.akria.net) | Grafana             | 监控仪表盘      | `admin`           |
| [`blog.akria.net`](https://blog.akria.net)       | Ghost               | 博客系统       | `admin@akria.net` |
| [`n8n.akria.net`](https://n8n.akria.net)         | n8n                 | 自动化工作流     | `admin@akria.net` |
| [`db.akria.net`](https://db.akria.net)           | NocoDB              | NocoDB 数据库 | `admin@akria.net` |
| [`chat.akria.net`](https://chat.akria.net)       | Rocket.chat         | 聊天软件       | 你自己账号             |

<Tip>
  所有服务通过 Nginx Proxy Manager 进行统一流量管理和 SSL 证书配置。
</Tip>

## 📂 项目结构 | Project Structure

```
insightful-ops/
├── manifests/          # K8s 部署清单 (Infra & Apps)
├── docs/               # 知识中心 (Mintlify & Ops Manual)
└── .backups/           # 本地数据备份 (已隐藏)
```

<Note>
  每个服务目录都包含详细的配置说明，请查看对应目录的 README.md。
</Note>

## 🏷️ 命名空间 | Namespaces

集群采用命名空间隔离不同类别的服务：

<CodeGroup>
  ```yaml npm 命名空间 theme={null}
  # 流量网关 (Nginx Proxy Manager)
  namespace: npm
  ```

  ```yaml infra 命名空间 theme={null}
  namespace: infra
  ```

  ```yaml apps 命名空间 theme={null}
  # 业务应用 (n8n, Ghost)
  namespace: apps
  ```

  ```yaml monitoring 命名空间 theme={null}
  # 监控系统 (Grafana, Prometheus)
  namespace: monitoring
  ```
</CodeGroup>

## 🔧 核心组件 | Core Components

<AccordionGroup>
  <Accordion title="Nginx Proxy Manager" icon="network-wired">
    负责所有服务的反向代理、SSL 证书管理和流量分发。
  </Accordion>

  <Accordion title="PostgreSQL" icon="database">
    主要数据库服务，为应用提供数据存储。
  </Accordion>

  <Accordion title="Grafana" icon="chart-line">
    监控和可视化平台，展示集群和服务的运行状态。
  </Accordion>
</AccordionGroup>

## � 深度探索 | Infrastructure Deep Dive

<CardGroup cols={2}>
  <Card title="节点档案" icon="server" href="/technical/infra-deploy/nodes-profiles">
    详细记录集群各节点的硬件规格、角色定位与扩容档案。
  </Card>

  <Card title="存储持久化" icon="database" href="/technical/infra-deploy/storage-persistence">
    了解 K3s Local Path 管理逻辑与核心数据库的物理分布。
  </Card>

  <Card title="备份策略" icon="shield-check" href="/technical/infra-deploy/backup-strategy">
    掌握 MongoDB、Postgres 及系统配置的自动化回库方案。
  </Card>

  <Card title="部署指南" icon="rocket" href="/technical/infra-deploy/deployment-guide">
    生产环境下的服务发布流程与故障排查手册。
  </Card>
</CardGroup>

<Note>
  所有基础设施变更均需遵循 **GitOps** 原则，通过修改 `manifests/` 目录下的 YAML 并提交 PR 来触发集群更新。
</Note>