JSON-RPC 应用示例

本文以运维中心应用为例，详细介绍如何构建和部署 JSON-RPC 应用。

快速开始

项目概述

本示例展示了一个完整的前后端分离架构，包含：

• 前端: Vue.js + TypeScript 构建的现代化 Web 界面
• 后端: Unix Domain Socket + JSON-RPC 协议的高性能服务
• 通信: 基于 JSON-RPC 2.0 标准的 API 接口

项目获取

项目地址: app-omc

# 克隆项目到本地
git clone https://github.com/GMSSH/app-omc.git

# 进入项目目录
cd app-omc

环境要求

• Node.js: >= 18.2.0（推荐使用 LTS 版本）
• 包管理器: pnpm >= 7.0.0（推荐）或 npm >= 8.0.0
• Python: >= 3.10（推荐 3.10.10）
• Poetry: Python 依赖管理工具

安装与配置

1. 安装 Poetry（如未安装）

# 或使用 pip
pip3 install poetry

2. 前端项目设置

# 进入前端目录
cd web

# 安装依赖
pnpm install

# 启动开发服务器（默认端口：3000）
pnpm run dev

# 构建生产版本
pnpm run build

# 预览生产构建
pnpm run preview

3. 后端项目设置

# 进入后端目录
cd backend

# 安装 Python 依赖
poetry install

# 激活虚拟环境
poetry shell

# 启动开发服务器
python main.py

运行效果

启动成功后，您将看到以下界面：

启动示例

重要提示

开发环境要求:

• 完整的前端展示效果需要在 GMSSH devtools 应用环境中打开
• 后端服务仅支持 macOS 和 Linux 系统
• 推荐在 Linux 环境下运行
• 可使用 GMSSH tools 应用进行调试和效果查看