安装与初始化
安装
安装包下载入口:
Windows
- 在最新 Release 下载
.exe安装包。 - 运行安装程序并完成安装。
- 在 Windows 集成 页面(可选)中,选择是否:
- 将 在 Cosmosh 中打开终端 添加到文件夹/磁盘右键菜单。
- 将 Cosmosh 注册为 Windows 终端启动应用(
App Paths),并创建cosmosh终端命令启动 shim。
- 从桌面或开始菜单启动 Cosmosh。
若启用右键菜单集成,资源管理器会将当前目录作为启动工作目录上下文传给 Cosmosh,并用于下一次本地终端会话创建。
若启用终端启动应用注册,你可以在 PowerShell/CMD 中直接使用 cosmosh 启动 Cosmosh。
macOS
- 在最新 Release 下载适配芯片架构的 macOS 安装包。
- 将应用拖入
Applications。 - 先从 Launchpad 或 Applications 启动一次 Cosmosh(用于初始化终端命令集成)。
- 在任意目录打开终端并执行
cosmosh,即可按该目录作为本地终端启动上下文拉起 Cosmosh。
若终端仍无法识别 cosmosh,请手动将 ~/Library/Application Support/Cosmosh/bin 加入 PATH,或在现有 PATH 目录中创建符号链接。
Linux
- 在最新 Release 下载 Linux 安装包(具体格式以发布产物为准)。
- 按当前发行版方式安装。
- 从应用启动器或终端启动 Cosmosh。
首次配置
- 确认应用语言与基础偏好设置。
- 准备至少一个 SSH 目标与认证方式。
- 如使用密钥认证,请确认私钥文件路径可用。
连接就绪检查
- 确认当前网络能访问目标主机与端口。
- 确认目标服务器 SSH 服务已开启。
- 确认账号具备你需要执行命令的权限。
安全建议
- 妥善保管私钥,避免共享密钥文件。
- 对未知主机先校验指纹,再决定是否信任。
- 远程连接建议使用最小权限账号。
安装或配置失败怎么办
- 请先查看故障排查中的对应问题处理路径。
安装后建议验证
- 正常启动 Cosmosh。
- 创建一个测试服务器配置。
- 建立 SSH 会话并执行
echo COSMOSH_OK。 - 显式关闭会话,确认生命周期行为正常。
截图占位
- Release 页面与安装包列表。
- 安装完成界面。
- 首次启动后的基础设置入口。