# ssh-tool

**Repository Path**: kiti_ly/ssh-tool

## Basic Information

- **Project Name**: ssh-tool
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasySSH - SSH配置管理工具

跨平台的SSH配置管理桌面应用，使用Tauri + React + TypeScript构建。

## 功能特性

- 🔑 **SSH Key管理**: 生成、查看、删除SSH密钥对
- 🖥️ **Host管理**: 图形化管理SSH主机配置
- 📝 **Config自动生成**: 自动生成标准的OpenSSH配置文件
- 🔍 **连接测试**: 测试SSH连接并提供错误诊断

## 技术栈

- **桌面框架**: Tauri 2.0
- **前端**: React 18 + TypeScript
- **后端**: Rust
- **构建工具**: Vite

## 开发环境要求

- Node.js 18+
- Rust (安装方法: https://rustup.rs/)
- 系统OpenSSH (ssh, ssh-keygen命令)

## 安装与运行

### 1. 安装 Rust

如果还没有安装 Rust，运行：

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

**重要**: 安装完成后，需要重新加载 shell 环境变量：

```bash
source "$HOME/.cargo/env"
```

或者重新打开终端窗口。

### 2. 安装依赖

```bash
npm install
```

### 3. 开发模式运行

确保 cargo 在 PATH 中，然后运行：

```bash
# 如果 cargo 不在 PATH 中，先运行：
export PATH="$HOME/.cargo/bin:$PATH"

# 然后运行开发服务器
npm run tauri dev
```

或者在一行中运行：

```bash
export PATH="$HOME/.cargo/bin:$PATH" && npm run tauri dev
```

### 4. 构建生产版本

```bash
export PATH="$HOME/.cargo/bin:$PATH" && npm run tauri build
```

## 项目结构

```
ssh_tool/
├── src/                    # React前端代码
│   ├── components/         # UI组件
│   ├── hooks/              # React Hooks
│   └── types/              # TypeScript类型定义
├── src-tauri/              # Tauri后端代码
│   ├── src/
│   │   ├── commands/       # Tauri命令（前后端交互）
│   │   └── utils/          # 工具函数
│   └── Cargo.toml
└── package.json
```

## 使用说明

### SSH Key管理

1. 点击"生成新Key"创建SSH密钥对
2. 选择算法（RSA或ED25519）
3. 对于RSA，可选择密钥长度（2048或4096）
4. 查看公钥并复制到远程服务器

### Host管理

1. 添加SSH主机配置
2. 填写HostName、User、Port等信息
3. 可选择绑定特定的SSH Key
4. 支持高级选项（IdentitiesOnly、StrictHostKeyChecking）

### Config生成

1. 在"Config预览"页面查看生成的配置
2. 点击"生成Config文件"将配置写入`~/.ssh/config`
3. 可选择在生成前备份现有配置文件

### 连接测试

1. 选择要测试的Host
2. 点击"测试连接"
3. 查看连接结果和错误诊断建议

## 故障排除

### Cargo 命令未找到

如果遇到 `cargo: command not found` 错误：

1. 确保 Rust 已正确安装
2. 运行 `source "$HOME/.cargo/env"` 加载环境变量
3. 或者重新打开终端窗口
4. 验证: `cargo --version` 应该显示版本号

### 开发服务器无法启动

确保：
- Node.js 已安装: `node --version`
- npm 已安装: `npm --version`
- Rust 和 cargo 在 PATH 中: `which cargo`

## 安全说明

- ✅ 所有私钥操作仅在本地完成
- ✅ 不上传、不收集、不分析私钥
- ✅ 完全基于系统OpenSSH，不依赖第三方SSH库
- ✅ 所有敏感操作只在本地完成

## 许可证

MIT