跳转到内容
greentic.ai Greentic Docs

安装

系统要求

Section titled “系统要求”

最低要求

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

推荐配置

Section titled “推荐配置”
组件要求
Rust1.95+（最新支持版本）
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.95

添加用于构建 components 的 WASM target：

Terminal window
rustup target add wasm32-wasip2

安装 GTC CLI

Section titled “安装 GTC CLI”

先安装 gtc router，然后让 gtc install 安装 Greentic companion tools。正常使用时不要直接安装 greentic-cli 或单独的 companion crates；gtc install 会让 delegated binaries 与 router 保持一致。

Terminal window
cargo install cargo-binstall
cargo binstall gtc
gtc install
gtc doctor

验证安装

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

可选依赖

Section titled “可选依赖”

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 “开发工具”

Greentic Toolchain

Section titled “Greentic Toolchain”

安装或更新 gtc router 使用的 delegated Greentic binaries：

Terminal window
gtc install

使用 gtc install --dry-run 预览安装计划。对于受控环境，可以固定 toolchain：

Terminal window
gtc install --release 1.0.15
gtc install --manifest ./greentic-toolchain.json

Component Authoring

Section titled “Component Authoring”

gtc install 会安装标准 companion tools。对于独立 component development，也可以安装 cargo-component：

Terminal window
cargo binstall cargo-component

然后使用 delegated component surface：

Terminal window
gtc dev component --help

验证你的环境

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

错误：“Permission denied”

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

下一步

Section titled “下一步”