# ZenSSHPro

**Repository Path**: web/zen-sshpro

## Basic Information

- **Project Name**: ZenSSHPro
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZenSSHPro

## 项目简介

ZenSSHPro 是一个功能强大的 SSH 终端工具，基于 [ZenSSH](https://github.com/kisChang/ZenSSH) 项目修改而来，提供了丰富的远程连接和文件管理功能。

## 主要功能

- **SSH 终端**：提供完整的终端功能，支持多种终端主题
- **SFTP 文件浏览器**：直观的文件浏览和管理界面
- **文件编辑器**：内置代码编辑器，支持语法高亮
- **端口转发**：支持本地和远程端口转发
- **常用命令**：支持自定义常用命令，支持分组管理
- **多语言支持**：内置中文和英文界面
- **主题切换**：支持深色和浅色主题
- **云端同步**：支持 Gitee、GitHub 和 WebDAV 同步配置（包括常用命令）
- **端到端加密**：保护您的连接配置安全
- **跨平台支持**：支持 Windows、macOS、Linux 和 Android

## 技术栈

- **前端**：Vue 3, Element Plus, xterm.js
- **后端**：Rust (Tauri)
- **状态管理**：Pinia
- **国际化**：vue-i18n

## 开发环境搭建

### 前置要求

- **通用要求**
  - Node.js 16+
  - Rust 1.75+
  - Tauri CLI

- **移动端开发额外要求**
  - JDK 17+
  - Android SDK
  - Android NDK
  - 配置 ANDROID_HOME 环境变量

### 安装依赖

```bash
npm install
```

### 开发模式运行

#### 网页开发模式

```bash
npm run dev
```

#### 桌面应用开发模式

```bash
npm run tauri_dev
```

#### 移动端开发模式

```bash
npm run and_dev
```

## 构建方法

### 构建网页版本

```bash
npm run build
```

### 构建桌面应用

```bash
npm run tauri build
```

### 构建移动应用（Android）

#### 前置要求

- Android 开发环境
  - JDK 17+
  - Android SDK
  - Android NDK
  - 配置 ANDROID_HOME 环境变量

#### 构建步骤

1. 确保已安装所有依赖

```bash
npm install
```

2. 构建 Android 应用

```bash
npm run tauri android build
```

3. 构建完成后，APK 文件将生成在以下目录：

```
src-tauri/target/aarch64-linux-android/release/bundle/apk/
```

#### 开发模式运行

```bash
npm run and_dev
```

## 配置说明

### 首次使用

首次启动应用时，需要设置端到端加密密钥，用于保护您的连接配置。请务必妥善保管此密钥，丢失后无法恢复数据。

### 云端同步

应用支持将配置同步到 Gitee、GitHub 或 WebDAV，您可以在设置中配置相应的同步服务。

## 项目结构

```
zen-sshpro/
├── public/            # 静态资源
├── src/               # 前端源代码
│   ├── locales/       # 国际化文件
│   ├── mobile/        # 移动端组件
│   ├── services/      # 服务层
│   ├── subs/          # 子组件
│   ├── utils/         # 工具函数
│   ├── views/         # 页面组件
│   ├── App.vue        # 主应用组件
│   ├── IndexMobile.vue # 移动端入口
│   ├── main.js        # 应用入口
│   └── store.js       # 状态管理
├── src-tauri/         # Tauri 后端代码
├── package.json       # 项目配置
└── vite.config.js     # Vite 配置
```

## 注意事项

- 请确保您的网络环境可以正常访问远程服务器
- 首次使用时请设置强密码作为加密密钥
- 云端同步功能需要相应平台的访问令牌

## 许可证

本项目基于原项目的许可证进行修改，具体请参考 LICENSE.txt 文件。

## 项目地址

- Gitee: https://gitee.com/web/zen-sshpro
- 原项目: https://github.com/kisChang/ZenSSH