当前位置：首页 > news >正文

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

news 2025/7/4 7:45:48

详细步骤
第 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 桌面应用。 2. 使用浏览器完成 GitHub 授权。 3. 在 Cursor 中使用 cursor:// 链接连接到服务器。
远程服务器 (Remote Server) 1. 通过 SSH 登录。 2. 下载并解压 cursor CLI 工具。 3. 运行 ./cursor tunnel 命令启动隧道。 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。它们是不兼容的。