从现有项目开始
连接 Git 仓库、使用容器镜像，或从 YAML 与应用模板开始。
LUMA / CONTROL PLANE
Luma ControlDNS · TLS · Nomad
CLI / CI 控制台
Luma ControlDNS · TLS · Nomadcn云服务器
global云服务器
home私网节点
区域决定部署位置，入口决定访问方式。
应用
管理应用、服务实例与发布版本。
应用管理 4健康 4降级 0失败 0
4 / 4
| 应用 | 状态 | 访问地址 | 区域 | 节点 | 副本 | 操作 |
|---|---|---|---|---|---|---|
| website1 个服务 | 运行 | www.example.com | global | global-edge | 2/2 | |
| api1 个服务 | 运行 | api.example.com | global | global-edge | 2/2 | |
| worker1 个服务 | 运行 | 内部访问 | cn | cn-edge | 1/1 | |
| storage1 个服务 | 运行 | 内部访问 | home | home-worker | 1/1 | |
| 没有匹配的应用 | ||||||
路由
完整路径关系从域名出发，查看入口、中继与最终服务。
展示配置与实例关系，不代表逐跳连通性探测。
资源指标
15 min把当前数值与历史趋势放在一起看。
CPU42%最后采样
节点用量示意曲线 · 实际采样缺口保留断点
交付
从代码到上线，逐步查看构建与部署结果。
websitemain ·
部署完成8d2a4f1- ✓拉取代码2s
- ✓构建镜像38s
- ✓推送镜像8s
- ✓部署应用12s
部署区域 global就绪副本 2 / 2总耗时 1 min
可观测
从告警定位对象，结合日志排查，并跟踪通知结果。
触发中1
启用规则3
通知渠道1
警告
worker · 内存使用率偏高
86% · 持续 5 分钟 · 通知已发送
关联服务日志
12:15:03 worker [info] Processing batch 128
12:15:04 worker [warn] Memory usage above threshold总览
集群、应用与交付的运行概况。
| 资源 | 状态 | 详情 |
|---|---|---|
| 应用 | 4 个运行中 | 6 个就绪副本 |
| 节点 | 3 个就绪 | cn · global · home |
| 最近交付 | 已完成 | website · main · 1 min |
告警事件
按触发时间查看告警，追踪恢复和通知结果。
| 对象 | 告警 | 状态 |
|---|---|---|
| worker | 内存使用率 86% · 持续 5 分钟 | 触发中 |
| api | 响应延迟恢复正常 | 已恢复 |
应用观测
将服务健康、响应时间和错误率关联到应用。
| 应用 | 响应时间 | 错误率 | 状态 |
|---|---|---|---|
| website | 28 ms | 0.0% | 健康 |
| api | 64 ms | 0.1% | 健康 |
| worker | — | 0.0% | 内存告警 |
服务日志
将多个服务的输出集中查看，保留实例与时间信息。
worker / worker-01stdout · stderr
12:15:01 [info] Worker ready 12:15:02 [info] Connected to queue 12:15:03 [info] Processing batch 128 12:15:04 [warn] Memory usage above threshold 12:15:05 [info] Batch completed in 1.2s 12:15:06 [info] Waiting for next batch
告警规则
为资源用量和服务状态设置持续触发条件。
| 规则 | 条件 | 持续时间 | 状态 |
|---|---|---|---|
| 内存使用率 | > 80% | 5 min | 已启用 |
| CPU 使用率 | > 85% | 5 min | 已启用 |
| 服务不可用 | 就绪副本 = 0 | 1 min | 已启用 |
通知渠道
查看通知配置与最近发送结果。
| 渠道 | 配置 | 最近通知 | 状态 |
|---|---|---|---|
| 运维群 | 飞书 · App Secret 已配置 | worker 内存告警 | 已发送 |
基础设施
查看各区域的节点、网络与存储资源。
| 区域 | 节点 | 入口 | 存储 |
|---|---|---|---|
| cn | cn-edge | HTTPS | 本地卷 |
| global | global-edge | HTTPS | 本地卷 |
| home | home-worker | 私网中继 | 本地卷 |
节点
节点角色、资源用量与最近心跳。
| 节点 | 区域 | 角色 | CPU | 状态 |
|---|---|---|---|---|
| cn-edge | cn | Manager · Edge | 24% | 就绪 |
| global-edge | global | Worker · Edge | 42% | 就绪 |
| home-worker | home | Worker | 18% | 就绪 |
加入节点
安装节点组件，连接控制面并等待首次心跳。
- 1选择区域
- 2安装组件
- 3等待心跳
目标区域 global节点角色 Worker
区域
区域决定部署位置，并关联对应的就绪节点。
| 区域 | 节点数 | 运行应用 | 访问方式 |
|---|---|---|---|
| cn | 1 | worker | 内部访问 |
| global | 1 | website · api | 公网 HTTPS |
| home | 1 | storage | 私网中继 |
系统维护
跟踪控制面升级、节点更新与路由检查。
| 检查项 | 结果 | 详情 |
|---|---|---|
| 公共路由 | 通过 | 2 / 2 路由正常 |
| 控制面 | 就绪 | 健康检查通过 |
| 节点版本 | 一致 | 3 / 3 已同步 |
存储
持久化卷固定在数据所属节点，更新时保留归属。
| 卷 | 应用 | 节点 | 挂载路径 |
|---|---|---|---|
| storage-data | storage | home-worker | /srv/luma/data/storage/data |
| worker-data | worker | cn-edge | /srv/luma/data/worker/data |
镜像
查看应用镜像与构建后的版本标识。
| 应用 | 镜像 | 来源 |
|---|---|---|
| website | registry.example.com/website:8d2a4f1 | Git 构建 |
| api | registry.example.com/api:3b7c912 | Git 构建 |
| worker | registry.example.com/worker:stable | 容器镜像 |
首次安装
从基础配置开始，检查部署所需依赖。
| 配置项 | 示例值 | 状态 |
|---|---|---|
| 集群域名 | example.com | 已配置 |
| DNS | Cloudflare | 已连接 |
| 证书 | ACME | 已配置 |
| 私网连接 | Tailscale | 已连接 |
设置
集中管理部署使用的凭据与平台配置。
| 配置 | 数量 | 用途 |
|---|---|---|
| 密钥 | 3 | 环境变量引用 |
| 镜像仓库凭据 | 1 | 拉取私有镜像 |
| Git 账户 | 1 | 代码仓库与构建 |
密钥
只展示名称和使用情况，敏感值不回显。
| 名称 | 引用方式 | 使用应用 |
|---|---|---|
| DATABASE_PASSWORD | ${DATABASE_PASSWORD} | api |
| SESSION_SECRET | ${SESSION_SECRET} | website |
| WORKER_TOKEN | ${WORKER_TOKEN} | worker |
镜像仓库凭据
为私有镜像仓库保存独立的拉取凭据。
| 仓库 | 用户名 | 凭据 | 用途 |
|---|---|---|---|
| registry.example.com | deploy-bot | 已配置 | 拉取应用镜像 |
Git 账户
连接代码来源，在交付流程中选择仓库和分支。
| 提供方 | 账户 | 仓库 | 连接状态 |
|---|---|---|---|
| GitHub | example-team | website · api | 已连接 |
| Gitea | example-team | worker | 已连接 |
存储配置
查看本地存储约定与数据归属策略。
| 配置项 | 当前策略 |
|---|---|
| 默认后端 | 本地存储 |
| 数据目录 | /srv/luma/data/<application>/<volume> |
| 调度策略 | 固定到数据归属节点 |
| 删除应用 | 默认保留数据 |
维护配置
维护操作从基础设施中的系统维护统一进入。
控制面与节点维护
检查路由基线，再跟踪镜像准备和版本更新。
从第一次部署，到每一天的维护。控制台指南
从代码到服务，
每一步都看得见。
看清完整访问路径
将 DNS、HTTPS 入口和私网中继，与它们服务的应用关联起来。
随时掌握运行状态
检查实例、资源历史与日志，在同一控制台管理告警规则和通知渠道。
让 AI 助手理解你的部署方式。
将 Luma 的配置规则、部署流程与排障知识带入 AI 编码助手。
部署与配置
luma-deployment-yaml生成与校验 YAML、审查 Compose 配置，沿用应用已有的构建部署方式。
检查这个 Compose 项目，生成 Luma 旁车配置并校验。查看 Skill →
应用可观测
luma-observe部署和维护独立可观测栈，检查应用指标、实例失败告警与通知结果。
为这个集群部署 luma-observe，验证告警和通知结果。查看 Skill →
Luma Control
配置、凭据与部署协调
CONTROLNomad
调度与工作负载生命周期
COMPUTETraefik + Cloudflare
HTTP/HTTPS 路由与 DNS 记录
INGRESSTailscale
私网节点连接与家庭节点中继
按需启用把第一次部署，
分成清晰的几步。
准备 Linux 管理节点、域名和 Cloudflare DNS Token，再根据网络拓扑接入私网。
环境要求与完整安装指南 Ubuntu 22.04+ Docker / Nomad Cloudflare DNS
安装 CLI
先在管理节点运行。安装器会创建独立的 Python 环境。
curl -fsSL https://raw.githubusercontent.com/LiuTianjie/luma/main/scripts/install-luma.sh | sh
~/.local/bin/luma doctor --local初始化管理节点
先按安装指南配置 DNS 凭据，再初始化控制平面。
luma bootstrap --domain luma.example.com登录并部署应用
在可信客户端使用管理 Token 登录，通过清单或控制台部署。
luma login https://luma.example.com --token <management-token>
luma deploy service.yaml每一步，都有据可循。
让分散的服务器，成为一个系统。
从一个管理节点开始，按需扩展你的集群。