## hiSHtory 自建同步服务 **官方网站：** https://hishtory.dev **仓库地址：** https://github.com/lazycatapps/hishtory.git hiSHtory 是一个开源的 Shell 历史同步工具，本项目将其移植到懒猫微服平台，帮助你在多台终端之间安全共享命令历史。采用端到端加密，服务器无法解密命令内容，确保隐私安全。 ## 服务器部署 在懒猫微服中安装本应用并启动服务，等待容器初始化完成。 ## 客户端安装 在每台需要同步的机器上安装 hiSHtory 客户端，可选以下方式： 1. **官方安装脚本（推荐）** ```bash curl https://hishtory.dev/install.py | python3 - ``` 2. **手动下载二进制** 访问 https://github.com/ddworken/hishtory/releases 下载对应操作系统的压缩包，解压后将可执行文件放入 `~/bin` 或 `/usr/local/bin`，然后执行 `hishtory install` 安装过程中会生成密钥（Secret Key），请妥善保存，其他设备使用 `hishtory init <密钥>` 加入同步组。 ## 配置服务器地址 在每台设备的 Shell 配置文件（如 `~/.zshrc` 或 `~/.bashrc`）中添加环境变量： ```bash export HISHTORY_SERVER=https://hishtory.${LAZYCAT_BOX_NAME}.heiyu.space ``` 刷新终端后使用 `echo $HISHTORY_SERVER` 确认是否生效。 ## 常用命令 - **初始化绑定密钥:** `hishtory init <密钥>` - **查看状态:** `hishtory status` - **立即同步:** `hishtory reupload` - **查询历史:** `hishtory query --tail 20` - **按主机查看:** `hishtory query --host <主机名>` - **临时关闭同步:** `hishtory syncing disable` - **重新安装 Hook:** `hishtory install` - **启动 Web UI:** `hishtory start-web-ui` ## 验证同步 1. 在机器 A 执行 `echo hello-from-A` 2. 运行 `hishtory reupload` 强制上传 3. 在机器 B 执行 `hishtory query 'hello-from-A'`，若能看到该命令则同步成功 ## 安全与隐私 - 采用端到端加密，服务器无法解密命令内容 - 命令前加空格可跳过记录 - 使用 `hishtory syncing disable` 临时暂停记录 ## 常见问题 - **历史停滞:** 确认 Shell 配置文件中 `source ~/.hishtory/config.*`，重新执行 `hishtory install` - **密钥丢失:** 从已配置设备运行 `hishtory status` 查看 - **服务器无法访问:** 检查网络连通性或确认服务运行状态 - **排查日志:** `tail -f ~/.hishtory/hishtory.log`