跳到內容
Octoboard 說明文件

Linux 伺服器

不需要 root 權限,就能在 Linux 伺服器上安裝 octoboardd(Octoboard 的伺服器程式,應用程式裡稱它為「背景服務」)。可從 macOS 或 Windows 應用程式連線,也可在瀏覽器中開啟,兩種方式都經由 SSH。

支援 x86_64 和 aarch64,不限發行版。

  • 一台能用 SSH 登入的 Linux 伺服器。SSH 是一種安全登入另一台機器、並在上面輸入指令的方式。伺服器的位址和你的使用者名稱由伺服器供應商提供。
  • 你自己電腦上的 Octoboard 應用程式(macOS 或 Windows 版),如果你想在桌面應用程式裡工作(建議)。

登入方法:在自己的電腦上開啟「終端機」(macOS)或 PowerShell(Windows),執行下面的指令,把 <you> 換成你的使用者名稱,把 <server> 換成伺服器位址。第一次連線時,它會詢問是否信任這台伺服器,請輸入 yes。

Terminal window
ssh <you>@<server>

下面的第 1、2 步都在伺服器上執行,也就是在這個已登入的視窗裡。

  1. 在伺服器上安裝 octoboardd。

    Terminal window
    curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh

    輸出中會有一行以 Installed octoboardd 開頭。

  2. 在伺服器上啟動它。

    Terminal window
    octoboardd start

    輸出中會有一行以 Octoboard started 開頭。

  3. 從你自己的電腦連過去,有兩種方式:

    • 用桌面應用程式(建議):依照 SSH 指南中的連線到 Linux 伺服器操作。

    • 用瀏覽器:在伺服器上執行這個指令。

      Terminal window
      octoboardd address

      它會輸出兩樣東西:一個以 http://127.0.0.1: 開頭的瀏覽器位址,以及一個 ssh 指令。在自己的電腦上複製這個 ssh 指令,把 <server> 換成伺服器位址(就是你登入它時用的 IP 位址或名稱),然後在「終端機」或 PowerShell 中執行。它可能會要求輸入密碼,之後就不再顯示任何內容,這是正常的。請不要關閉這個視窗,關閉後連線就會中斷。接著在瀏覽器中開啟輸出的位址。

看到 Octoboard 在桌面應用程式的新視窗或瀏覽器分頁中開啟,就表示成功了。

如果安裝時提示以 .local/bin 結尾的目錄(例如 /home/<you>/.local/bin)不在 PATH 中,表示 shell 無法直接依名稱找到 octoboardd。請用安裝時輸出的完整路徑執行它,或把 ~/.local/bin 加入 PATH(例如寫進 ~/.profile),再重新登入。

用 octoboardd start 啟動的 octoboardd 會在伺服器重新開機時停止,之後也不會自動啟動:需要再執行一次 octoboardd start,或直接從桌面應用程式連線,應用程式會提示你啟動它。有些伺服器在你登出時也會讓它停止。

如果想讓它隨伺服器啟動、登出後也繼續執行,請改為安裝成服務:

Terminal window
curl --proto '=https' --tlsv1.2 -fsSL https://octoboard.dev/install.sh | sh -s -- --service

這個指令會安裝程式,把它設定為 systemd 使用者服務並啟動,然後開啟 lingering,讓你的服務在你未登入時也能執行。如果它提示無法開啟,請執行一次下面的指令(可能需要 sudo):

Terminal window
loginctl enable-linger "$USER"

預設連接埠為 3369。要改用其他連接埠,請在服務指令或 octoboardd start 的結尾加上 --port <port>。

Octoboard 不會自己悄悄升級:有新版本時,瀏覽器會提示你,由你決定什麼時候安裝。新版本安裝好後,如果重新啟動不會中斷任何工作階段,Octoboard 會自動重新啟動並換上新版本;如果會中斷某些工作階段,它會先列出來詢問你。

  • 在瀏覽器裡:在新版本提示處點選下載並安裝。

  • 在伺服器上:執行這個指令。

    Terminal window
    octoboardd update

    如果它詢問是否立即重新啟動,輸入 y 重新啟動;直接按 Enter 則暫時繼續執行舊版本,之後想重新啟動時再執行 octoboardd restart。

如果 octoboardd update 提示無法取代程式(例如程式裝在你沒有寫入權限的位置),請改為再次執行安裝指令(或服務指令)。它同樣會在安全時自動重新啟動,否則會提示你執行 octoboardd restart。

x86_64 壓縮檔 aarch64 壓縮檔 所有歷史版本