大家好,今天給大家分享的是一個開源的、獨立的、可自託管的評論系統,專為現代Web平臺設計。

一個開源的、獨立的、可自託管的評論系統,專為現代Web平臺設計

Remark42是一個自託管的、輕量級的、簡單的(但功能強大的)評論引擎,它不會監視使用者。它可以嵌入到部落格、文章或任何其他讀者新增評論的地方。

專案介紹

Remark42提供多種登入選項,包括透過 Google、Twitter、Facebook、Microsoft、GitHub、Yandex、Patreon 和 Telegram 進行社交登入,以及透過電子郵件登入。還有一個匿名訪問選項。

Remark42支援多級巢狀註釋,可以選擇樹形和普通演示。它還提供從 Disqus 和 WordPress 匯入評論的工具。

Remark42 支援 Markdown,並配有友好的格式化工具欄,可輕鬆格式化。它還提供稽核工具,允許稽核者在必要時刪除評論並阻止使用者。

該應用程式主要是用 Golang 和 React 編寫的。由開發人員社群支援和維護。

功能特性

以下是 Remark42 的一些功能(按順序排列),並解釋了某些專案的優點:

  • 完全 Docker 化,可以透過單個命令進行部署:簡化了部署過程,讓具有最少技術知識的使用者變得更容易。

  • 投票、置頂和驗證系統:這有助於透過允許使用者對評論進行投票、置頂重要評論和驗證真實性來增強使用者互動和參與度。

  • 從 Disqus 和 WordPress 匯入:可以輕鬆地從流行平臺進行轉換,而不會丟失以前的評論。

  • 獨立的可執行檔案可以直接部署到 Linux、Windows 和 macOS:提供了跨不同作業系統的靈活性。

  • 乾淨、輕量級且可自定義的 UI,具有白色和深色主題:使用者友好的介面可以輕鬆導航和自定義,以匹配您網站的外觀和風格。

  • 所有評論和每篇帖子的 RSS:這可確保使用者和管理員及時瞭解最新的評論和討論。

  • 透過電子郵件登入

  • 帶有友好格式化工具欄的 Markdown 支援:使用者可以輕鬆格式化他們的評論,從而提高可讀性和參與度。

  • 給管理員的 Telegram、Slack、Webhook 和電子郵件通知(每條新評論都會收到通知)

  • 無需外部資料庫,所有內容都嵌入在單個資料檔案中:這簡化了資料管理並增強了資料安全性。

  • 透過 Google、Twitter、Facebook、Microsoft、GitHub、Yandex、Patreon 和 Telegram 進行社交登入:為使用者提供各種便捷的登入選項。

  • 可排序的評論

  • 單個例項的多站點模式:這使您可以從一個地方管理來自多個站點的評論,從而提高效率。

  • 版主可以刪除評論並阻止使用者:這有助於維持健康和尊重的討論環境。

  • 透過拖放上傳影像:這使影像上傳更加簡單、輕鬆,從而增強了使用者體驗。

  • 與自動 SSL 整合(直接或透過 nginx-le)

  • 可選的匿名訪問

  • 使用者的電子郵件和Telegram通知(當有人回覆您的評論時收到通知)

  • 透過自動備份將資料匯出為 JSON:這可確保資料安全,並在需要時更輕鬆地移動資料。

  • 具有樹形和簡單演示的多級巢狀評論:這鼓勵深入討論並使對話更容易理解。

  • 最近評論的提取器,交叉釋出

  • 注重隱私:尊重使用者隱私是Remark42的一個關鍵特性;它不會跟蹤或監視其使用者。

安裝使用

可以使用 Docker 或從原始碼執行它來輕鬆下載和安裝該應用程式。官方推薦使用Docker方式安裝。

Docker 安裝

  1. 首先,獲取Github倉庫中提供給您的 docker-compose.yml 檔案。根據您的具體需要和要求調整此檔案配置項。

  2. 完成此操作後,請確保您不會在部署中保留 ADMIN_PASSWD=something...,除非它們專門用於開發目的。

  3. 從 Docker Hub 中提取準備好的映象。執行命令 docker-compose pull && docker-compose up -d 即可完成此操作。

  4. 也可以直接從原始碼進行編譯。執行命令 docker-compose build && docker-compose up -d

原始碼執行

  1. 在專案的Github釋出頁,下載穩定版本的存檔。

  2. 下載存檔後,您需要將其解壓。如果您使用的是 Linux 或 macOS,則可以使用gunzip 命令執行此操作。如果您使用的是 Windows,則需要使用 zip。

  3. 存檔解壓後,您可以將其作為 remark42.{os}-{arch} server {parameters...} 執行。例如,如果您想在Linux上執行它,您可以輸入remark42.linux-amd64 server --secret=12345 --url=http://127.0.0.1:8080

  4. 也可以直接從原始碼進行編譯。為此,您需要執行編譯命令 make OS=[linux|darwin|windows] ARCH=[amd64,386,arm64,arm]

在網站上放置評論元件

參考完整配置請參考官方配置文件

1.設定站點配置

  • REMARK_URL – 提供 Remark42 例項的 URL,作為 REMARK_URL 傳遞到後端
  • YOUR_SITE_ID - 您在啟動時傳遞給 Remark42 例項的站點,預設為remark
<script>
  var remark_config = {
    host: 'REMARK_URL',
    site_id: 'YOUR_SITE_ID',
  }
</script>

2.初始化元件

然後將下面程式碼片段放在配置之後

<script>!function(e,n){for(var o=0;o<e.length;o++){var r=n.createElement("script"),c=".js",d=n.head||n.body;"noModule"in r?(r.type="module",c=".mjs"):r.async=!0,r.defer=!0,r.src=remark_config.host+"/web/"+e[o]+c,d.appendChild(r)}}(remark_config.components||["embed"],document);</script>

3.放置評論元件

將評論程式碼放在您希望評論出現的位置。在您希望顯示評論的網站頁面上插入以下程式碼片段:

<div id="remark42"></div>

專案地址

https://github.com/umputun/remark42