# SSH Manager Windows 成品版使用说明

更新时间：2026-04-16

## 适用对象

适合不想自己部署环境、希望下载安装后直接使用的买家。

## 安装步骤

1. 双击 `SSHManager-Setup-*.exe`
2. 按提示完成安装
3. 可选择创建桌面快捷方式
4. 安装完成后点击“立即启动 SSH Manager”

## 首次启动会发生什么

首次启动时，程序会自动：

- 初始化本地运行目录
- 生成本地密钥
- 启动内置服务
- 自动打开浏览器到 `http://127.0.0.1:48080`

如果浏览器没有自动打开，也可以手动访问：

- `http://127.0.0.1:48080`

## 默认账号

- 用户名：`admin`
- 密码：`admin123`

首次登录后建议立刻修改密码。

## 数据保存位置

程序不会把你的连接数据放到安装目录，默认保存在当前 Windows 用户目录下：

- 数据目录：`%LOCALAPPDATA%\SSHManager\data`
- 运行时配置：`%LOCALAPPDATA%\SSHManager\runtime`
- 日志目录：`%LOCALAPPDATA%\SSHManager\logs`

这意味着：

- 升级安装一般不会丢数据
- 卸载程序默认也不会删除你的数据目录

## 常见操作

### 启动程序

- 双击桌面快捷方式 `SSH Manager`
- 或从开始菜单打开 `SSH Manager`

### 停止程序

- 从开始菜单执行 `停止 SSH Manager`
- 或运行安装目录下的 `stop-installed.cmd`

### 看说明

安装目录会自带两份说明文本：

- `BUYER-GUIDE.txt`
- `AFTER-SALES-FAQ.txt`

如果遇到启动失败、浏览器没弹出、端口冲突、换机迁移等问题，优先先看 `AFTER-SALES-FAQ.txt`。

### 看日志

如果程序启动失败，请查看：

- `%LOCALAPPDATA%\SSHManager\logs\backend.log`

## 常见问题

### 1. 为什么打开的是浏览器，不是传统桌面窗口？

这是本地安装版，不依赖外网，程序核心运行在你自己的电脑上。浏览器只是显示界面，数据仍然保存在本机。

### 2. 关闭浏览器后，程序还在吗？

如果本地服务仍在运行，再次点击快捷方式会直接重新打开页面，不会重复启动多个实例。

### 3. 升级新版本会清空连接吗？

正常覆盖安装不会清空数据，因为数据默认保存在 `%LOCALAPPDATA%\SSHManager\data`。

### 4. 卸载后数据会一起删除吗？

默认不会自动删除数据目录，避免误删。

## 售后排查建议

联系卖家时建议同时提供：

- 当前软件版本
- 复现步骤
- `%LOCALAPPDATA%\SSHManager\logs\backend.log`
- 页面中的“关于与交付信息”诊断摘要