跳转到内容
Greentic Docs

安装

系统要求

Section titled “系统要求”

最低要求

Section titled “最低要求”
组件要求
OSLinux、macOS、Windows
Rust1.90+
Memory4 GB RAM
Disk2 GB 可用空间

推荐配置

Section titled “推荐配置”
组件要求
Rust1.91（最新）
Memory8 GB RAM
CPU多核处理器

安装 Rust

Section titled “安装 Rust”

如果你还没有安装 Rust：

Terminal window
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

设置正确的 toolchain 版本：

Terminal window
rustup default 1.90

添加用于构建 components 的 WASM target：

Terminal window
rustup target add wasm32-wasip2

安装 GTC CLI

Section titled “安装 GTC CLI”
Terminal window
cargo install greentic-cli

验证安装

Section titled “验证安装”
Terminal window
gtc --version

预期输出：

gtc 0.4.x

可选依赖

Section titled “可选依赖”

NATS（消息总线）

Section titled “NATS（消息总线）”

用于生产部署：

Terminal window
docker run -d --name nats -p 4222:4222 nats:latest

Redis（Session 存储）

Section titled “Redis（Session 存储）”

用于生产环境中的 session 持久化：

Terminal window
docker run -d --name redis -p 6379:6379 redis:alpine

Ngrok/Cloudflared（公共 URL）

Section titled “Ngrok/Cloudflared（公共 URL）”

用于基于 webhook 的 providers（Telegram、Slack 等）：

Terminal window
# Install
brew install ngrok/ngrok/ngrok  # macOS
# or download from https://ngrok.com/download


# Configure
ngrok config add-authtoken YOUR_TOKEN


# Run
ngrok http 8080

开发工具

Section titled “开发工具”

Pack Builder

Section titled “Pack Builder”

构建 .gtpack 归档：

Terminal window
cargo install greentic-pack

Flow Validator

Section titled “Flow Validator”

校验 flow 定义：

Terminal window
cargo install greentic-flow

Component Authoring

Section titled “Component Authoring”

创建 WASM components：

Terminal window
cargo install greentic-component

验证你的环境

Section titled “验证你的环境”

运行以下命令以确认一切正常：

Terminal window
# Check GTC CLI
gtc --help


# Check Rust WASM target
rustup target list --installed | grep wasm32-wasip2


# Create and run a test bundle
gtc wizard --dry-run

故障排查

Section titled “故障排查”

常见问题

Section titled “常见问题”

错误：“wasm32-wasip2 target not found”

Terminal window
rustup target add wasm32-wasip2

错误：“Cannot connect to NATS”

Terminal window
# Start embedded NATS with gtc start
gtc start ./my-bundle --nats on

错误：“Permission denied”

Terminal window
# On Linux/macOS, ensure binary is executable
chmod +x /usr/local/bin/gtc

下一步

Section titled “下一步”