-
v0.1.2 Stable
released this
2026-04-27 00:08:13 +08:00 | 0 commits to master since this releasefix: 修正 starssh 的 ssh-agent forwarding 生命周期与登录超时语义
- 重构 ssh-agent forwarding 为按
auth-agent@openssh.comchannel 动态建桥,不再长期持有单个本地 agent 连接 - 新增
sshAgentForwardProxy/sshAgentForwardBridge,统一管理活跃 bridge 生命周期,并在单侧 EOF、bridge 关闭和proxy.Close()时主动释放本地 agent 连接与 SSH channel - 保持 denied / unavailable / close-race 的既有语义,同时继续保证自动 forwarding 的 best-effort 行为
- 为
LoginInput新增DialTimeout,将 TCP/proxy/ssh-agent 拨号超时与 SSH 握手/认证超时拆分 - 将
Timeout收口为握手/认证阶段超时,0表示不限制,不再在登录入口自动回填默认值 - 新增
effectiveLoginTimeout/effectiveDialTimeout,统一登录、transport、proxy 和 agent forwarding 的超时决策 - 调整 login / transport / agent forwarding 链路,确保拨号阶段统一使用
DialTimeout,认证阶段仅使用Timeout - 保持
LoginSimple的直观行为:传入单个 timeout 时同时映射到Timeout和DialTimeout - 补充回归测试,覆盖 forwarding 启用/禁用、denied、unavailable、close race、单侧 EOF 释放、proxy Close 主动回收,以及登录超时零值与优先级语义
Downloads
- 重构 ssh-agent forwarding 为按
-
v0.1.1 Stable
released this
2026-04-26 20:27:47 +08:00 | 2 commits to master since this releasefeat: 增强 starssh 的 agent forwarding 与 tcp/unix 转发能力
- 为 LoginInput 增加 ForwardSSHAgent 配置,并在 Exec/PTTY 会话创建时按需自动请求 agent forwarding
- 新增 agent_forward 运行时,封装本地 ssh-agent 建连、转发注册、显式请求与 unavailable/denied 语义
- 自动 agent forwarding 改为 best-effort:本地 agent 不可用、转发被拒绝或初始化失败时不再打断会话创建
- 为 StarSSH 增加 closing 状态与 agent forwarder 生命周期回收,避免 Close 与会话创建并发时泄漏资源
- 扩展 ForwardRequest 为带网络归一化的转发模型,支持 tcp/tcp4/tcp6/unix 端点组合
- 新增本地/远端 tcp<->unix、unix<->unix 及 detached helper,补齐 streamlocal 场景下的常用 API
- 将显式网络地址编码收口为 tcp4://、tcp6://、unix://,消除 tcp:22 一类值的解析歧义
- 为本地 unix listener 增加 stale socket 探测、复用与关闭清理,避免遗留 socket 导致重启失败
- 补充 agent forwarding、关闭竞态、remote unix forward、local unix forward、stale socket 复用与端点解析等回归测试
Downloads
-
v0.1.0 Stable
released this
2026-04-26 10:46:51 +08:00 | 3 commits to master since this releaserefactor: 重构 starssh 核心运行时并补强 ssh/exec/terminal/sftp 能力
- 拆分原有单体
ssh.go,按职责重组为types、utils、transport、
login、keepalive、session、exec、pool、shell、terminal、
forward、hostkey、state等模块,并补充平台相关实现 - 重做登录与连接运行时,补齐基于 context 的建连、jump/proxy 链路、
可配置认证顺序,以及 Unix/Windows 下的 ssh-agent 支持 - 新增正式非交互执行模型
ExecRequest/ExecResult,支持流式输出、
溢出统计、超时控制,以及posix/powershell/cmd/raw多方言执行 - 保留旧 shell 风格兼容接口,同时让路径/用户探测等 helper 具备
跨 shell fallback,避免 Windows 目标继续硬依赖 POSIX 命令 - 新增
TerminalSession作为原始交互终端基座,提供 IO attach、
resize、signal/control、退出状态与关闭原因管理 - 重构端口转发语义,默认复用当前 SSH 连接,并显式提供 detached
的本地/动态转发模式承载隔离场景 - 梳理 keepalive 与取消语义,区分“仅取消本次操作”和“关闭整条连接”,
并统一连接状态与传输关闭路径 - 围绕新的 session/连接生命周期重做执行池与运行时支撑
- 大幅增强 SFTP 传输链路,补齐更安全的原子替换、校验、进度回调、
重试隔离、可复用 client 生命周期与失败语义 - 新增取消语义、keepalive、SFTP、forward、terminal input 等关键
回归测试,提升核心链路稳定性
Downloads
- 拆分原有单体