安装指南

详细的 HiCLI 安装和配置说明。

系统要求

PC 端

系统 最低版本 注意事项
Linux Ubuntu 20.04+ / Debian 10+ / CentOS 8+ 支持主流发行版
macOS 10.15 (Catalina)+ 支持 Intel 和 Apple Silicon
Windows 10/11 ⚠️ 仅支持 WSL2

移动端

系统 最低版本 架构要求
Android 5.0 (API 21)+ 仅支持 arm64-v8a

注意： 目前暂不支持 iOS 设备。

安装方式

方式一：一键安装（推荐）

这是最简单快速的安装方式，自动检测系统并安装对应的二进制文件。

curl -fsSL https://www.yinbin.ink/install.sh | bash

安装完成后，重新打开终端或运行：

export PATH="$HOME/.local/bin:$PATH"

方式二：手动下载

如果你更愿意手动控制安装过程，可以下载对应的二进制文件：

平台 架构 下载链接
Linux amd64 (x86_64) 下载
Linux arm64 下载
macOS amd64 (x86_64) 下载
macOS arm64 (Apple Silicon) 下载

下载后执行：

# 设置可执行权限
chmod +x hicli-*

# 移动到 PATH 目录
mv hicli-* ~/.local/bin/hicli

Windows WSL2 安装

如果你使用 Windows，必须先安装和配置 WSL2：

1. 启用 WSL2

在 PowerShell (管理员模式) 中运行：

wsl --install

重启电脑后按提示完成 Ubuntu 安装。

2. 更新 WSL2

在 PowerShell 中运行：

wsl --update

3. 安装 HiCLI

在 WSL2 Ubuntu 终端中运行：

curl -fsSL https://www.yinbin.ink/install.sh | bash

验证安装

检查版本

hicli version

你应该看到类似输出：

hicli version 1.0.0

查看帮助

hicli --help

配置

配置文件位置

HiCLI 的配置文件位于：

  • Linux/macOS: ~/.hiterm/config.json
  • Windows (WSL2): ~/.hiterm/config.json

配置文件内容

配置文件会在首次运行 hicli setup 时自动创建，包含：

  • 认证信息（Token）
  • 用户信息
  • 订阅状态
  • 设备信息
  • 通知配置
  • 心跳配置

手动修改配置文件：

{
  "cloudUrl": "https://www.yinbin.ink",
  "logs": {
    "enabled": true,
    "path": "~/.hiterm/logs/hicli.log",
    "maxSizeMB": 100,
    "maxBackups": 5
  },
  "heartbeat": {
    "enabled": true,
    "interval": 300
  }
}

环境变量

可选的环境变量配置：

# 自定义 HiCloud 服务地址
export HICLI_HICLOUD_URL=https://www.yinbin.ink

# 调试模式（输出详细日志）
export HICLI_DEBUG=1

首次配置

初始化

对于新用户，运行以下命令完成首次配置：

hicli setup

此命令会引导你完成：

  1. 环境检查（Tailscale、sudo 权限）
  2. OAuth 登录
  3. 上报设备信息到云端
  4. 安装 mosh（弱网 SSH 服务端）
  5. 安装系统服务（开机自启）
  6. 配置通知（AI 工具推送）

验证配置

# 查看运行状态
hicli status

# 查看详细版本信息
hicli version --verbose

系统服务

HiCLI 会自动配置系统服务，实现开机自启。

Linux (systemd)

服务文件：~/.config/systemd/user/hicli.service

常用命令：

# 启动服务
systemctl --user start hicli

# 停止服务
systemctl --user stop hicli

# 重启服务
systemctl --user restart hicli

# 查看状态
systemctl --user status hicli

# 开机自启
systemctl --user enable hicli

# 禁用开机自启
systemctl --user disable hicli

macOS (launchd)

服务文件：~/Library/LaunchAgents/com.hiterm.hicli.plist

常用命令：

# 启动服务
launchctl load ~/Library/LaunchAgents/com.hiterm.hicli.plist

# 停止服务
launchctl unload ~/Library/LaunchAgents/com.hiterm.hicli.plist

# 查看状态
launchctl list | grep hiterm

故障排除

安装问题

问题：curl 命令不存在

解决方案：

# Ubuntu/Debian
sudo apt install curl

# CentOS/RHEL
sudo yum install curl

# macOS (已预装)
# 无需安装

问题：权限不足

解决方案：

# 确保安装目录存在
mkdir -p ~/.local/bin

# 设置正确的权限
chmod +x hicli-*

配置问题

问题：Tailscale 未安装

解决方案：

# Linux
curl -fsSL https://tailscale.com/install.sh | sh

# macOS
# 从 https://tailscale.com/download/ 下载并安装

问题：系统服务启动失败

解决方案：

# 诊断问题
hicli doctor --fix

# 查看详细日志
tail -f ~/.hiterm/logs/hicli.log

# 手动重启服务
hicli restart

网络问题

问题：无法连接到 HiCloud

解决方案：

  1. 检查网络连接
  2. 检查防火墙设置
  3. 检查 HiCloud 服务状态：
curl https://www.yinbin.ink/healthz

问题：OAuth 登录失败

解决方案：

  1. 确保网络可以访问 https://www.yinbin.ink
  2. 检查浏览器是否被代理或防火墙阻止
  3. 尝试手动登录：
hicli login

权限问题

问题：sudo 权限不足

解决方案：

HiCLI 在以下操作时需要 sudo 权限：

  • 安装系统服务
  • 配置网络设置
  • 访问系统日志

确保用户在 sudoers 中：

# 检查 sudo 权限
sudo -v

# 如果提示输入密码，说明有权限
# 如果提示"不在 sudoers 文件中"，需要联系管理员

卸载

完全卸载

# 卸载 HiCLI（会自动停止服务、清理配置、移除钩子）
hicli uninstall

# 手动删除二进制文件（如果需要）
rm ~/.local/bin/hicli

# 手动删除配置目录（如果需要）
rm -rf ~/.hiterm

仅卸载服务

# Linux
systemctl --user stop hicli
systemctl --user disable hicli

# macOS
launchctl unload ~/Library/LaunchAgents/com.hiterm.hicli.plist

更新

自动更新

# 检查更新
hicli update --check

# 更新到最新版本
hicli update

手动更新

# 下载最新版本
curl -fsSL https://www.yinbin.ink/install.sh | bash

# 或手动下载后替换
# 1. 下载对应平台的二进制文件
# 2. 备份旧版本：mv ~/.local/bin/hicli ~/.local/bin/hicli.old
# 3. 安装新版本：mv hicli-* ~/.local/bin/hicli

下一步

技术支持

如果遇到其他问题：

Edit this page on GitHub