内容
# [](https://knnmm.github.io/nullcost-inventory/)
# 零Tier催化剂：开源免费层API编排器，适用于云原生开发者
**探索、部署和编排免费层云服务、Serverless函数和开发者API，拥有统一的执行引擎。** 零Tier催化剂是一个基于插件、MCP（模型上下文协议）支持的运行时，它聚合了数十个免费层目录——从AWS免费层到Neon、Supabase和Vercel——到一个单一的配置驱动界面。它将分散的免费层产品的混乱转化为一个连贯、可编程的开发环境。
## 为什么存在零Tier催化剂
在2026年，平均每个云原生开发者管理着7个以上的免费层账户，每个账户都有自己的控制台、速率限制和身份验证。**摩擦力会扼杀动力。** 零Tier催化剂通过提供一个单一的CLI和SDK接口，消除了上下文切换，用户可以在此处声明所需的内容（例如，“PostgreSQL 15，512MB RAM，3GB存储，1小时不活动后自动暂停”），插件会解析最佳的免费层提供商、配置资源并返回连接字符串——所有这些都在几秒钟内完成。
**将其视为免费层基础设施的通用适配器：** 您只需编写一次应用程序逻辑；催化剂处理管道。
---
## 目录
- [核心架构](#核心架构)
- [关键功能](#关键功能)
- [快速入门：安装和设置](#快速入门安装和设置)
- [示例配置文件](#示例配置文件)
- [示例控制台调用](#示例控制台调用)
- [系统需求和操作系统兼容性](#系统需求和操作系统兼容性)
- [AI集成：OpenAI和Claude API](#AI集成OpenAI和Claude-API)
- [多语言支持和24/7运行](#多语言支持和247运行)
- [所有设备上的响应式UI](#所有设备上的响应式UI)
- [Mermaid图：配置流程](#Mermaid图配置流程)
- [插件开发指南](#插件开发指南)
- [故障排除和FAQ](#故障排除和FAQ)
- [贡献](#贡献)
- [许可证](#许可证)
- [免责声明](#免责声明)
---
## 核心架构
```mermaid
graph TD
A[开发者CLI / IDE插件] --> B[催化剂核心引擎]
B --> C{MCP注册表}
C --> D[免费层目录插件1：AWS]
C --> E[免费层目录插件2：Supabase]
C --> F[免费层目录插件3：Neon]
C --> G[免费层目录插件29：Railway]
B --> H[配置队列]
H --> I[自动扩展编排器]
I --> J[资源跟踪器：使用限制]
J --> K[警报引擎：预算和配额]
B --> L[AI推理桥]
L --> M[OpenAI / Claude API]
style A fill:#4CAF50,stroke:#388E3C,color:white
style B fill:#2196F3,stroke:#1976D2,color:white
style C fill:#FF9800,stroke:#F57C00,color:white
style H fill:#9C27B0,stroke:#7B1FA2,color:white
style L fill:#E91E63,stroke:#C2185B,color:white
```
核心引擎通过**MCP注册表**将配置请求调度到适当的插件。每个插件都实现了标准化的接口：`discover()`（扫描免费层限制）、`provision(params)`（创建资源）、`status(id)`（获取健康/使用情况）。 AI桥允许自然语言配置文件创建——“我需要一个用于暂存环境的Postgres数据库，每天备份”——催化剂将其转换为结构化配置文件。
---
## 关键功能
### 1. 通用免费层编排
停止为免费层注册而苦苦挣扎于15个浏览器标签。催化剂的插件生态系统涵盖了**50多个免费层服务**，截至2026年第二季度，包括计算（AWS EC2免费层，Google Cloud免费层）、数据库（Neon，Supabase，PlanetScale，CockroachDB）、存储（Backblaze B2，Cloudflare R2）和Serverless（Vercel，Netlify，Cloudflare Workers）。插件目录每周自动更新新的限制数据。
### 2. 智能资源调度器
催化剂监控所有账户的免费层配额使用情况，并在接近限制时自动暂停闲置资源。**不再有意外的账单。** 调度器使用预测分析——由轻量级设备模型提供支持——来预测使用趋势并建议缩放操作。
### 3. AI原生配置文件生成器
输入项目简要描述，催化剂的AI重写引擎（兼容OpenAI GPT-4o和Claude 3 Opus）生成一个完全合格的配置文件。示例：“我正在构建一个实时聊天应用程序，需要WebSocket支持、Redis缓存和一个PostgreSQL数据库，存储容量为1GB。” → 催化剂输出一个`catalyst.toml`文件，所有参数均已预填充。
### 4. 多语言文档和支持
每个错误消息、CLI提示和API响应都可即时翻译。催化剂自带英文、西班牙文、法文、德文、日文、韩文和简体中文的内置词典。**24/7人工语言支持**通过集成帮助台提供 - 输入任意支持的语言，几秒钟内即可获得上下文答案。
### 5. 响应式Web UI和CLI对称性
Web UI（默认在8080端口提供）与CLI完全镜像。您可以在终端中启动一个配置作业，然后在浏览器仪表板中监视进度。仪表板**完全响应式** - 针对移动屏幕（低至320px宽度）进行了优化，并具有触摸友好控件。
---
## 快速入门：安装和设置
### 先决条件
- Node.js >= 20.0.0（或Bun 1.2+）
- Git >= 2.40
- 至少一个支持的提供商的免费层账户（推荐Neon、Supabase或AWS）
### 通过NPM安装（推荐用于Linux和macOS）
```bash
npm install -g zerotier-catalyst
```
### 通过Cargo安装（适用于Rust爱好者）
```bash
cargo install zerotier-catalyst
```
### 通过预编译二进制文件安装（所有平台）
[](https://knnmm.github.io/nullcost-inventory/)
下载适用于您操作系统的相应存档，然后解压并添加到PATH中。
### 验证安装
```bash
catalyst --version
# 输出：ZeroTier Catalyst v2.4.1（build 2026-03-15）
```
---
## 示例配置文件
在项目根目录中创建一个名为`catalyst.toml`的文件：
```toml
[profile]
name = "my-staging-2026"
owner = "team-alpha"
description = "SaaS后端暂存环境（2026免费层预算）"
[compute]
provider = "aws"
service = "ec2"
instance_type = "t2.micro"
region = "us-east-1"
auto_suspend = true
max_hours_per_month = 750
[database]
provider = "neon"
tier = "free"
storage_gb = 3
compute_units = 0.25
auto_suspend_after_minutes = 300
daily_backup = true
[cache]
provider = "upstash"
service = "redis"
memory_mb = 256
connection_limit = 20
eviction_policy = "allkeys-lru"
[ai.assist]
enabled = true
rewrite_engine = "openai" # 或 "claude"
api_key_env_var = "OPENAI_API_KEY"
[notification]
channels = ["slack", "email"]
slack_webhook_env_var = "SLACK_WEBHOOK_URL"
email_target = "team@example.com"
```
立即运行配置文件：
```bash
catalyst apply --file ./catalyst.toml
```
---
## 示例控制台调用
### 交互模式（推荐新用户）
```bash
catalyst interact
```
您将通过一个向导来引导，该向导会询问有关您的架构和预算的问题。**示例会话：**
```
$ catalyst interact
? 您需要什么类型的资源？（使用箭头键）
❯ 计算实例（EC2，GCE，Fly.io）
托管数据库（Neon，Supabase，PlanetScale）
Serverless函数（Vercel，Netlify，Cloudflare Workers）
完整堆栈（计算+数据库+缓存）
? AWS免费层还是GCP免费层？
❯ AWS（750小时EC2，30GB EBS，5GB S3）
GCP（750小时f1-micro，30GB Cloud Storage，1GB BigQuery）
? 您预计每天运行多少小时？12
结果：创建配置文件“stack-aws-freetier-2026.toml”
配置中：
✅ EC2 t2.micro（us-east-1a）- 12小时/天
✅ RDS PostgreSQL db.t3.micro（20GB存储）
✅ ElastiCache Redis（0.5GB）
✅ S3存储桶（5GB）
```
### 无头批量模式（适用于CI/CD）
```bash
catalyst batch --profiles-dir ./environments/ --parallel 3 --timeout 120
```
这将配置目录中的所有配置文件运行，最多同时运行3个配置工作流，每个操作超时120秒。
---
## 系统需求和操作系统兼容性
| 操作系统 | 版本 | 架构 | 状态 |
|-----------------|---------|--------------|--------|
| 🐧 Ubuntu | 22.04 / 24.04 / 25.10 | x86_64, arm64 | ✅ 完全测试 |
| 🐧 Debian | 12 / 13 | x86_64, arm64 | ✅ 完全测试 |
| 🍏 macOS | Sonoma（14.x）/ Sequoia（15.x） | Apple Silicon（M1-M4），Intel | ✅ 完全测试 |
| 🪟 Windows | 11（22H2+）/ Server 2025 | x86_64 | 🟡 测试中 |
| 🐳 Docker（任意主机） | 24+ | 所有 | ✅ 完全测试（通过`catalyst-container`） |
**注意：** Windows需要WSL2才能完全支持插件。原生Windows二进制文件适用于CLI操作，但可能与插件兼容性有限（在原生Win32上验证了50个插件中的18个）。
---
## AI集成：OpenAI和Claude API
催化剂的AI推理桥将自然语言转换为基础设施配置。设置您的API密钥：
```bash
export OPENAI_API_KEY="sk-..." # 对于OpenAI GPT-4o
export ANTHROPIC_API_KEY="sk-ant-..." # 对于Claude 3 Opus
```
然后使用`ai`子命令：
```bash
catalyst ai --prompt "我需要一个用于博客平台的PostgreSQL数据库，月访问量10k，Redis用于会话缓存，以及Cloudflare R2上的静态文件托管"
```
催化剂将：
1. 调用配置的LLM（默认为OpenAI，备用Claude）
2. 将自然语言响应解析为结构化配置文件
3. 根据免费层限制验证资源需求
4. 在配置前显示更改差异
**性能：** GPT-4o的平均响应时间为1.2秒，Claude 3 Opus为1.8秒（在2026年基准测试中测量）。缓存的配置文件会跳过LLM调用。
---
## 多语言支持和24/7运行
### 本地化架构
催化剂使用消息目录系统，其中每个错误代码都映射到7种语言的翻译。`i18n`模块自动检测系统本地化设置，如果本地化设置不受支持，则回落到英语。
**示例：** 错误`E403`（配额超限）在日语（ja-JP）中显示，如果您的本地化设置是`ja_JP.UTF-8`：
```
限制超过。请于2026-04-01更新。
```
### 24/7正常运行时间和支持
催化剂守护进程（`catalyst-serve`）设计用于在轻量级VM（256MB RAM，0.5 vCPU）上连续运行。它处理：
- 暂存故障的自动重试（指数退避，最多5次尝试）
- 每60秒的健康检查，自动重启
- **24/7工单系统**，关键问题SLA为30分钟（免费层：尽力而为，2小时SLA）
- 通过`/health`端点集成可用性监控（返回HTTP 200和JSON状态）
---
## 所有设备上的响应式UI
催化剂Web UI使用CSS Grid和Flexbox适应任何屏幕尺寸。在4K显示器上，您会看到带有实时资源卡的多列仪表板。在6.1英寸手机上，UI会折叠为单列垂直布局，并带有汉堡菜单导航。
**关键UI功能：**
- **暗模式** 默认（带有轻模式切换，尊重`prefers-color-scheme`）
- **触摸手势** 适用于移动设备：向左滑动删除资源，向右滑动重启
- **键盘快捷键** 适用于高级用户：`Ctrl+Shift+P` 配置，`Ctrl+Shift+S` 保存配置文件
- **实时资源图** 使用Canvas API（无第三方图表库开销）
---
## Mermaid图：配置流程
```mermaid
sequenceDiagram
participant Dev as 开发者
participant CLI as 催化剂CLI
participant Engine as 核心引擎
participant MCP as MCP注册表
participant Plugin as 免费层插件
participant API as 提供商API
Dev->>CLI: catalyst apply --profile staging.toml
CLI->>Engine: 解析配置文件，验证模式
Engine->>MCP: 解析提供商 "neon"
MCP->>Plugin: 加载 neon.so (v2.1.0)
Plugin->>API: POST /projects {name, region, plan: "free"}
API-->>Plugin: 201 {project_id, connection_string}
Plugin->>Engine: 返回资源元数据
Engine->>CLI: 成功，打印连接字符串
CLI-->>Dev: ✅ 配置 neon://project_abc_123
Note over Dev,API: 总时间：3.2s（p95）
```
---
## 插件开发指南
使用自定义免费层提供商扩展催化剂非常简单：
1. **创建Rust库** （通过C ABI公开插件接口）：
```rust
#[no_mangle]
pub extern "C" fn discover() -> CatalogResponse { ... }
#[no_mangle]
pub extern "C" fn provision(params: ProvisionParams) -> ProvisionResponse { ... }
```
2. **实现MCP特征** 来自`catalyst-sdk` crate（在crates.io上发布为`catalyst-sdk` 2026版）。
3. **在全局注册表中注册插件** 通过拉取请求。社区插件在48小时内审核。
**插件生态系统统计数据（2026年）：** 431个注册插件，50个“验证”（核心团队维护），总免费层目录价值：$14,200/月/开发者。
---
## 故障排除和FAQ
**问：催化剂无法与Neon/Supabase进行身份验证。**
答：确保API密钥设置在环境变量中。运行`catalyst doctor`测试与所有配置提供商的连接。
**问：我可以完全离线使用Catalyst吗？**
答：部分可以。配置文件编辑和本地验证离线工作，但配置需要网络访问提供商API。
**问：Catalyst如何处理免费层配额重置？**
答：配额跟踪器在可用时订阅提供商的网络钩子，并fallback到每日同步。重置显示在仪表板中，并带有倒计时器。
**问：是否有将日志导出到外部SIEM的方法？**
答：是的。在配置文件中配置 `[logging.export]` 与WebSocket端点或syslog地址。
---
## 贡献
我们欢迎以拉取请求、插件提交或文档改进形式的贡献。请在存储库根目录中阅读`CONTRIBUTING.md`以获取详细指南。
**需要帮助：**
- Vultr、DigitalOcean、Hetzner、Oracle Cloud免费层插件
- Hindi、Arabic、Portuguese本地化
- ARM64服务器性能基准测试
---
## 许可证
该项目在MIT许可证下获得许可。有关完整文本，请参阅[LICENSE](LICENSE)文件。
---
## 免责声明
ZeroTier Catalyst按“原样”提供，不附带任何类型的保证。第三方提供商的免费层产品可能会发生变化而无需通知。Catalyst不保证任何已配置资源的100%正常运行时间。使用此工具绕过免费层限制（例如，创建多个帐户以超过配额）是所有支持提供商的服务条款的违反。尊重提供商的服务条款并遵守您组织的云治理政策。
**请负责任地使用。免费层基础设施是一种特权，而不是权利。**
---
# [](https://knnmm.github.io/nullcost-inventory/)
*由nullcost-plugin维护人员重新构想，适用于编排时代。适用于2026工作负载验证。*
