指南
透過 SSH 連線
從 Windows、Mac 或 Linux 透過終端機存取租用的 Mac:SSH 金鑰、首次登入、檔案傳輸、tmux 和 VS Code。不需要額外軟體。
你透過我們的閘道 gate.bohemiansilicon.com,用一般的 SSH 連線到租用的 Mac,不需要安裝其他軟體,也不需要設定網路。整個設定約需 10 分鐘,而且每次租用的第一個小時免費,你可以從容完成準備。
在我們寄出的登入資訊郵件中,你會收到使用者名稱、連接埠號碼(形如 2201)、Mac 的指紋,以及遠端桌面用的密碼。本指南中出現 使用者名稱 和 PORT 的地方,請換成郵件裡的資訊。
使用 SSH 時,你只需要把SSH 公鑰寄給我們。SSH 已停用密碼登入,只能用金鑰登入。
Windows
Windows 10 和 11 已內建 SSH 用戶端,不需要另外安裝。
1. 建立 SSH 金鑰
我們建議為 Bohemian Silicon 建立一把專用金鑰。下列指令會以專屬名稱儲存,不會覆寫您在其他地方使用的金鑰(例如 GitHub 用的 id_ed25519)。
- 開啟 PowerShell(點選開始,輸入
PowerShell並開啟)。 - 執行下列指令。系統要求輸入密語(passphrase)時,請輸入並再次確認(輸入時不會顯示任何字元)。密語可在他人複製檔案時保護金鑰。您也可以留空,但較不安全。
mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon
此指令會建立兩個檔案。bohemian_ed25519 是您的私密金鑰:它留在您的電腦上,絕不寄給任何人。bohemian_ed25519.pub 是公開金鑰:這是要寄給我們的。用一般電子郵件寄送很安全,因為單獨使用它無法登入。
想使用現有的金鑰?請將它的 .pub 檔寄給我們,並在下列指令中以它的檔名取代 bohemian_ed25519。
- 顯示公開金鑰:
Get-Content $HOME\.ssh\bohemian_ed25519.pub
複製以 ssh-ed25519 開頭的整行內容。
- 以電子郵件將金鑰寄給我們。絕對不要寄出沒有
.pub的檔案:那是您的私密金鑰,只能留在您自己的電腦上。
每次連線時您都需要輸入金鑰的密語。
2. 連線
ssh -i $HOME\.ssh\bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
- 第一次連線時,SSH 會顯示 Mac 的指紋(
ED25519 key fingerprint is SHA256:…)並詢問Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入yes。若不相同,請輸入no並與我們聯絡。 - 看到以
%結尾的一行,就表示已登入。輸入exit即可中斷連線。
Mac
1. 建立 SSH 金鑰
我們建議為 Bohemian Silicon 建立一把專用金鑰。下列指令會以專屬名稱儲存,不會覆寫您在其他地方使用的金鑰(例如 GitHub 用的 id_ed25519)。
- 開啟終端機(應用程式 → 工具程式 → 終端機)。
- 執行下列指令。系統要求輸入密語(passphrase)時,請輸入並再次確認(輸入時不會顯示任何字元)。密語可在他人複製檔案時保護金鑰。您也可以留空,但較不安全。
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon
此指令會建立兩個檔案。bohemian_ed25519 是您的私密金鑰:它留在您的電腦上,絕不寄給任何人。bohemian_ed25519.pub 是公開金鑰:這是要寄給我們的。用一般電子郵件寄送很安全,因為單獨使用它無法登入。
想使用現有的金鑰?請將它的 .pub 檔寄給我們,並在下列指令中以它的檔名取代 bohemian_ed25519。
- 顯示公開金鑰:
pbcopy < ~/.ssh/bohemian_ed25519.pub
金鑰已在剪貼簿中,用 ⌘V 貼上即可。
- 以電子郵件將金鑰寄給我們。絕對不要寄出沒有
.pub的檔案:那是您的私密金鑰,只能留在您自己的電腦上。
小技巧:若不想每次都輸入密語,可將它存入 macOS 鑰匙圈:
ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519
2. 連線
ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
- 第一次連線時,SSH 會顯示 Mac 的指紋(
ED25519 key fingerprint is SHA256:…)並詢問Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入yes。若不相同,請輸入no並與我們聯絡。 - 看到以
%結尾的一行,就表示已登入。輸入exit即可中斷連線。
Linux
1. 建立 SSH 金鑰
我們建議為 Bohemian Silicon 建立一把專用金鑰。下列指令會以專屬名稱儲存,不會覆寫您在其他地方使用的金鑰(例如 GitHub 用的 id_ed25519)。
- 開啟終端機。
- 執行下列指令。系統要求輸入密語(passphrase)時,請輸入並再次確認(輸入時不會顯示任何字元)。密語可在他人複製檔案時保護金鑰。您也可以留空,但較不安全。
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon
此指令會建立兩個檔案。bohemian_ed25519 是您的私密金鑰:它留在您的電腦上,絕不寄給任何人。bohemian_ed25519.pub 是公開金鑰:這是要寄給我們的。用一般電子郵件寄送很安全,因為單獨使用它無法登入。
想使用現有的金鑰?請將它的 .pub 檔寄給我們,並在下列指令中以它的檔名取代 bohemian_ed25519。
- 顯示公開金鑰:
cat ~/.ssh/bohemian_ed25519.pub
複製以 ssh-ed25519 開頭的整行內容。
- 以電子郵件將金鑰寄給我們。絕對不要寄出沒有
.pub的檔案:那是您的私密金鑰,只能留在您自己的電腦上。
小技巧:大多數 Linux 桌面環境已在執行 SSH 代理程式,因此每次登入只需輸入一次密語:
ssh-add ~/.ssh/bohemian_ed25519
2. 連線
ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
- 第一次連線時,SSH 會顯示 Mac 的指紋(
ED25519 key fingerprint is SHA256:…)並詢問Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入yes。若不相同,請輸入no並與我們聯絡。 - 看到以
%結尾的一行,就表示已登入。輸入exit即可中斷連線。
傳輸檔案
請在您自己的電腦上執行 scp,而不是在租用的 Mac 上。
Windows
scp -i $HOME\.ssh\bohemian_ed25519 -P PORT data.zip 使用者名稱@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P PORT 使用者名稱@gate.bohemiansilicon.com:~/results.zip .
Mac, Linux
scp -i ~/.ssh/bohemian_ed25519 -P PORT data.zip 使用者名稱@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P PORT 使用者名稱@gate.bohemiansilicon.com:~/results.zip .
第一行將檔案上傳到租用的 Mac,第二行將檔案下載到目前的資料夾。加上 -r 可複製整個資料夾。
長時間執行的工作(tmux)
關閉終端機或連線中斷時,在其中啟動的程式也會停止。請在 tmux 中執行下載模型或訓練等長時間工作:即使中斷連線,工作階段仍會在 Mac 上繼續執行。登入 Mac 後,啟動一個工作階段:
tmux new -s work
在其中啟動您的工作。若要讓它繼續執行並中斷連線,請按 Ctrl+B,放開兩個鍵後再按 D。重新連線後,用下列指令回到工作階段:
tmux attach -t work
tmux ls 會列出您的工作階段;在工作階段中輸入 exit 即可結束。所有工作階段最晚會在租期結束、您的帳號被刪除時結束。
Visual Studio Code(Remote-SSH)
- 在 VS Code 中安裝 Microsoft 的 Remote - SSH 擴充功能。
- 按 F1,選擇 Remote-SSH: Add New SSH Host…,然後輸入此指令(Windows、Mac 和 Linux 皆相同):
ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
- 將它儲存到建議的 SSH 設定檔。接著再按一次 F1,選擇 Remote-SSH: Connect to Host…,並選取 Mac 的位址。若詢問平台,請選擇 macOS。
- 首次連線時,VS Code 會在您 Mac 上的帳號中安裝其伺服器元件,約需一到兩分鐘。之後您就能直接在 VS Code 中開啟 Mac 上的資料夾並使用其終端機。
疑難排解
- 連線逾時或遭拒:請檢查位址
gate.bohemiansilicon.com以及-p後面的連接埠號碼。部分公司或飯店網路會封鎖連往不常見連接埠的連線;請換個網路(例如手機熱點)再試,或與我們聯絡。 Permission denied (publickey)或要求輸入密碼:表示沒有使用到您的金鑰。請從建立金鑰的那台電腦連線,加上-i和金鑰路徑,並檢查使用者名稱。REMOTE HOST IDENTIFICATION HAS CHANGED:請停止,不要連線。先寫信給我們。我們會告訴您 Mac 是否重新安裝過,並寄給您新的指紋。確認後才執行ssh-keygen -R "[gate.bohemiansilicon.com]:PORT",再重新連線並核對新的指紋。
租期結束時
租期結束時,我們會刪除你的 macOS 帳號及其主檔案夾,並清除你在共用暫存檔案夾(/tmp、/Users/Shared)中的檔案。請在租期結束前下載所有需要保留的內容。之後你也可以從自己的電腦刪除金鑰:.ssh 檔案夾中的 bohemian_ed25519 和 bohemian_ed25519.pub。
遇到問題?請寫信至 hello@bohemiansilicon.com,並附上螢幕截圖或錯誤訊息。我們通常會在幾分鐘內回覆。