Repository navigation
ShellPier v0.5.0-alpha.1
Pre-release
Pre-release
·
18 commits
to main
since this release
本版以简单易用为优先:直接传文件、直接用后台任务与转发,增加一条命令即可使用的目录分享和反向转发。
- 移除普通传输的额外全文件 SHA-256 计算、
--verify和files checksum;续传所需的内部来源绑定仍自动完成。 --skip-existing直接跳过已有文件,不比较内容;替代--skip-identical。预览版旧脚本需去掉已删除参数。share --root DIR --output access.json只共享指定目录,对方从虚拟/访问,不需要管理员或额外权限配置。- 完整模式默认支持有界 jobs 和 TCP 转发。
--allow-jobs=false与--allow-forward仅在需要限制时使用。 forward TICKET --reverse --listen 8080 --to 127.0.0.1:3000在目标电脑回环地址监听,连接控制电脑的服务;兼容原生 OpenSSH-R,支持自动分配端口。files read支持普通文件的符号链接;目录分享由服务端自动约束实际访问范围。同步精简文档、机器接口和 Agent skill。
工具对比涵盖 OpenSSH、Go 目录根、rsync/rclone、Chisel、sshuttle 等 26 项官方资料;常用例子见命令手册。
验证
- 源码固定为
ba6270eefeeff06709d035c902927b446c0d64cb;三平台 CI、最低 Go 版本和漏洞检查均通过,包括 race 和 10 轮重复测试。 - 发行构建生成 Windows amd64/386/arm64、Linux amd64/arm64、macOS amd64/arm64 共 7 个离线包,使用 Go 1.27.2;已下载检查来源提交、构建状态、目标架构、文档与许可。
- 使用下载包中的 macOS arm64 程序完成真实验收:exec/PTY/持久终端、jobs、文件传输及续传、目录边界与符号链接、skip-existing、默认正反向转发、MCP、原生 OpenSSH/SFTP/ControlMaster/SOCKS/Unix socket,以及普通模式和目录模式的 LaunchAgent 安装、启动、使用、停止和卸载。
已知边界
- Windows CI 首次执行 10 轮重复测试时,在 Go
net/http.Transport.prepareTransportCancel出现一次concurrent map writes崩溃;相同提交重新执行 race、10 轮全套测试和后续检查均通过,本机对应 TLS 用例 100 轮 race 及相关网络用例 5 轮 race 也通过。根因尚未确认,保留该异常记录,不宣称已修复。CI 记录 - 仍为预览版;Windows 7/8 Legacy 路线、最低系统版本、更多 CPU 和校园代理/热点组合尚未全部实机验证。
--root是 SFTP 文件访问边界,不提供 shell/PTY/jobs/转发,也不是操作系统沙箱;已有硬链接别名和挂载点不在隔离保证内。反向端口只监听 loopback。- Linux/Windows 的实际用户服务管理器及各平台登录自启环境仍需实机验收。
- 发行文件尚未提供操作系统代码签名或 macOS 公证。