Skip to content

Releases: topcheer/cligool

CliGool v1.5.5

10 Mar 14:56

Choose a tag to compare

fix: keep waiting web sockets alive

Keep browser terminal sockets open while a session is waiting for the
CLI client, maintain per-peer heartbeat tracking on the relay, and
restore the terminal stream on the same connection when the CLI comes
back.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

CliGool v1.5.4

10 Mar 05:53

Choose a tag to compare

fix: retry cli relay connections

Keep local PTY/ConPTY sessions running while relay or proxy WebSocket
connections retry in the background, buffer unsent outbound messages,
and replay them in order after reconnect.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

CliGool v1.5.3

10 Mar 04:26

Choose a tag to compare

CliGool v1.5.2

09 Mar 15:27

Choose a tag to compare

CliGool v1.5.2

CliGool v1.5.1

09 Mar 12:54

Choose a tag to compare

CliGool v1.5.1

CliGool v1.5.0

09 Mar 12:17

Choose a tag to compare

CliGool v1.5.0 - 网站体验与发布链路升级

🎉 本次版本亮点

CliGool v1.5.0 聚焦两件事:

  • 让最终用户在首页和终端页获得更稳定、更直接、更易理解的体验
  • 让 Docker 构建与下载发布链路更快、更可靠

🚀 核心更新

🌐 网站与终端体验重做

  • ✅ 全面重做首页视觉与信息层级,突出下载、状态、入口与操作路径
  • ✅ 终端页支持更清晰的连接状态展示
  • ✅ 当 WebSocket 已连接且 CLI session 存在时,仅显示终端本体,减少干扰
  • ✅ 首页新增手动输入 session 名称的入口,可直接打开终端页

🔁 WebSocket 自动恢复

  • ✅ 终端页加入自动重连逻辑
  • ✅ 使用指数退避减少抖动场景下的无效重试
  • ✅ 明确区分连接中、重连中、等待 CLI、失败与断开等状态
  • ✅ 修复等待界面文案布局错乱问题

🌍 国际化与自动语言适配

  • ✅ 首页和终端页支持多语言
  • ✅ 根据浏览器语言自动选择中文、英文、日文或西班牙文
  • ✅ 新增共享 i18n 脚本,统一页面翻译与动态文案更新

📦 下载体验与链接可靠性修复

  • ✅ 首页 GitHub 链接修正为正确 upstream 仓库
  • ✅ 修复下载链接与镜像内产物不一致导致的 404 问题
  • ✅ Docker 镜像现在会显式产出并复制所需下载文件,避免脏工作区掩盖问题

🐳 Docker 构建提速

  • ✅ 将 Dockerfile.multiarch 拆分为多个可并行的 sibling stages
  • ✅ 共享基础构建层,减少重复依赖下载
  • ✅ 在 BuildKit 下可并行构建多组 CLI 客户端产物

🧠 Relay 行为修复

  • ✅ Web 客户端成功接收缓存消息后,服务器会清空已回放缓存
  • ✅ 新增自动化测试覆盖该行为,避免历史消息重复回放

🧪 验证情况

本次改动已完成以下验证:

make test
docker-compose -f docker-compose.dev.yml build relay-server

并额外验证:

  • 镜像内 /app/web/downloads 已包含目标下载文件
  • /downloads/cligool-darwin-amd64
  • /downloads/cligool-darwin-arm64
  • /downloads/cligool-freebsd-arm64

上述下载地址均已返回 200

⬆️ 升级方式

Docker 部署

docker-compose -f docker-compose.dev.yml build relay-server
docker-compose -f docker-compose.dev.yml up -d

如果使用远程镜像部署,请拉取 v1.5.0 对应版本并重启服务。

📚 涉及的主要文件

  • web/landing.html
  • web/terminal.html
  • web/lib/i18n.js
  • internal/relay/relay.go
  • internal/relay/relay_test.go
  • Dockerfile.multiarch

CliGool v1.4.0

08 Mar 08:26

Choose a tag to compare

feat: Web终端用户体验全面升级 (v1.4.0)

## 核心功能

### 1. 消息缓存机制
- 服务器自动缓存CLI输出(最多1000条消息)
- Web客户端连接时自动恢复历史消息
- 支持多Web客户端轮流查看同一session

### 2. 平滑终端初始化
- 移除临时欢迎信息,消除视觉闪烁
- 收到第一个WebSocket消息时智能清理终端
- 提供流畅的专业加载体验

### 3. 自动隐藏UI
- 连接成功后自动隐藏页头页尾,提供全屏终端体验
- 断开连接后自动恢复UI,方便查看连接状态

### 4. 无CLI客户端友好提示
- 连接到不存在session时显示友好错误提示
- 自动生成平台特定的启动命令
- 包含下载链接和使用指导

### 5. CLI断开通知
- CLI断开时立即通知所有Web客户端
- 显示清晰的断开消息和原因

### 6. 错误处理改进
- 使用defer确保WebSocket连接总是被正确清理
- 发送详细错误消息给Web客户端
- 移除log.Fatalf,确保资源清理

### 7. 移除不必要的消息
- 移除所有连接状态和欢迎消息
- 保持浏览器控制台日志用于调试

### 8. -no-browser参数
- 支持禁止自动打开浏览器
- 可通过配置文件设置

## 修改文件

- internal/relay/relay.go: 添加缓存机制、CLI断开通知、无CLI检测
- cmd/client/config.go: 添加no_browser字段
- cmd/client/main_unix.go: 错误处理改进、-no-browser支持
- cmd/client/main_windows.go: 错误处理改进、-no-browser支持
- web/terminal.html: 平滑初始化、自动隐藏UI、移除不必要消息
- go.mod: 更新依赖

