# wanzi_ssh

**Repository Path**: huikaibiao/wanzi_ssh

## Basic Information

- **Project Name**: wanzi_ssh
- **Description**: SSH Toolkit 是一款基于 Tauri 2.0 构建的现代化 SSH 隧道管理工具，专为 Apple Silicon (M系列芯片) 优化。它提供了简洁优雅的用户界面，让你轻松管理 SSH 端口转发，将远程服务器的服务映射到本地端口。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-01-19
- **Last Updated**: 2026-02-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 丸子Shell

<p align="center">
  <img src="src-tauri/icons/128x128.png" alt="丸子Shell Logo" width="128" height="128">
</p>

<p align="center">
  <strong>一款专为 macOS 设计的 SSH/SFTP 管理工具</strong>
</p>

<p align="center">
  <a href="#功能特性">功能特性</a> •
  <a href="#截图预览">截图预览</a> •
  <a href="#安装">安装</a> •
  <a href="#使用说明">使用说明</a> •
  <a href="#技术栈">技术栈</a> •
  <a href="#许可证">许可证</a>
</p>

<p align="center">
  <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License">
  <img src="https://img.shields.io/badge/platform-macOS-lightgrey.svg" alt="Platform">
  <img src="https://img.shields.io/badge/version-1.0.0-green.svg" alt="Version">
</p>

---

## 简介

丸子Shell 是一款基于 Tauri 2.0 构建的现代化 SSH/SFTP 管理工具，专为 Apple Silicon (M系列芯片) 和 Intel 处理器优化。它提供了简洁优雅的用户界面，集成了终端、文件传输、端口转发等多种功能。

## 功能特性

### 🖥️ SSH 终端
- **多窗口终端** - 同时管理多个 SSH 会话，标签页切换
- **原生终端体验** - 基于 xterm.js，支持颜色、快捷键、滚动历史
- **右键菜单** - 复制、粘贴、全选、清屏等常用操作
- **自定义背景** - 支持设置背景图片，调节透明度

### 📁 SFTP 文件管理
- **多服务器文件浏览** - 同时连接多台服务器进行文件管理
- **文件上传/下载** - 支持单文件和批量操作
- **在线编辑** - 直接编辑远程文本文件
- **目录导航** - 快速跳转、刷新、创建目录

### 🔗 SSH 隧道
- **端口转发** - 支持本地端口转发 (-L)，映射远程服务到本地
- **心跳检测** - 实时监控隧道状态
- **自动重连** - 断线后自动恢复连接
- **局域网共享** - 一键开启，让其他设备也能访问

### 🎨 用户体验
- **深色/浅色主题** - 支持跟随系统自动切换
- **原生 macOS 体验** - 符合 Apple 设计规范
- **配置持久化** - 自动保存服务器配置和设置
- **快速连接** - 服务器列表快速选择连接

## 截图预览

### 服务器管理
<p align="center">
  <img src="docs/servers.png" alt="服务器管理" width="800">
</p>
<p align="center"><em>支持多台服务器管理，快速连接终端、文件、隧道</em></p>

### SSH 终端
<p align="center">
  <img src="docs/terminal.png" alt="SSH 终端" width="800">
</p>
<p align="center"><em>多标签页终端，支持彩色输出，底部状态栏显示连接信息</em></p>

### SFTP 文件管理
<p align="center">
  <img src="docs/sftp.png" alt="SFTP 文件管理" width="800">
</p>
<p align="center"><em>可视化文件浏览，支持上传、下载、编辑操作</em></p>

### SSH 隧道
<p align="center">
  <img src="docs/tunnel.png" alt="SSH 隧道" width="800">
</p>
<p align="center"><em>端口转发配置，实时显示 SSH 命令，支持自动重连</em></p>

### 个性化设置
<p align="center">
  <img src="docs/settings.png" alt="设置" width="800">
</p>
<p align="center"><em>主题切换、背景图片、终端字体等个性化配置</em></p>

## 安装

### 系统要求
- macOS 11.0 (Big Sur) 或更高版本
- Apple Silicon (M1/M2/M3/M4) 或 Intel 处理器

### 下载安装

从 [Releases](https://github.com/cxyhjl/wanzi-shell/releases) 页面下载最新版本：

- **DMG 安装包**: `丸子Shell_x.x.x_aarch64.dmg` (Apple Silicon)
- **App 应用**: `丸子Shell.app`

双击 DMG 文件，将应用拖入 Applications 文件夹即可。

## 使用说明

### 服务器管理

1. 点击「服务器」模块
2. 点击「+ 添加服务器」添加服务器配置
3. 填写服务器名称、地址、端口、用户名、密码
4. 保存后可快速连接终端、文件或隧道

### SSH 终端

1. 选择已配置的服务器
2. 点击「+」新建终端会话
3. 右键菜单可进行复制、粘贴等操作
4. 支持多标签页同时操作

### SFTP 文件传输

1. 选择服务器并连接
2. 浏览远程目录结构
3. 选择文件进行上传、下载或编辑
4. 支持多服务器同时管理

### SSH 隧道

1. 新建隧道配置
2. 设置本地端口和远程端口映射
3. 点击连接建立隧道
4. 开启局域网共享让其他设备访问

## 技术栈

- **框架**: [Tauri 2.0](https://tauri.app/) - Rust 驱动的轻量级桌面应用框架
- **前端**: [React 19](https://react.dev/) + [TypeScript](https://www.typescriptlang.org/)
- **构建**: [Vite](https://vite.dev/) (Rolldown)
- **样式**: [Tailwind CSS 4](https://tailwindcss.com/)
- **终端**: [xterm.js](https://xtermjs.org/)
- **图标**: [Lucide React](https://lucide.dev/)

## 开发

### 环境准备

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

# 安装 Node.js (推荐使用 nvm)
nvm install 20
nvm use 20
```

### 本地开发

```bash
# 克隆项目
git clone https://github.com/cxyhjl/wanzi-shell.git
cd wanzi-shell

# 安装依赖
npm install

# 启动开发服务器
npm run tauri dev
```

### 构建发布

```bash
npm run tauri build
```

## 许可证

[MIT License](LICENSE)

## 作者

**程序员HKUN**

---

<p align="center">
  Made with ❤️ for macOS
</p>