詳細步驟
第 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。它們是不兼容的。