## 新增文档

- docs/AUTO_HIDE_UI_FEATURE.md
- docs/CACHE_FEATURE.md
- docs/CLI_DISCONNECT_NOTIFICATION.md
- docs/ERROR_HANDLING_FIX.md
- docs/NO_BROWSER_OPTION.md
- docs/NO_CLI_HINT_FEATURE.md
- docs/WEB_INIT_OPTIMIZATION.md
- docs/WEB_TERMINAL_IMPROVEMENTS_SUMMARY.md
- docs/v1.4.0_RELEASE_NOTES.md

## 清理

- 删除冗余文档 docs/NO_IMPROVED_WEB_CONNECTION.md
- 删除临时文件 cligool-windows-*.zip

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CliGool v1.3.0

07 Mar 15:32

Choose a tag to compare

Release v1.3.0: 无状态架构重构

核心更新:
- 移除数据库和Redis依赖,改为内存会话管理
- 简化部署:从3个服务减少到1个服务
- 分离生产和开发环境Docker配置
- 修复Koyeb平台健康检查配置
- 修复server参数带斜杠的URL拼接问题
- 更新所有文档以反映新架构
- 支持平台:30个操作系统和架构

CliGool v1.2.0-test

07 Mar 08:32

Choose a tag to compare

docs: 更新所有文档以反映实际支持的30个平台

移除不支持的平台并更新所有相关文档。

平台变更:
- 移除OpenBSD 386/arm/riscv64(pty库限制)
- 移除DragonFlyBSD arm64(Go不支持)
- 实际支持:30个平台(28个Unix + 2个Windows)

文档更新:
1. PLATFORMS.md
   - 平台数量:33个 → 30个
   - 移除不支持的平台列表
   - 更新覆盖率表格(88%,29/33)

2. PLATFORMS_EN.md
   - 同步英文版更新
   - 保持与中文版一致

3. README_EN.md
   - 更新badge:platforms-33 → platforms-30
   - 更新描述:33 platforms → 30 platforms
   - 更新架构图:33 Platforms → 30 Platforms
   - 更新*BSD系统说明:16 → 12 platforms

4. docs/DOCKER.md / docs/DOCKER_EN.md
   - 更新镜像内容描述:33个平台 → 30个平台

5. .github/workflows/release.yml
   - 移除OpenBSD 386/arm/riscv64构建步骤
   - 移除DragonFlyBSD arm64构建步骤
   - 移除相应平台的归档创建步骤
   - 移除相应平台的上传步骤

实际支持的平台:
- Windows: 2个
- macOS: 2个
- Linux: 13个
- FreeBSD: 5个
- OpenBSD: 2个(仅amd64/arm64)
- NetBSD: 4个
- DragonFlyBSD: 1个(仅amd64)
- 总计: 30个平台

所有文档现在准确反映实际支持的平台!

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CliGool v1.1.0

07 Mar 08:04

Choose a tag to compare

CliGool v1.1.0 - 简化安装方式

🎉 项目简介

CliGool是一个基于Go和WebSocket的跨平台远程终端解决方案,让您的本地终端可以通过任何Web浏览器访问。

✨ v1.1.0 重要更新

🔧 简化安装方式

  • Windows: 改用zip压缩包安装,移除复杂的Inno Setup安装程序
  • macOS/Linux: 继续使用一键安装脚本
  • 所有平台: GitHub Actions自动构建和发布

📦 跨平台支持

  • 支持18个操作系统和架构(Windows、Linux、macOS、*BSD等)
  • Windows版本使用ConPTY,与Unix系统功能完全对等
  • 自动检测终端编码,完美支持中文等多语言环境

⚡ 核心功能

  • 低延迟 - WebSocket毫秒级响应
  • 真实PTY - 完整的终端特性支持
  • AI CLI工具 - 完美支持Claude、Gemini、Aider等
  • 多用户协作 - 多人可同时连接同一终端会话
  • Docker部署 - 一键部署,开箱即用

🚀 快速安装

macOS/Linux

curl -sSL https://raw.githubusercontent.com/topcheer/cligool/main/install.sh | bash

Windows

# 1. 下载zip文件
https://github.com/topcheer/cligool/releases/latest/download/cligool-windows-amd64.zip

# 2. 解压到任意目录(如 C:\Program Files\CliGool)
# 3. 将目录添加到系统PATH环境变量
# 4. 在命令行中运行 cligool.exe

📦 支持的平台

Windows (2个)

  • Windows amd64 (Intel/AMD 64位)
  • Windows arm64 (Surface Pro X等ARM设备)

macOS (2个)

  • macOS amd64 (Intel Mac)
  • macOS arm64 (Apple Silicon M1/M2/M3)

Linux (8个)

  • Linux amd64 (Ubuntu、Debian、CentOS等64位系统)
  • Linux arm64 (ARM服务器)
  • Linux 386 (32位系统)
  • Linux arm (ARMv7设备)
  • Linux ppc64le (PowerPC)
  • Linux riscv64 (RISC-V)
  • Linux s390x (IBM Z)
  • Linux mips64le (MIPS)

*BSD系统 (6个)

  • FreeBSD amd64/arm64
  • OpenBSD amd64/arm64
  • NetBSD amd64
  • DragonFlyBSD amd64

📚 文档

🔗 在线体验

https://cligool.zty8.cn/

📄 许可证

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎提交Issue和Pull Request!

📞 联系方式


感谢使用CliGool!如果觉得有用,请给个⭐️支持一下!