关于使用cursor tunnel链接vscode(避免1006 issue的做法)

详细步骤

第 1 步:在你的本地机器上准备好 Cursor

这一步很简单,你可能已经完成了。只需确保你的本地电脑上已经安装了 Cursor 桌面应用程序。

要做的事:无,只需确保 Cursor 已安装。

第 2 步:在远程服务器上安装 Cursor CLI 隧道工具

这是最关键的一步。你需要在远程服务器上下载并运行那个特殊的 cursor 命令行工具。

登录到你的远程服务器

打开你本地电脑的终端(Terminal、PowerShell 或其他 SSH 客户端),通过 SSH 登录到你的服务器。

Generated bash

ssh your_username@your_server_ip

Use code with caution.

Bash

确定服务器的 CPU 架构

你需要知道你的服务器是 x64 还是 ARM64 架构,以便下载正确的工具。在服务器上运行以下命令:

Generated bash

uname -m

Use code with caution.

Bash

如果输出是 x86_64 或 amd64,那么你的服务器是 x64 架构。

如果输出是 aarch64 或 arm64,那么你的服务器是 ARM 架构。

下载对应的 Cursor CLI 工具

根据上一步的结果,在服务器上使用 wget 或 curl 命令下载文件。

如果你的服务器是 x64 架构:

Generated bash

wget -O cursor-cli.tar.gz "https://api2.cursor.sh/updates/download-latest?os=cli-alpine-x64"

Use code with caution.

Bash

如果你的服务器是 ARM 架构:

Generated bash

wget -O cursor-cli.tar.gz "https://api2.cursor.sh/updates/download-latest?os=cli-alpine-arm64"

Use code with caution.

Bash

提示: wget -O 参数可以让你在下载的同时给文件重命名,这里我们把它命名为 cursor-cli.tar.gz,方便后续操作。

解压文件

下载完成后,你会得到一个 cursor-cli.tar.gz 的压缩包。使用 tar 命令解压它:

Generated bash

tar -xvf cursor-cli.tar.gz

Use code with caution.

Bash

解压后,你应该会看到一个名为 cursor 的可执行文件。

(可选,但推荐)授予执行权限

为了确保你能运行这个文件,最好给它加上执行权限:

Generated bash

chmod +x ./cursor

Use code with caution.

Bash

第 3 步:启动隧道并进行身份验证

现在,一切准备就绪,可以启动隧道了。

运行隧道命令

在远程服务器上,运行刚刚解压出来的 cursor 文件:

Generated bash

./cursor tunnel

Use code with caution.

Bash

在浏览器中授权

运行命令后,你的服务器终端会显示类似下面的信息:

Generated code

To grant access to the server, please log into GitHub and paste the following code:

XXXXXXXXX

Then press ENTER.

Use code with caution.

复制终端里显示的 XXXXXXXXX 这串设备代码 (device code)。

在你本地电脑的浏览器中,打开 GitHub 设备授权页面:https://github.com/login/device

将刚刚复制的代码粘贴进去,然后按照提示授权。

返回服务器终端

在浏览器中成功授权后,回到你远程服务器的 SSH 终端,按 Enter 键。

获取连接链接

如果一切顺利,隧道就会成功建立!服务器终端会显示隧道的名称,并给你一个特殊的链接,格式如下:

Generated code

Connected to tunnel: fluffy-computational-machine

You can now connect to this tunnel from a local Cursor instance.

Open this link in your browser: cursor://remote-connect/tunnel/fluffy-computational-machine/path/to/your/project

Use code with caution.

这个 cursor://... 链接就是连接隧道的钥匙。

第 4 步:在本地 Cursor 中连接到远程服务器

现在回到你的本地电脑。

复制 cursor:// 链接

从服务器终端中完整地复制那条 cursor://... 链接。

在 Cursor 中连接

打开你本地的 Cursor 应用,有两种方法连接:

方法一(推荐):

按下 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板。

输入 Connect to Tunnel (或中文 连接到隧道),然后选择该命令。

将刚刚复制的 cursor:// 链接粘贴进去,然后按 Enter。

方法二:

在本地电脑上打开一个终端或运行窗口。

直接粘贴并执行 cursor:// 链接(在某些系统上,这会自动调用 Cursor 打开它)。

连接成功

稍等片刻,Cursor 就会打开一个新的窗口,窗口里的文件和终端就是你远程服务器上的环境了!你可以像操作本地项目一样开始工作了。

总结与回顾

操作位置 需要做什么

本地电脑 (Local Machine) 1. 确保已安装 Cursor 桌面应用。<br>2. 使用浏览器完成 GitHub 授权。<br>3. 在 Cursor 中使用 cursor:// 链接连接到服务器。

远程服务器 (Remote Server) 1. 通过 SSH 登录。<br>2. 下载并解压 cursor CLI 工具。<br>3. 运行 ./cursor tunnel 命令启动隧道。<br>4. 复制生成的 cursor:// 链接。

常见问题 (FAQ)

我想让隧道在后台一直运行,即使我关闭了 SSH 窗口怎么办?

你可以使用 tmux 或 screen 这样的工具。或者一个更简单的方法是使用 nohup:

Generated bash

nohup ./cursor tunnel &

Use code with caution.

Bash

这样隧道就会在后台持续运行,并将日志输出到当前目录下的 nohup.out 文件中。

连接失败或提示不兼容怎么办?

请确保你严格按照上述步骤,使用的是从 api2.cursor.sh 下载的专用 cursor CLI,而不是 VS Code 官方的 code CLI。它们是不兼容的。

相关推荐
Kiri霧9 小时前
IntelliJ IDEA
java·ide·kotlin·intellij-idea
晨风先生11 小时前
如何Visual Studio 的配置从 Qt-Debug 切换到 x64-Debug
ide·qt·visual studio
要加油哦~14 小时前
工具 | 解决 VSCode 中的 Delete CR 问题
ide·vscode·编辑器
未来之窗软件服务17 小时前
基于 Nginx 与未来之窗防火墙构建下一代自建动态网络防护体系—仙盟创梦IDE
网络·ide·nginx·服务器安全·仙盟创梦ide·东方仙盟
yao0003719 小时前
Claude 4.0 终极编程指南:模型对比、API配置与IDE集成实战
ide·ai编程
我有一只肥螳螂19 小时前
idea监控本地堆栈
java·ide·intellij-idea
界面开发小八哥1 天前
通用CI/CD软件平台TeamCity v2025.3全新发布——主要界面交互体验升级
ide·ci/cd·开发平台·teamcity
张乔241 天前
mybatisX的自定义模板生成
java·ide·intellij-idea
taoismimortal1 天前
vscode目录,右键菜单加入用VSCode打开文件和文件夹(快速解决)(含删除)(脚本)
ide·vscode·编辑器
猫咪的白手套1 天前
解决VSCode中“#include错误,请更新includePath“问题
ide·vscode·编辑器