SSHAI是一个开源工具。它让用户通过SSH协议连接AI服务。用户可以在任何支持SSH的环境中使用大语言模型。工具支持DeepSeek和Hunyuan等模型。连接方式安全，包括密码和公钥认证。界面友好，有彩色输出和动画效果。配置简单，用YAML文件设置API密钥和提示词。项目用Go语言开发，模块化设计易扩展。用户可实时看到模型思考过程。工具支持MCP协议，集成外部工具如文件系统和网络搜索。启动时显示欢迎页。项目在GitHub上开源，采用Apache 2.0许可。用户可直接克隆代码编译运行。开源版本提供测试服务器，用户通过ssh命令连接体验。官方有付费多用户版。
功能列表
- SSH安全连接：用SSH协议加密访问AI服务，支持端口自定义和后台运行。
- 灵活认证：支持密码登录、SSH公钥无密码登录和无认证模式，兼容RSA和Ed25519密钥。
- 多模型支持：集成DeepSeek、Hunyuan等大模型，可切换本地或云端API端点。
- 实时思考显示：模型生成响应时，实时显示思考步骤，如DeepSeek R1的推理过程。
- MCP工具集成：支持Model Context Protocol，连接外部工具，包括时间查询、文件读写和Bing搜索。
- 美观界面：彩色终端输出、动画效果和ASCII艺术，提升交互体验。
- 配置管理：用YAML文件设置API密钥、提示词和工具参数，支持动态加载配置文件。
- 多语言界面：提供中英文切换，适应不同用户习惯。
- 交互模式：三种调用方式，包括交互聊天、单命令执行和管道输入处理。
- 欢迎页和监控：启动显示自定义横幅，内置重试机制确保连接稳定。
使用帮助
SSHAI是一个命令行工具。用户需要Go环境编译运行。它没有复杂安装。整个过程从克隆代码开始。用户先准备Git和Go工具。然后一步步操作，就能连接AI服务。工具运行在本地服务器上。用户用ssh命令访问。以下是详细步骤。
安装流程
- 克隆仓库。
打开终端。输入命令克隆代码。git clone https://github.com/sshllm/sshai.git cd sshai这会下载所有文件，包括主程序和配置示例。仓库大小小，下载快。
- 编译程序。
SSHAI用Go写成。确保Go 1.20或更高版本安装。运行make命令编译。make build或者直接用go build。
go build -o sshai cmd/main.go编译后，生成可执行文件sshai。放在PATH路径下，便于调用。如果用Windows，用go build生成exe文件。
- 配置YAML文件。
复制示例文件config.yaml。编辑它设置参数。文件在根目录。关键部分包括：- API端点：如DeepSeek的URL和密钥。示例：
models: deepseek: api_key: "your-api-key" base_url: "https://api.deepseek.com" - 认证设置：用户名和密码，或公钥路径。示例：
auth: username: "user" password: "pass" # 或用 public_keys: ["/path/to/key"] - 提示词自定义：定义系统提示，如“作为一个AI助手，帮助用户解决问题”。
- MCP工具：启用文件系统工具，设置路径限制。示例：
mcp_tools: filesystem: enabled: true root: "/safe/dir"
保存后，配置生效。英文版用config-en.yaml。
- API端点：如DeepSeek的URL和密钥。示例：
- 生成SSH密钥（可选）。
如果用公钥认证，生成密钥对。运行：ssh-keygen -t ed25519 -C "your-email"复制公钥到authorized_keys文件。在服务器侧设置。工具自动识别密钥。
运行服务器
编译后，启动SSHAI服务器。它监听端口，提供AI服务。默认端口2213。
- 直接运行。
在sshai目录执行：./sshai服务器启动。显示欢迎横幅，如ASCII艺术和版本信息。日志输出到终端。
- 指定配置文件。
用-c参数加载自定义配置：./sshai -c config.yaml这覆盖默认设置。
- 后台运行。
生产环境用nohub或重定向日志：nohup ./sshai > server.log 2>&1 &或用脚本：
./scripts/run.sh脚本处理启动和日志。检查进程：ps aux | grep sshai。
- 测试连接。
用开源测试服务器体验，无需本地运行：ssh test.sshai.top -p 9527输入用户名和密码。进入交互模式。
连接和使用AI服务
服务器运行后，用ssh客户端连接。工具支持三种模式。选择适合场景。
- 交互模式。
打开新终端。连接本地服务器：ssh user@localhost -p 2213输入密码或用密钥。进入聊天界面。提示符如“AI>”。输入问题，如“解释Python列表”。AI响应实时显示，包括思考链。退出用exit或Ctrl+D。
示例对话：- 用户：写一个Hello World脚本。
- AI：生成代码，并解释每行。支持多轮对话，上下文保留。
- 命令行模式。
执行单次命令，无需交互：ssh user@localhost -p 2213 "分析这段JSON数据"传递参数作为提示。输出直接到终端。适合脚本自动化。添加-p参数跳过主机检查：
ssh -p 2213 -o StrictHostKeyChecking=no user@localhost "你的问题" - 管道模式。
处理输入流，如文件内容：cat data.txt | ssh user@localhost -p 2213或结合echo：
echo "优化这个SQL查询" | ssh user@localhost -p 2213AI分析管道输入，生成输出。用于日志解析或代码审查。
特色功能操作
- 实时思考显示。默认启用。在交互模式，模型如DeepSeek R1会输出“思考中…”然后步骤。配置中设置：
display: thinking: true帮助用户理解AI决策。
- MCP工具使用。启用后，AI可调用工具。示例：在配置中添加Bing工具。聊天时说“搜索最新AI新闻”。AI自动调用fetch工具，返回结果。文件工具示例：
- 用户：读取文件内容。
- AI：用filesystem工具访问/root/file.txt，显示内容。安全限制根目录，避免敏感操作。
- 自定义提示。编辑YAML的prompts部分。系统提示如“用中文回复技术问题”。用户提示前缀自定义，提升响应质量。
- 多模型切换。配置多个模型。运行时指定：
ssh user@localhost -p 2213 -m deepseek "问题"工具动态加载，响应时间视模型而定。
操作注意事项
- 安全性。用强密码或密钥。防火墙开放端口2213。避免公网暴露，除非用VPN。
- 性能。本地运行需GPU支持大模型。云API有配额限制。
- 调试。日志在server.log。常见错误：API密钥无效，重启服务器。
- 扩展。模块在internal目录。添加新工具，修改mcp包。贡献PR到GitHub。
- 移动端。用Termux app在Android运行ssh命令连接。
这些步骤让用户快速上手。测试服务器帮助新手熟悉。配置灵活，适合个人或团队。运行稳定，响应快。用户反馈显示，管道模式特别实用。
应用场景
- 远程开发辅助
开发人员在无GUI环境如服务器上，用SSHAI生成代码片段或调试脚本。通过管道模式输入bug日志，AI快速分析原因。 - 系统运维
运维工程师连接工具，查询服务器状态或优化配置。MCP工具集成文件读写，AI建议自动化脚本，减少手动操作。 - 教育学习
学生在终端练习AI交互。实时思考显示帮助理解模型推理。切换中英文，适合非母语用户学习编程概念。 - 团队协作
团队部署多用户版。每个成员用公钥登录，共享提示模板。用于脑暴会议，AI总结讨论要点。 - 内容生成
作家或分析师用管道输入草稿，AI润色文本。支持长上下文，生成报告或文章大纲。
QA
- SSHAI需要什么环境运行？
需要Go 1.20+和Git。Linux、macOS和Windows都支持。编译后无依赖。 - 如何添加新AI模型？
编辑config.yaml的models部分。添加API URL和密钥。重启服务器生效。 - 工具支持哪些认证方式？
密码、SSH公钥和无认证。公钥推荐，用于自动化脚本。 - 开源版和付费版区别？
开源版单用户，适合个人。付费版在sshllm.top，支持多用户和高级管理。 - 连接失败怎么处理？
检查端口、防火墙和日志。常见是密钥权限，用chmod 600设置私钥。
简体中文 
English 
日本語 
Deutsch 
Português do Brasil