安装指南
系统要求
最低要求
- macOS: 10.14 (Mojave) 或更高版本
- Windows: Windows 10 或更高版本
- Linux: Ubuntu 18.04 或更高版本
- 内存: 4GB RAM
- 存储: 1GB 可用空间
推荐配置
- 内存: 8GB RAM 或更多
- 存储: 2GB 可用空间
- 网络: 稳定的网络连接
下载安装
方法一：预编译版本（推荐）
访问 GitHub Releases
https://github.com/shzjj82/terminal-electron/releases选择对应平台
- macOS: 下载
.dmg文件 - Windows: 下载
.exe安装程序 - Linux: 下载
.AppImage或.deb文件
- macOS: 下载
安装应用
- macOS: 双击
.dmg文件，拖拽到 Applications 文件夹 - Windows: 运行
.exe安装程序，按提示完成安装 - Linux: 双击
.AppImage文件或使用包管理器安装.deb文件
- macOS: 双击
方法二：从源码构建
克隆仓库
bashgit clone https://github.com/shzjj82/terminal-electron.git cd terminal-electron安装依赖
bashyarn install构建应用
bash# 开发模式 yarn dev # 生产构建 yarn build:electron:mac:arm64 # macOS ARM64 yarn build:electron:win:x64 # Windows x64 yarn build:electron:linux:x64 # Linux x64
验证安装
启动应用
- 从应用程序文件夹或开始菜单启动
- 或在命令行中运行应用
检查版本
- 在应用菜单中查看 "关于" 信息
- 确认版本号和构建信息
测试功能
- 尝试添加一个测试服务器
- 验证基本功能是否正常
首次配置
1. 创建用户账户
- 首次启动时，系统会提示创建账户
- 输入用户名、邮箱和密码
- 选择数据存储模式（个人或团队）
2. 配置默认设置
- 终端主题: 选择喜欢的终端颜色主题
- 字体设置: 调整终端字体大小和类型
- 快捷键: 自定义常用快捷键
3. 添加第一个服务器
- 点击 "添加服务器" 按钮
- 填写服务器信息：
- 名称：给服务器起一个易记的名字
- 主机：服务器的 IP 地址或域名
- 端口：SSH 端口（默认 22）
- 用户名：SSH 用户名
- 选择认证方式：
- 密码认证
- 密钥认证
故障排除
常见问题
1. 应用无法启动
症状: 双击应用图标无反应 解决方案:
- 检查系统要求是否满足
- 尝试从命令行启动查看错误信息
- 重新下载并安装应用
2. 权限问题
症状: 提示权限不足 解决方案:
- macOS: 在系统偏好设置中允许应用运行
- Windows: 以管理员身份运行
- Linux: 确保文件有执行权限
3. 网络连接问题
症状: 无法连接到服务器 解决方案:
- 检查网络连接
- 验证服务器地址和端口
- 确认防火墙设置
4. 密钥认证失败
症状: 使用密钥无法登录 解决方案:
- 检查密钥文件格式是否正确
- 确认密钥已添加到服务器
- 验证密钥密码（如果有）
获取帮助
如果遇到其他问题，可以通过以下方式获取帮助：
查看日志
- 应用会在用户目录下生成日志文件
- 查看日志获取详细错误信息
提交 Issue
- 在 GitHub 上提交 Issue
- 提供详细的错误描述和系统信息
社区支持
- 加入用户讨论群
- 查看常见问题解答
更新应用
自动更新
- 应用会定期检查更新
- 有新版本时会提示用户更新
- 点击更新按钮自动下载并安装
手动更新
- 下载最新版本
- 关闭当前应用
- 安装新版本
- 重启应用
卸载应用
macOS
- 打开 Applications 文件夹
- 找到 Terminal Electron 应用
- 拖拽到垃圾桶或右键选择 "移到垃圾桶"
Windows
- 打开控制面板
- 选择 "程序和功能"
- 找到 Terminal Electron
- 点击 "卸载"
Linux
bash
# 如果是 AppImage
rm ~/.local/share/applications/terminal-electron.desktop
# 如果是 deb 包
sudo apt remove terminal-electron