# 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-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZenSSHPro

## Project Introduction

ZenSSHPro is a powerful SSH terminal tool, modified from the [ZenSSH](https://github.com/kisChang/ZenSSH) project, providing rich remote connection and file management features.

## Version Updates

### v0.1.2 (2026-04-15)

- **AI Assistant**: Added AI assistance functionality, providing intelligent terminal command suggestions and operation guidance
- **Update Checker**: Added application update checker, automatically detects and prompts for new versions
- **Proxy Settings**: Improved proxy configuration functionality, providing more flexible network connection options
- **Mobile Optimization**: Enhanced mobile user experience, improved touch operation support
- **Stability Improvements**: Fixed known issues, improved overall application stability

### v0.1.1 (2026-03-25)

- **Security Verification**: Enhanced key verification mechanism at application startup to ensure only correct passwords can pass verification, improving application security
- **New Proxy Support**: Added SOCKS5 proxy configuration support, can select to use proxy in connection settings
- **Terminal Display Optimization**: Improved terminal display performance and stability
- **Android Compatibility**: Fixed compatibility issues on Android platform

### v0.1.0 (Initial Version)

- Basic features: SSH connection management, terminal operations, SFTP file management
- Cross-platform support: Windows, macOS, Linux, Android
- Cloud sync: Support for Gitee, GitHub, and WebDAV
- Theme switching: Light/dark themes
- Internationalization: Chinese and English interfaces

## Main Features

- **SSH Terminal**: Provides complete terminal functionality with support for multiple terminal themes
- **SFTP File Browser**: Intuitive file browsing and management interface
- **File Editor**: Built-in code editor with syntax highlighting
- **Port Forwarding**: Supports local and remote port forwarding
- **Common Commands**: Supports custom common commands with group management
- **Multi-language Support**: Built-in Chinese and English interfaces
- **Theme Switching**: Supports dark and light themes
- **Cloud Sync**: Supports Gitee, GitHub, and WebDAV for configuration synchronization (including common commands)
- **End-to-End Encryption**: Protects your connection configuration security
- **Cross-platform Support**: Supports Windows, macOS, Linux, and Android

## Technology Stack

- **Frontend**: Vue 3, Element Plus, xterm.js
- **Backend**: Rust (Tauri)
- **State Management**: Pinia
- **Internationalization**: vue-i18n

## Development Environment Setup

### Prerequisites

- Node.js 16+
- Rust 1.75+
- Tauri CLI

### Install Dependencies

```bash
npm install
```

### Run in Development Mode

#### Web Development Mode

```bash
npm run dev
```

#### Desktop App Development Mode

```bash
npm run tauri_dev
```

#### Mobile Development Mode

```bash
npm run and_dev
```

## Build Methods

### Build Web Version

```bash
npm run build
```

### Build Desktop App

```bash
npm run tauri build
```

## Configuration Instructions

### First Use

When you first start the application, you need to set an end-to-end encryption key to protect your connection configurations. Please keep this key safe, as data cannot be recovered if lost.

### Cloud Sync

The application supports synchronizing configurations to Gitee, GitHub, or WebDAV. You can configure the corresponding sync service in the settings.

## Project Structure

```
zen-sshpro/
├── public/            # Static resources
├── src/               # Frontend source code
│   ├── locales/       # Internationalization files
│   ├── mobile/        # Mobile components
│   ├── services/      # Service layer
│   ├── subs/          # Sub-components
│   ├── utils/         # Utility functions
│   ├── views/         # Page components
│   ├── App.vue        # Main application component
│   ├── IndexMobile.vue # Mobile entry
│   ├── main.js        # Application entry
│   └── store.js       # State management
├── src-tauri/         # Tauri backend code
├── package.json       # Project configuration
└── vite.config.js     # Vite configuration
```

## Notes

- Please ensure your network environment can normally access remote servers
- Please set a strong password as the encryption key when first using
- Cloud sync functionality requires access tokens for the corresponding platforms

## License

This project is modified based on the license of the original project. Please refer to the LICENSE.txt file for details.

## Project Address

- Gitee: https://gitee.com/web/zen-sshpro
- Original Project: https://github.com/kisChang/ZenSSH