快速安装 | 裕普智汇

安装方式概览

裕普智汇提供多种安装方式，适应不同的使用场景。您可以根据需求选择 CLI 命令行工具、SDK 开发包或 Docker 容器部署。

CLI 工具

适合运维人员快速上手，批量操作设备

预计 5 分钟

SDK 开发包

适合开发人员集成到现有系统

预计 10 分钟

Docker 部署

适合企业私有化部署，一键启动完整服务

预计 15 分钟

CLI 工具安装

Linux/macOS 安装

# 使用 curl 安装
curl -fsSL https://get.yupu.cn/cli/install.sh | sh

# 或下载二进制文件
curl -LO https:// releases.yupu.cn/cli/yupu-cli-latest-linux-amd64.tar.gz
tar -xzf yupu-cli-latest-linux-amd64.tar.gz
sudo mv yupu-cli /usr/local/bin/

Windows 安装

# 使用 PowerShell 安装
iwr https://get.yupu.cn/cli/install.ps1 -useb | iex

# 或下载 msi 安装包
# 下载地址: https://releases.yupu.cn/cli/yupu-cli-latest-windows.msi

验证安装

yupu-cli version
# 输出: yupu-cli version 1.0.0

SDK 安装

Python SDK

安装命令：

pip install yupu-sdk

验证安装：

from yupu import YupuClient
client = YupuClient(api_key='your_key')
print(client.version())

Node.js SDK

安装命令：

npm install @yupu/sdk

验证安装：

import { YupuClient } from '@yupu/sdk';
const client = new YupuClient({ apiKey: 'your_key' });
console.log(await client.version());

Docker 部署

前提条件

Docker 20.10 或更高版本
Docker Compose v2.0 或更高版本
4核 CPU / 8GB 内存 / 50GB 存储

下载部署包

# 下载 docker-compose.yml
curl -LO https://releases.yupu.cn/deploy/docker-compose.yml

# 如需自定义配置
curl -LO https://releases.yupu.cn/deploy/.env.example
cp .env.example .env
# 编辑 .env 文件，填入您的配置

启动服务

# 拉取镜像并启动
docker compose up -d

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f

访问控制台

访问地址：http://localhost:3000

默认管理员账号: admin@yupu.cn / admin123

配置 API 密钥

安装完成后，需要配置 API 密钥才能正常使用服务。

获取 API 密钥

登录裕普智汇控制台，进入"账户设置"-"API密钥"，创建新的密钥。

配置密钥

# CLI 配置
yupu-cli config set api-key your_api_key_here

# 环境变量方式
export YUPU_API_KEY=your_api_key_here

验证配置

yupu-cli account info
# 应显示您的账户信息

常见问题

安装失败怎么办？

请检查网络连接，确保可以访问裕普智汇下载服务器。如使用代理，请配置代理环境变量。

Docker 部署内存不足？

确保系统有至少 8GB 可用内存。可使用 docker system prune 清理未使用的资源。

如何升级到新版本？

CLI: 运行 yupu-cli update；SDK: pip install --upgrade yupu-sdk；Docker: docker compose pull && docker compose up -d

可以在离线环境安装吗？

可以，联系销售获取完整的离线安装包。