如何使用 Opengist 建立您自己的 GitHub Gist

如何使用 Opengist 建立您自己的 GitHub Gist
顯示電腦程式碼的監視器螢幕照片。

Opengist 是一個適用於 Linux 的輕量級、自架的 Github Gist 伺服器。與其他解決方案不同,它利用 Git 特定的功能來快速上傳、瀏覽和修改文字檔案。在這裡,我們向您展示如何在 Ubuntu Linux 上安裝和託管您自己的 Opengist 伺服器。

為什麼要使用 Opengist 來託管您自己的 Gist 伺服器

Opengist的最大賣點之一是它是一個類似 Pastebin 的服務,使用 Git 作為後端。這使得 Opengist 可以輕鬆地在 Linux 上使用並託管在 Linux 上,對於已經熟悉具有 Gist 支援(例如 Github 和 Gitlab)的類似 Git 服務的人來說。

Opengist 的另一個優點是它可以追蹤使用者特定的貼上並提供控制項來管理貼上可見性。

Opengist 實例中可用的所有要點的螢幕截圖。

最後,Opengist 不需要運行開銷。它的預設配置僅依賴單一 Docker 容器和資料存儲,您可以將其設定為內部磁碟區或綁定掛載到檔案系統。這意味著您甚至可以在低階系統上執行 Opengist,而無需大量空閒資源。

為 Opengist 準備系統

假設:本教學是在至少 2 GB RAM 和 25 GB 磁碟空間的 Ubuntu 24.04 VPS 上完成的。它還假設您目前擁有一個域名,並且可以向​​其添加“A”DNS 記錄。

將 Opengist 部署到您的電腦的第一步是取得並安裝 Docker、Nginx 和 Certbot。為此,首先取得 Docker 專案的簽署金鑰:

在「/etc/apt/sources.list.d/」下建立一個新的儲存庫檔案:

將以下程式碼行貼到新儲存庫檔案中:

儲存您的儲存庫文件,然後更新並升級系統中的所有現有軟體包:

取得 Docker 二進位檔案及其 Compose 外掛程式和相依性:

顯示安裝 Opengist 依賴項的過程的終端。

確保您的系統中存在“核心”快照包:

從電子前沿基金會 (EFF) 安裝 Certbot snap 套件:

安裝並運行 Opengist

在目前使用者的主目錄中為 Opengist 建立一個新資料夾,然後進入其中:

使用您最喜歡的文字編輯器在 Opengist 資料夾中建立一個新的「docker-compose.yml」:

將以下程式碼區塊貼到新的撰寫檔案中:

儲存“docker-compose.yml”文件,然後執行以下命令來建置 Opengist 並將其安裝到您的系統中:

透過列出電腦中所有活動的 Docker 容器來確認 Opengist 已啟動並正在執行:

顯示正在運行的 Opengist Docker 容器的終端。

為 Opengist 建立 SSL 反向代理

此時,您現在已經在連接埠 6157 上執行了一個部分工作的 Opengist 實例。

為此,請在您的網域上建立新的「A」DNS 記錄,指向 Opengist 電腦的 IPv4 位址。

顯示 Opengist VPS 的 DNS 記錄的螢幕截圖。

返回伺服器終端,然後為 Opengist 建立一個新的網站設定檔:

將以下程式碼區塊貼到新的設定檔中:

儲存網站設定文件,然後建立從「/etc/nginx/sites-available/」到「/etc/nginx/sites-enabled/」的符號連結:

確認您的 Nginx 設定正常運作,然後使用 systemctl 啟動 Web 伺服器:

顯示伺服器上執行的 Nginx 反向代理的終端。

使用您的電子郵件地址向 EFF 註冊您的 Opengist 系統:

使用 Certbot 為您的網域產生新的 SSL 憑證:

開啟網路瀏覽器並導航到您的域名,確認您的網站可以透過網路存取。

顯示 Opengist 透過 HTTPS 運行的螢幕截圖。

使用 Opengist 建立您的第一個要點

預設情況下,Opengist 不會為您的個人實例提供管理員帳戶。要建立一個,您需要先透過實例的 Web 介面註冊它。

首先導覽至 Opengist 的子網域,然後按一下頁面右上角的註冊按鈕。

反白顯示 Opengist 右上角的「註冊」按鈕的螢幕截圖。

提供您的管理員帳戶的使用者名稱和密碼,然後按一下「註冊」來建立它。

顯示第一個 Opengist 帳戶的註冊過程的螢幕截圖。

這樣做會自動讓您登入 Opengist 介面,並提示您進入第一個要點頁面。在輸入框中鍵入或貼上文字片段,然後按一下「建立公開要點」以產生您的第一個要點。

顯示在 Opengist 中建立新要點的介面的螢幕截圖。

現在,您可以透過從瀏覽器網址列複製新要點文件的連結並將其發送給您的收件者來與任何人分享您的新要點文件。

使用 SSH 建立和更新 Gist

除了 Web 介面之外,Opengist 還支援直接從 Git CLI 用戶端提交和編輯要點。如果您正在處理僅限終端的會話並且無法存取圖形介面,這會很有幫助。

在使用者的主目錄中為要點頁面建立一個新資料夾:

複製或建立一個包含要點資料的新文字文件,然後在新資料夾中初始化一個新的 Git 儲存庫:

顯示為要點頁面建立新 Git 儲存庫的過程的終端。

將資料夾的檔案新增至新的 Git 儲存庫,然後建立其第一個提交:

將本機 Git 儲存庫的遠端端點設定為 Opengist 伺服器:

將新儲存庫傳送到 Opengist 伺服器:

提供您的 Opengist 憑證,然後按下Enter確認推播指令。

終端機突出顯示 Opengist 伺服器的憑證提示。

複製 Opengist 在終端機會話上傳回的 Git 命令,然後執行它來為儲存庫設定新的遠端來源。

終端機突出顯示 Opengist 頁面的新遠端 URL。

透過查看伺服器的 Web 介面來確認您已正確儲存要點。

顯示 Opengist Web 介面上的新要點頁面的螢幕截圖。

在 Linux 上託管您自己的 Opengist 伺服器以及創建類似 Github 的要點頁面只是您可以使用自託管軟體執行的一些操作。透過查看當今 Github 的一些最佳自架替代方案,探索有關自架的更多資訊。

圖片來源:Joan Gamell,來自 Unsplash。所有修改和螢幕截圖均由 Ramces Red 進行。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *