1. Cursor 远程 SSH 连不上麒麟服务器先看清这套链路到底在做什么Cursor 的远程 SSH 开发本质上是把「编辑器前端」留在 Windows把「代码索引、终端、语言服务」全部搬到 Linux 或麒麟服务器上跑。你在本地敲的每一个字符都会通过 SSH 隧道送到远端远端跑完再把结果传回来。所以它能不能连上取决于三件事SSH 本身通不通、远端 sshd 允不允许端口转发、远端能不能把 Cursor Server 装起来。很多人第一次用会卡在启动页找不到「远程 SSH」按钮其实这是正常的。Cursor 的远程入口不在欢迎页而是要先打开一个本地文件夹进入完整编辑界面再用Ctrl Shift P搜Remote-SSH: Connect to Host...。左下角那个远程/环境图标也是入口之一。搞清楚这个前提后面的排查才有意义。这套方案适合谁适合手上有局域网 Linux 或麒麟主机、想在 Windows 上享受 Cursor 的 AI 补全、又不想把代码同步来同步去的开发者。麒麟系统基于 LinuxSSH 行为跟常规发行版一致所以本文的命令两边通用。我试过在麒麟 V10 上从零配一遍踩的坑主要集中在公钥免密、登录脚本阻塞、以及远端下载 Cursor Server 失败这三块。下面按「先打通 SSH再统一 API 通道最后排障」的顺序讲每一步都给可复制的命令。需要提前说明的是Cursor 负责的是编辑体验而模型调用走的是另一条通道。把这条通道统一到 TaoToken可以让你在 Cursor、命令行工具、脚本里共用同一个 Key 和 Base URL省得每个工具配一遍。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 后面会给出具体配置。2. 前置准备TaoToken 统一 Key 与 Cursor 远程环境的基础配置在动手连 SSH 之前先把两件事准备好一个是远端的 SSH 可达性一个是模型 API 通道。这两件事互不干扰但都配好之后你的远程开发体验才完整。先说 TaoToken 这条线。它的作用是给你一个统一的 API 入口兼容 OpenAI 风格的调用方式。你需要拿到一个 API Key然后把它填到 Cursor 的模型设置里。获取 Key 的入口在控制台的 API Keys 页面地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到之后先放一边等 SSH 通了再填。再说远端环境。Cursor 远程连接对 sshd 有几个硬性要求最关键是允许 TCP 转发因为 Cursor 会用ssh -T -D 端口建立动态转发。在远端执行下面这条命令看生效配置sudo sshd -T | grep -iE allowtcpforwarding|disableforwarding|permitopen|gatewayports期望看到allowtcpforwarding yes、disableforwarding no。如果allowtcpforwarding是 no动态转发会直接失败Cursor 连上也会卡住。改完配置记得重启sudo systemctl restart sshd # 麒麟/部分发行版可能是 sudo systemctl restart ssh还有一个容易被忽略的点Cursor 安装远端服务时会用bash --login -c bash并通过管道喂脚本。如果你的~/.bashrc或~/.profile在非交互模式下还在read等待输入或者跑了很慢的命令就会导致「长时间无输出」。在~/.bashrc靠前位置加一段非交互早退case $- in *i*) ;; *) return ;; esac自测一下是否立即返回bash --login -c echo LOGIN_OK正常应该秒出LOGIN_OK。如果这里卡住Cursor 那边大概率也会卡在 120 秒超时。3. 可复制配置SSH config、公钥免密与 Cursor 端参数这一节是全文最核心的部分配置片段都可以直接抄改掉主机名和 IP 即可。3.1 Windows 端 SSH config配置文件路径是C:\Users\用户名\.ssh\config没有就新建。写入Host kylin-pc HostName 192.168.1.10 User kylin Port 22 IdentityFile ~/.ssh/id_ed25519 ServerAliveInterval 30 ServerAliveCountMax 6ServerAliveInterval这两行是保活用的局域网里也建议加上避免长时间空闲被断开。写完先在本机测ssh kylin-pc能登进去说明基础链路没问题。3.2 生成密钥并配置免密仅用密码登录时Cursor 的管道加 Askpass 很容易触发「120 秒内远端无任何数据」的超时。配公钥之后稳定性会明显提升。在 PowerShell 里生成密钥推荐交互式passphrase 直接回车两次mkdir $env:USERPROFILE\.ssh -Force ssh-keygen -t ed25519 -f $env:USERPROFILE\.ssh\id_ed25519如果你在脚本里需要非交互空密码注意 PowerShell 会吃掉-N 得写成ssh-keygen -t ed25519 -f $env:USERPROFILE\.ssh\id_ed25519 -N 或者干脆用 cmd 传参cmd /c ssh-keygen -t ed25519 -f \%USERPROFILE%\.ssh\id_ed25519\ -N \\把公钥推到远端这一步需要输一次密码Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | ssh kylin192.168.1.10 mkdir -p ~/.ssh chmod 700 ~/.ssh cat ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys远端权限不对公钥会被忽略手动确认一遍chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys验证免密是否生效ssh -o BatchModeyes -T kylin192.168.1.10 echo OK只输出OK且不再提示密码就说明免密成功。3.3 Cursor 端连接参数打开 Cursor先打开任意本地文件夹进入完整界面然后Ctrl Shift P搜Remote-SSH: Connect to Host...选择kylin-pc。如果连接超时可以在设置里把remote.SSH.connectTimeout调大比如 300。扩展方面Cursor 用的是 Anysphere Remote SSH扩展 ID 是anysphere.remote-ssh。不要和微软的ms-vscode-remote.remote-ssh同时启用否则会出现command ... not found之类的冲突。已经装了微软版的话在 Cursor 里禁用或卸载。3.4 把模型通道统一到 TaoTokenSSH 通了之后在 Cursor 的模型设置里填 TaoToken 的配置。三件套是 Base URL、API Key、Model ID{ baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: claude-sonnet-4-5 }Base URL 用https://taotoken.net/api不要加 UTM 参数。Key 从前面给的 API Keys 页面拿。Model ID 按你实际要用的填。这样 Cursor 的对话和补全就走统一通道了跟 SSH 是两条独立的链路互不影响。4. 验证请求从 SSH 自检到模型调用成功配置写完必须验证不然你不知道问题出在哪一层。这一节给出一套从底到顶的验证命令。先测本机到远端的连通性ping -n 2 192.168.1.10再模拟 Cursor 的管道加登录 shell免密后再测cmd /c echo echo PIPE_OK exit 0| ssh -T kylin192.168.1.10 bash --login -c bash看到PIPE_OK说明管道和登录 shell 都正常。再带上动态转发更接近 Cursor 的真实行为cmd /c echo echo D_OK exit 0| ssh -T -D 19999 kylin192.168.1.10 bash --login -c bash如果这条卡住用-vvv看详细日志cmd /c echo echo D_OK exit 0| ssh -vvv -T -D 19999 kylin192.168.1.10 bash --login -c bash日志里重点看认证阶段和转发阶段有没有报错。SSH 层验证通过后在 Cursor 里连上远端打开一个远端目录在内置终端执行uname -a确认命令是在远端跑的。然后测试模型调用在 Cursor 对话框里问一个简单问题比如「用一句话解释什么是 SSH 隧道」。能正常返回说明 TaoToken 通道也通了。如果你想单独验证模型通道不依赖 Cursor可以用 curl 直接打curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复 OK}] }返回里有choices字段就说明通道正常。想直接在网页里试模型可以用模型对话入口 https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。5. 常见报错排查401、120s 超时、Download failed 逐个拆这一节对照真实报错讲排查思路每条都给判断依据和处理动作。5.1 SSH connection timed out after 120s without receiving any data含义是连接已发起但安装握手阶段长时间没有 Cursor 能识别的输出。按这个顺序排查先确认公钥免密是否成功用ssh -o BatchModeyes -T userhost echo OK测再确认bash --login -c echo LOGIN_OK是否立即返回然后看sshd -T里allowtcpforwarding是不是 yes最后清理远端~/.cursor-server和锁文件后重试。Cursor 设置里可以把remote.SSH.connectTimeout调到 300。5.2 Permission denied (publickey,password)配合BatchModeyes出现这个通常是没有可用公钥或者authorized_keys、.ssh权限不对。回到 3.2 节重新配一遍重点检查chmod 700 ~/.ssh和chmod 600 ~/.ssh/authorized_keys。5.3 401 与 local proxy failed这两个是模型通道的报错跟 SSH 无关。401 一般是 Key 填错或没带Bearer前缀检查 Cursor 设置里的 apiKey 是不是完整的sk-开头字符串。local proxy failed通常是 Base URL 写错确认是https://taotoken.net/api不要多写或少写路径。如果报错里出现reading choices说明请求发出去了但返回体解析失败多半是 Model ID 填了一个通道不支持的模型换一个再试。5.4 EBUSY: resource busy or locked删除临时.sh失败一般是ssh.exe还占着临时文件或者安全软件锁了%TEMP%。在 PowerShell 里结束进程Get-Process ssh -ErrorAction SilentlyContinue | Stop-Process -Force然后完全退出 Cursor 再重开。5.5 Download failed: Error downloading server日志里已经出现Configuring Cursor Server on Remote和 wget 进度然后报下载失败这说明 SSH 配置没问题是远端从公网拉 Cursor Server 压缩包约 99MB不稳定。优先等 Cursor 的本机回退跑完它会从 Windows 的%TEMP%下载再拷贝过去保持 Cursor 打开、用稳定网络即可。如果远端 wget 常连 IPv6 且易断可以在远端用 IPv4 测wget -4 -O /dev/null --timeout30 https://downloads.cursor.com/production/commit/linux/arm64/cursor-reh-linux-arm64.tar.gz重试前清理半成品rm -rf ~/.cursor-server rm -f /tmp/cursor-server-*.tar.gz rm -f /run/user/$(id -u)/cursor-remote-lock.* 2/dev/null5.6 清理远端 Cursor Server连接反复失败时在远端执行pkill -f cursor-server 2/dev/null || true rm -rf ~/.cursor-server rm -f /tmp/cursor-remote-lock.* 2/dev/null rm -f /run/user/$(id -u)/cursor-remote-lock.* 2/dev/null删的是远端自动安装的 Cursor Server不会动 Windows 上的客户端下次连接会重新装。6. 长期远程编码怎么配Coding Plan 与接入文档入口如果你只是偶尔连一下远端上面这套配置够用了。但如果你是长期在麒麟服务器上做开发每天都要远程编码、跑 Agent 任务那建议把模型通道也规划好别每次临时填 Key。长期编码场景下Coding Plan 更适合它面向的是持续性的编码和 Agent 调用入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。配置方式跟前面 3.4 节一样Base URL 和 Key 换成 Plan 对应的即可。接入细节和参数说明都在文档里遇到不确定的字段先查文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。控制台入口在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 可以在这里管理 Key 和查看用量。最后给一个验收清单连完之后逐条对一遍本机ssh能登录目标用户和主机ssh -o BatchModeyes -T userhost echo OK成功远端bash --login -c echo LOGIN_OK立即成功sudo sshd -T显示allowtcpforwarding yesCursor 只用 Anysphere Remote SSH没有微软版冲突Connect to Host 后能打开远端目录内置终端在远端执行命令正常模型对话能正常返回。这套流程我在麒麟 V10 和 Ubuntu 上都跑过最容易翻车的其实是登录脚本阻塞和公钥权限这两处把这两块盯住剩下的基本都是网络问题。