Android App 安装指南

HiTerm Android App (hitermux) 让你能够通过手机远程连接到 PC 端，管理 tmux 会话。

⚠️ 前置依赖：Tailscale（必须！）

HiTerm App 依赖 Tailscale 来发现和连接你的 PC。如果没有 Tailscale，App 无法正常工作。

安装 Tailscale App

  1. 打开 Google Play Store
  2. 搜索 "Tailscale"
  3. 安装官方 Tailscale App
  4. 打开 App，登录与 PC 端相同的 Tailscale 账号

验证 Tailscale

打开 Tailscale App，确认：

  • 状态显示 "Connected"
  • 设备列表中能看到你的 PC

如果看不到 PC 或未连接，请先在 PC 上安装并登录 Tailscale，详见 Tailscale 配置指南。

系统要求

  • Android 版本: Android 5.0 (API 21) 或更高
  • 架构: 仅支持 arm64-v8a 架构
  • 存储空间: 至少 50MB 可用空间（App + Tailscale）
  • 网络: 需要稳定的网络连接
  • Tailscale: 必须安装并登录（与 PC 同账号）

下载安装包

由于我们暂时不上架 Google Play 商店，请手动下载安装包：

方法一：从官方网站下载

  1. 在手机浏览器中访问：

    https://www.yinbin.ink/download/hitermux.apk

  2. 下载完成后，点击 APK 文件开始安装

方法二：通过 PC 传输

  1. 在 PC 上下载 APK 文件：

    https://www.yinbin.ink/download/hitermux.apk

  2. 通过以下方式传输到手机：

    • USB 数据线
    • 微信/Telegram 等聊天工具
    • 云存储（如 Google Drive、百度云等）

  3. 在手机文件管理器中找到 APK 文件，点击安装

安装步骤

1. 允许安装未知来源应用

Android 8.0 及以上版本：

  1. 进入 设置 → 安全 或 应用和通知
  2. 找到 "允许安装未知来源应用" 选项
  3. 选择 允许 或 开启
  4. 可能需要选择允许浏览器或文件管理器安装应用

Android 14 及以上版本：

  1. 打开 设置 → 应用
  2. 找到你用来下载 APK 的应用（浏览器、文件管理器）
  3. 进入 安装未知应用 设置
  4. 选择 允许

2. 安装 APK

  1. 找到下载的 hitermux.apk 文件
  2. 点击文件，系统会提示安装
  3. 查看应用请求的权限：
    • 网络访问（用于连接云端和 Tailscale）
    • 相机权限（用于扫描二维码）
    • 存储权限（用于管理文件）
  4. 点击 安装 或 继续
  5. 等待安装完成

3. 完成安装

安装完成后，你可以：

  • 点击 打开 直接启动应用
  • 点击 完成 返回主屏幕

首次使用

1. 启动应用

从主屏幕或应用列表中找到 HiTerm 或 hitermux 图标并打开。

2. 扫码登录

  1. 确保 PC 端已完成 hicli setup 并已登录
  2. 在手机上点击 "扫码登录" 按钮
  3. 使用相机扫描 PC 端浏览器显示的二维码
  4. 扫描成功后，你的手机账号将与 PC 账号关联

3. 连接设备

  1. 应用会自动同步你的设备列表
  2. 选择要连接的设备
  3. 首次连接时，应用会：
    • 自动安装 mosh（如果未安装）
    • 生成 SSH 密钥
    • 配置连接参数

4. 管理 tmux 会话

连接成功后，你可以：

  • 查看当前运行的所有 tmux 会话
  • 创建新会话
  • 连接到已有会话
  • 分离/终止会话

应用功能

设备管理

  • 自动同步云端设备列表
  • 实时显示设备在线状态
  • 查看设备详细信息（IP 地址、系统信息等）

Tmux 会话管理

  • 列出所有运行中的 tmux 会话
  • 快速连接到会话
  • 创建新会话
  • 终止会话
  • 分离当前会话

终端功能

  • 完整的终端模拟器
  • 支持 mosh 连接（弱网优化）
  • 颜色显示
  • 快捷键支持
  • 会话持久化

SSH 密钥管理

  • 自动生成 SSH 密钥对
  • 安全存储私钥
  • 自动推送公钥到 PC 端

通知功能

  • 接收云端推送的通知
  • 本地通知提醒
  • 自定义通知设置

常见问题

Q: 安装时提示"应用已损坏"或"解析包错误"

A: 请确保：

  • APK 文件下载完整
  • 没有被修改或损坏
  • 尝试重新下载

Q: 安装失败，提示"签名不一致"

A: 如果你之前安装过旧版本：

  1. 先卸载旧版本应用
  2. 再安装新版本

Q: 无法扫码登录

A: 请检查：

  • PC 端是否已完成 hicli setup
  • PC 端是否显示二维码
  • 手机相机权限是否已授予
  • 网络连接是否正常

Q: 连接设备失败

A: 请检查：

  • PC 端 Tailscale 是否正在运行
  • PC 端 hicli 服务是否已启动
  • 手机端 Tailscale 是否已登录（与 PC 相同账号）
  • 网络连接是否正常
  • 尝试在 PC 端运行 hicli restart

Q: 应用崩溃或无响应

A: 请尝试：

  • 重启应用
  • 清除应用缓存
  • 卸载后重新安装
  • 联系技术支持

Q: 无法连接到 tmux 会话

A: 请检查：

  • PC 端是否有运行中的 tmux 会话
  • PC 端是否已安装 mosh
  • SSH 密钥是否正确配置
  • 防火墙设置是否允许连接

Q: 如何更新应用？

A: 由于未上架商店，需要：

  1. 下载最新版本的 APK 文件
  2. 直接安装（会自动覆盖旧版本）

安全说明

权限说明

  • 网络访问: 必需，用于连接云端服务器和 Tailscale
  • 相机: 必需，用于扫描二维码登录
  • 存储: 必需，用于管理应用文件和日志

数据安全

  • SSH 密钥使用 Android Keystore 加密存储
  • 通信使用 TLS 加密
  • 本地数据不会上传到云端（除必要的认证信息）

隐私保护

  • 我们不收集个人使用数据
  • 日志仅用于问题诊断
  • 你可以随时注销账号并删除所有本地数据

技术支持

获取帮助

日志收集

如果遇到问题，可以通过以下方式收集日志：

  1. 打开应用设置
  2. 找到 "导出日志" 或 "日志" 选项
  3. 导出日志文件
  4. 将日志发送给技术支持

更新日志

v1.0.0 (当前版本)

  • 初始发布
  • 支持扫码登录
  • 设备管理功能
  • Tmux 会话管理
  • mosh 连接支持
  • SSH 密钥自动管理
  • 云端通知推送

提示: 如果你遇到任何问题，请随时联系我们的技术支持团队。

在 GitHub 上编辑此页