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

相关推荐
不想迷路的小男孩23 分钟前
Android Studio 中Palette跟Component Tree面板消失怎么恢复正常
android·ide·android studio
AlickLbc1 小时前
在phpstudy环境下配置搭建XDEBUG配合PHPSTORM的调试环境
ide·phpstorm
悠悠小茉莉1 小时前
Win11 安装 Visual Studio(保姆教程 - 更新至2025.07)
c++·ide·vscode·python·visualstudio·visual studio
yanjiee2 小时前
需要scl来指定编译器的clangd+cmake在vscode/cursor开发环境下的配置
ide·vscode·编辑器
Charlene Fung7 小时前
vs code远程自动登录服务器,无需手动输入密码的终极方案(windows版)
运维·服务器·vscode·ssh
旷世奇才李先生7 小时前
PyCharm 安装使用教程
ide·python·pycharm
奇文怪式8 小时前
VSCode+arm-none-eabi-gcc交叉编译+CMake构建+OpenOCD(基于Raspberry Pico RP2040)
arm开发·ide·vscode·rp2040
hero_heart16 小时前
vscode中c_cpp_properities.cpp文件生成和作用
ide·vscode·编辑器
Naiva17 小时前
【小技巧】Python+PyCharm IDE 配置解释器出错,环境配置不完整或不兼容。(小智AI、MCP、聚合数据、实时新闻查询、NBA赛事查询)
ide·python·pycharm