透過 SSH 連線
透過 SSH,在這台電腦的桌面應用程式或瀏覽器中使用 Linux 伺服器或另一台電腦上的 Octoboard。SSH 會在兩台裝置之間建立加密的直接連線,不需要中繼或雲端服務。
不確定該用哪種方式?選擇連線方式比較了這種方式,以及不需要 SSH、只用瀏覽器的幾種方式。
這台電腦上的桌面應用程式 · 透過 SSH 轉送存取的瀏覽器 ⟷ SSH ⟷ Linux 伺服器或另一台電腦
新手須知
- 主機:執行 Octoboard、你要連過去的那台機器,可以是 Linux 伺服器,也可以是另一台 Mac 或 Windows 電腦。
- 伺服器:這裡指透過網路登入的 Linux 機器,通常是租來的,沒有自己的螢幕。
- SSH:一種通用的加密方式,用來登入另一台機器並在上面輸入指令。macOS、Windows 和 Linux 都內建。
- 終端機:輸入指令的視窗,macOS 上是「終端機」,Windows 上是 PowerShell。
- SSH 轉送:一個 SSH 指令,讓主機上的東西出現在你自己的電腦上,瀏覽器就能在本機開啟它。
- 指紋(主機金鑰):標識一台機器 SSH 身分的一串短碼。核對一次,就能確認連上的是正確的機器。
- 金鑰檔案:代替密碼登入用的檔案。有些伺服器供應商會給你一個。
-
能用 SSH 登入主機。如果主機是 Linux 伺服器,位址和使用者名稱由伺服器供應商提供。可以先試試看:開啟「終端機」(macOS)或 PowerShell(Windows),用你的使用者名稱和伺服器位址執行下面的指令。第一次連線時,它會詢問是否信任這台伺服器,請輸入
yes。Terminal window ssh <you>@<server>如果主機是 Mac 或 Windows 電腦,需要在它的系統設定裡開啟 SSH 登入,方法見用另一台電腦當作主機。
-
如果主機是 Linux 伺服器,需要先在上面安裝並啟動 Octoboard。方法見安裝 › Linux 伺服器。Octoboard 的伺服器程式 octoboardd,應用程式裡稱為「背景服務」。
-
這台電腦上的 Octoboard 應用程式(macOS 或 Windows 版)。只用瀏覽器的話可以不裝。
連線到 Linux 伺服器
Section titled “連線到 Linux 伺服器”-
用執行 Octoboard 的帳號透過 SSH 登入伺服器,執行這個指令,複製以
octoboard+ssh://開頭的那一行。這就是連線資訊,桌面應用程式靠它知道要連到哪裡、怎麼連。Terminal window octoboardd connection如果這台電腦連到伺服器時用的是另一個位址或 SSH 連接埠,請在指令裡加上
--host或--ssh-port,以產生正確的連線資訊。它同時輸出的 QR 圖碼包含同樣的一行文字,目前還沒有應用程式支援掃描。
-
在這台電腦的 Octoboard 應用程式中,點選左側欄的遠端裝置,或在 macOS 選單列中選擇遠端連線 › 遠端裝置。在 Windows 上,也可以從視窗的系統選單或工作列圖示的跳躍清單中選擇遠端裝置。
-
點選加入遠端背景服務,再點選連線資訊旁的貼上,自動填好各個欄位。
-
在驗證方式中,如果你用帳號密碼登入,請選密碼;如果伺服器供應商給的是金鑰檔案(檔名常像
id_ed25519,或以.pem結尾),請選金鑰檔案,並填入它在這台電腦上的位置。 -
點選儲存,再點選連線。如果要求輸入密碼,請輸入。
如果你貼上了連線資訊,其中已經帶有伺服器的身分(指紋),應用程式會替你核對。如果你是手動填入位址,第一次連線時應用程式會顯示一個指紋。為了確認連上的是正確的機器,請把它和在伺服器上執行下面這個指令得到的指紋比對,一致時再連線:
Terminal window ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
看到一個獨立的 Octoboard 視窗開啟,顯示伺服器上的專案和工作階段,就表示成功了。
用另一台電腦當作主機
Section titled “用另一台電腦當作主機”你也可以連到另一台執行 Octoboard 應用程式的 Mac 或 Windows 電腦。
- 在你要連過去的電腦上,開啟 Octoboard 的設定 › 遠端存取。
- 點選那裡的開啟系統設定(macOS)或開啟設定(Windows),依照該列提供的路徑開啟遠端登入(macOS)或 OpenSSH Server(Windows),讓這台電腦接受 SSH 登入。這一步需要系統管理員權限。回到 Octoboard,該列會顯示已開啟。
- 開啟允許遠端存取,點選允許確認,並讓 Octoboard 保持執行,結束後遠端存取也會隨之中斷。
- 在 Octoboard App 分頁點選複製連線資訊,再透過電子郵件或聊天工具傳到另一台電腦。
- 在你要用來工作的電腦上,依照連線到 Linux 伺服器的第 2 到 5 步加入這台主機,貼上你傳過去的資訊。用主機上的使用者名稱和密碼登入。
看到一個獨立的視窗開啟,顯示主機上的專案和工作階段,就表示成功了。
從瀏覽器連線
Section titled “從瀏覽器連線”-
取得 SSH 轉送指令:
-
主機是 Mac 或 Windows 電腦時,先完成用另一台電腦當作主機的第 1 到 3 步。然後在瀏覽器分頁找到步驟 1:SSH 轉送。點選指令中的位址,選擇另一台電腦連到這台電腦時所用的位址(或選擇自行輸入位址,稍後自己取代
<server>),然後點選複製轉送指令。再在步驟 2:瀏覽器位址處點選複製位址。 -
主機是 Linux 伺服器時,在伺服器上執行這個指令。它會先輸出瀏覽器位址,再輸出要執行的 SSH 指令。
Terminal window octoboardd address把指令中的
<server>換成伺服器位址。
-
-
在用來瀏覽的電腦上,開啟「終端機」(macOS)或 PowerShell(Windows),執行這個 SSH 指令。視窗可能會要求輸入密碼,之後就不再顯示任何內容,這是正常的。使用期間請不要關閉它,關閉後瀏覽器的連線就會中斷。
-
在瀏覽器中開啟以
http://127.0.0.1:開頭的瀏覽器位址。
看到 Octoboard 在瀏覽器分頁中開啟,而且沒有要求你登入,就表示成功了。
只有能透過 SSH 轉送連到 Octoboard 的人才能使用這個位址。請妥善保管它:位址裡的金鑰可以完全控制 Octoboard,它會留在瀏覽器的瀏覽紀錄和書籤裡,開啟同步後還會同步到你的其他裝置。
- 提示「無法連線到伺服器」,或 SSH 指令提示「Connection refused」、逾時:主機上的 SSH 登入沒有開啟,或位址、SSH 連接埠不對。請確認遠端登入或 OpenSSH Server 已開啟,並且能用上面的
ssh指令登入。 - 提示「無法登入」或「Permission denied」:使用者名稱、密碼或金鑰檔案不對。
- 提示「主機金鑰不相符」:回應的機器不是你之前連過的那台。伺服器重新安裝後會這樣,但也可能是出了問題。在弄清楚原因之前請不要繼續。
- 瀏覽器頁面打不開:SSH 視窗被關掉了,或其中的指令已停止。請重新執行它,再重新整理頁面。
- 不額外開放連接埠:Octoboard 只接受來自主機本機的連線,所以要從另一台電腦連線,需要先透過 SSH 登入主機。這就是為什麼需要 SSH,或某種第三方中繼。
- 核對主機身分:第一次成功連線後,應用程式會記住主機的身分標識(主機金鑰),之後標識改變時就拒絕連線並提醒你。
- 不儲存密碼:第一次用密碼或自己的金鑰檔案登入後,應用程式會為這台電腦設定一把專用的 SSH 金鑰,供之後登入使用。
- 隨時收回權限:在主機允許登入的 SSH 金鑰清單中(Linux 和 macOS 上是
~/.ssh/authorized_keys檔案)刪除這台電腦對應的那一行,這把金鑰就不能再登入了;已經建立的連線不受影響,直到它自行中斷。
在遠端視窗中工作
Section titled “在遠端視窗中工作”- 每個 SSH 連線目標一個視窗:使用者名稱、主機或 SSH 連接埠不同的連線,各自開啟獨立的視窗,專案、工作階段和通知互不混雜。
- 一眼看到連線狀態:點開 macOS 選單列或 Windows 通知區域裡的應用程式圖示,每個連線都有自己的分頁。
- 遠端網頁在本機開啟:代理程式在主機上啟動網站後,點選它提供的
localhost連結,應用程式會經由 SSH 在這台電腦上開啟該網站。 - 遠端檔案在本機開啟:你可以在遠端視窗中直接查看檔案,也可以下載一份副本,用這台電腦的預設應用程式開啟。
- 斷線自動重新連線:網路中斷後,視窗會持續嘗試重新連線,直到連上或你關閉視窗為止。