---
title: 常见问题
description: 常见问题的解决方案
---

## 连接问题

### SSH 无法连接

**症状：** 超时、连接被拒绝、身份验证失败

**解决方案：**

1. **核对服务器类型：** 仅支持类 Unix 系统（Linux、macOS、Android/Termux）
2. **手动测试：** 在终端运行 `ssh user@server -p port`
3. **检查防火墙：** 确保 22 端口已开放
4. **核对凭据：** 确保用户名、密码或密钥正确

### 频繁掉线

**症状：** 终端在闲置一段时间后自动断开

**解决方案：**

1. **服务器心跳设置：**
   ```bash
   # /etc/ssh/sshd_config
   ClientAliveInterval 60
   ClientAliveCountMax 3
   ```

2. **禁用电池优化：**
   - MIUI：电池 → “不限制”
   - Android：设置 → 应用 → 禁用电池优化
   - iOS：开启后台刷新

## 输入问题

### 无法输入某些字符

**解决方案：** 设置 → 键盘类型 → 切换为 `visiblePassword`

注意：更改此项后，CJK（中日韩）输入法可能无法正常工作。

## 应用问题

### 应用在启动时崩溃

**症状：** 应用打不开、黑屏

**原因：** 设置损坏，特别是通过 JSON 编辑器修改后

**解决方案：**

1. **清除应用数据：**
   - Android：设置 → 应用 → ServerBox → 清除数据
   - iOS：删除并重新安装

2. **恢复备份：** 导入更改设置前创建的备份文件

### 备份/恢复失败

**备份失败：**
- 检查存储空间
- 确保应用具有存储权限
- 尝试不同的存储位置

**恢复失败：**
- 检查备份文件的完整性
- 检查应用版本兼容性

## 桌面组件（Widget）问题

### 组件不更新

**iOS：**
- 自动刷新最多可能需要等待 30 分钟
- 尝试删除并重新添加组件
- 检查 URL 是否以 `/status` 结尾

**Android：**
- 点击组件以强制刷新
- 确保组件 ID 与应用设置中的配置一致

**watchOS：**
- 重启手表应用
- 更改配置后等待几分钟
- 核对 URL 格式

### 组件显示错误

- 确保服务器上正在运行 ServerBox Monitor
- 在浏览器中测试 URL
- 检查身份验证凭据

## 性能问题

### 应用响应慢

**解决方案：**
- 在设置中降低刷新频率
- 检查网络速度
- 禁用不常用的服务器

### 耗电量高

**解决方案：**
- 增加刷新间隔
- 禁用后台刷新
- 关闭不使用的 SSH 会话

## 获取帮助

如果问题仍然存在：

1. **搜索 GitHub Issues：** https://github.com/lollipopkit/flutter_server_box/issues
2. **提交新 Issue：** 请包含应用版本、平台和复现步骤
3. **查看 Wiki：** 本文档以及 GitHub Wiki
