关于使用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。它们是不兼容的。

相关推荐
战南诚18 小时前
前端开发vscode插件 - live server
ide·vscode·编辑器
墨抒颖 msy.plus20 小时前
[特殊字符] 从零到一:打造你的VSCode圈复杂度分析插件
ide·vscode·编辑器·插件·cursor
北冥有鱼被烹1 天前
【微知】vscode如何开启markdown的review模式?
ide·vscode·编辑器
携欢1 天前
CodeQL(Mac)安装与测试(Visual Studio)简明指南
ide·vscode·macos
Android小码家2 天前
Vscode + docker + qt 网络监听小工具
vscode·qt·docker
中国胖子风清扬2 天前
Rust 序列化技术全解析:从基础到实战
开发语言·c++·spring boot·vscode·后端·中间件·rust
susu10830189112 天前
如何选择文件夹然后用vscode直接打开
ide·vscode·编辑器
非得登录才能看吗?2 天前
开发环境 之 编辑器、编译器、IDE梳理
ide·编辑器
艾莉丝努力练剑2 天前
GCC编译器深度解剖:从源码到可执行文件的全面探索
c++·ide·经验分享·gcc
熊猫钓鱼>_>2 天前
在VSCode中更新或安装最新版的npx和uv工具
ide·vscode·uv