指南

透過 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)。

  1. 開啟 PowerShell(點選開始,輸入 PowerShell 並開啟)。
  2. 執行下列指令。系統要求輸入密語(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。

  1. 顯示公開金鑰:
Get-Content $HOME\.ssh\bohemian_ed25519.pub

複製以 ssh-ed25519 開頭的整行內容。

  1. 以電子郵件將金鑰寄給我們。絕對不要寄出沒有 .pub 的檔案:那是您的私密金鑰,只能留在您自己的電腦上。

每次連線時您都需要輸入金鑰的密語。

2. 連線

ssh -i $HOME\.ssh\bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
  1. 第一次連線時,SSH 會顯示 Mac 的指紋(ED25519 key fingerprint is SHA256:…)並詢問 Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入 yes。若不相同,請輸入 no 並與我們聯絡。
  2. 看到以 % 結尾的一行,就表示已登入。輸入 exit 即可中斷連線。

Mac

1. 建立 SSH 金鑰

我們建議為 Bohemian Silicon 建立一把專用金鑰。下列指令會以專屬名稱儲存,不會覆寫您在其他地方使用的金鑰(例如 GitHub 用的 id_ed25519)。

  1. 開啟終端機(應用程式 → 工具程式 → 終端機)。
  2. 執行下列指令。系統要求輸入密語(passphrase)時,請輸入並再次確認(輸入時不會顯示任何字元)。密語可在他人複製檔案時保護金鑰。您也可以留空,但較不安全。
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

此指令會建立兩個檔案。bohemian_ed25519 是您的私密金鑰:它留在您的電腦上,絕不寄給任何人。bohemian_ed25519.pub 是公開金鑰:這是要寄給我們的。用一般電子郵件寄送很安全,因為單獨使用它無法登入。

想使用現有的金鑰?請將它的 .pub 檔寄給我們,並在下列指令中以它的檔名取代 bohemian_ed25519。

  1. 顯示公開金鑰:
pbcopy < ~/.ssh/bohemian_ed25519.pub

金鑰已在剪貼簿中,用 ⌘V 貼上即可。

  1. 以電子郵件將金鑰寄給我們。絕對不要寄出沒有 .pub 的檔案:那是您的私密金鑰,只能留在您自己的電腦上。

小技巧:若不想每次都輸入密語,可將它存入 macOS 鑰匙圈:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. 連線

ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
  1. 第一次連線時,SSH 會顯示 Mac 的指紋(ED25519 key fingerprint is SHA256:…)並詢問 Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入 yes。若不相同,請輸入 no 並與我們聯絡。
  2. 看到以 % 結尾的一行,就表示已登入。輸入 exit 即可中斷連線。

Linux

1. 建立 SSH 金鑰

我們建議為 Bohemian Silicon 建立一把專用金鑰。下列指令會以專屬名稱儲存,不會覆寫您在其他地方使用的金鑰(例如 GitHub 用的 id_ed25519)。

  1. 開啟終端機。
  2. 執行下列指令。系統要求輸入密語(passphrase)時,請輸入並再次確認(輸入時不會顯示任何字元)。密語可在他人複製檔案時保護金鑰。您也可以留空,但較不安全。
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

此指令會建立兩個檔案。bohemian_ed25519 是您的私密金鑰:它留在您的電腦上,絕不寄給任何人。bohemian_ed25519.pub 是公開金鑰:這是要寄給我們的。用一般電子郵件寄送很安全,因為單獨使用它無法登入。

想使用現有的金鑰?請將它的 .pub 檔寄給我們,並在下列指令中以它的檔名取代 bohemian_ed25519。

  1. 顯示公開金鑰:
cat ~/.ssh/bohemian_ed25519.pub

複製以 ssh-ed25519 開頭的整行內容。

  1. 以電子郵件將金鑰寄給我們。絕對不要寄出沒有 .pub 的檔案:那是您的私密金鑰,只能留在您自己的電腦上。

小技巧:大多數 Linux 桌面環境已在執行 SSH 代理程式,因此每次登入只需輸入一次密語:

ssh-add ~/.ssh/bohemian_ed25519

2. 連線

ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
  1. 第一次連線時,SSH 會顯示 Mac 的指紋(ED25519 key fingerprint is SHA256:…)並詢問 Are you sure you want to continue connecting?。請與我們郵件中的指紋比對。只有完全相同時才輸入 yes。若不相同,請輸入 no 並與我們聯絡。
  2. 看到以 % 結尾的一行,就表示已登入。輸入 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)

  1. 在 VS Code 中安裝 Microsoft 的 Remote - SSH 擴充功能。
  2. 按 F1,選擇 Remote-SSH: Add New SSH Host…,然後輸入此指令(Windows、Mac 和 Linux 皆相同):
ssh -i ~/.ssh/bohemian_ed25519 -p PORT 使用者名稱@gate.bohemiansilicon.com
  1. 將它儲存到建議的 SSH 設定檔。接著再按一次 F1,選擇 Remote-SSH: Connect to Host…,並選取 Mac 的位址。若詢問平台,請選擇 macOS。
  2. 首次連線時,VS Code 會在您 Mac 上的帳號中安裝其伺服器元件,約需一到兩分鐘。之後您就能直接在 VS Code 中開啟 Mac 上的資料夾並使用其終端機。

疑難排解

租期結束時

租期結束時,我們會刪除你的 macOS 帳號及其主檔案夾,並清除你在共用暫存檔案夾(/tmp、/Users/Shared)中的檔案。請在租期結束前下載所有需要保留的內容。之後你也可以從自己的電腦刪除金鑰:.ssh 檔案夾中的 bohemian_ed25519 和 bohemian_ed25519.pub。

遇到問題?請寫信至 hello@bohemiansilicon.com,並附上螢幕截圖或錯誤訊息。我們通常會在幾分鐘內回覆。

← 所有指南