
Wiki.js 是一款基於 Node.js 框架設計的功能豐富的開源 Wiki 應用程式。它提供豐富的編輯體驗,支援 Markdown 和所見即所得 (WYSIWYG) 介面。此外,它還支援即時協作、版本控制以及多種身份驗證方法,包括 Google 和 LDAP 整合。本指南將引導您完成使用 Docker 設定 Wiki.js 的必要步驟,讓您只需幾分鐘即可部署自己的 Wiki。
透過 Docker Compose 設定 Wiki.js
使用 Docker 和 Docker Compose 設定 Wiki.js 的過程非常簡單。首先建立一個名為 的新目錄wikijs-docker
並導航到該目錄:
mkdir wikijs-docker && cd wikijs-docker
docker-compose.yml
接下來,使用您喜歡的文字編輯器建立一個名為的檔案:
nano docker-compose.yml
然後,將以下配置插入到文件中:
services: db: image: postgres:16 environment: POSTGRES_DB: wiki POSTGRES_PASSWORD: wikijsrocks POSTGRES_USER: wikijs restart: unless-stopped volumes: - db-data:/var/lib/postgresql/data wiki: image: ghcr.io/requarks/wiki:2 depends_on: - db environment: DB_TYPE: postgres DB_HOST: db DB_PORT: 5432 DB_USER: wikijs DB_PASS: wikijsrocks DB_NAME: wiki restart: unless-stopped ports: - "80:3000" volumes: db-data:
儲存並關閉檔案後,執行以下命令啟動容器:
docker compose up -d

安裝過程完成後,在 Web 瀏覽器中導覽至http://localhost。在這裡,您需要提供管理員帳戶詳細信息,然後選擇“安裝”按鈕開始安裝:

完成安裝後,使用您的憑證登入。
在 Wiki.js 中建立和管理頁面
初始設定完成後,您可以建立主頁以開始填充內容或存取管理面板來管理設定、使用者和可用功能:

透過點擊「建立主頁」選項,系統將提示您選擇適合您偏好設定的編輯器:

接下來,定義頁面的屬性並點擊「確定」按鈕繼續建立新頁面:

編寫您想要的內容並點擊“建立”按鈕以完成頁面建立:

管理和組織內容
您的儀表板提供了一種便捷的方式,讓您可以查看和修改現有頁面,以及使用您選擇的編輯器建立新頁面。您可以透過重新命名、移動或刪除頁面來組織內容,並使用標籤進行有效分類。此外,側邊欄和搜尋功能可以加快您 wiki 中特定頁面的導航速度:

配置 Wiki.js 站點設置
在 Wiki.js 管理面板中,您可以靈活地配置網站設置,例如語言環境、導航結構、主題和標籤。這些設定在定義 Wiki.js 實例的整體配置中起著至關重要的作用。
在「常規」標籤下,您可以調整基本網站設置,包括網站標題、描述、預設主頁和可見性設定(公開或私人):

切換到「區域設定」標籤以指定網站的預設語言、時區和日期/時間格式:

若要管理您的 wiki 的選單結構並增強使用者導航,請造訪導航列部分:

在「頁面」標籤中,您可以監督、編輯和組織所有 wiki 頁面、建立新頁面以及管理內容的層次結構:

此外,在「標籤」標籤下,您可以建立和管理內容標籤,從而增強頁面的可搜尋性。您也可以透過「主題」標籤自訂wiki的美觀元素,例如變更網站標誌、顏色、字體和版面樣式。

管理 Wiki 中的群組
「群組」部分可讓您建立使用者群組、指定成員並設定群組層級的權限來規範存取權限。這種組織方法有助於簡化使用者角色,並在整個 Wiki 中保持一致的存取權管理。

點擊特定群組即可存取該群組的設定、權限、頁面規則以及使用者管理。透過「設定」選項卡,您可以調整選項,包括登入重新導向 URL。

您也可以瀏覽「權限」、「頁面規則」和「使用者」部分,以最佳化群組可以存取的內容並相應地指派使用者。
Wiki.js 中的使用者管理
若要新增用戶,請前往「用戶」部分,按一下「新用戶」按鈕,然後填寫必填欄位。
完成後,選擇“建立”或“建立並關閉”以完成新使用者設定:

選擇特定使用者可讓您查看和編輯他們的個人資料,分配使用者群組,定義身份驗證方法(如密碼或雙重認證),以及使用諸如停用,驗證或刪除之類的操作管理他們的狀態:

此外,您還可以更新他們的基本資訊、擴展元資料(包括位置和職位),並查看他們的活動歷史記錄:

管理您的 Wiki 模組
模組是增強 Wiki.js 功能的增強功能。例如,Analytics模組可讓您整合 Google Analytics 等工具來追蹤用戶參與度和流量指標:

利用「驗證」標籤建立和管理身分驗證提供者(本機登入、LDAP、OAuth)以及設定各種登入選項:

您也可以開啟或關閉評論系統並確定使用者如何參與頁面討論:

系統配置
透過配置渲染引擎、搜尋索引和儲存設置,管理內容的渲染、搜尋索引和儲存方式。例如,存取「渲染」標籤來自訂內容渲染,例如調整 Markdown 引擎設定或啟用對圖表和數學表達式的支援:

在搜尋引擎部分,您可以管理內部搜尋索引選項和第三方搜尋引擎整合:

在儲存部分中,指定內容的備份和同步目標,使您能夠管理媒體和頁面附件的儲存位置和方式(例如在本機檔案系統或 AWS S3 上):
管理安全性和連接性
您可以透過設定 API 存取、設定電子郵件通知、調整安全性原則以及啟用 SSL 來保護 Wiki.js 執行個體的安全,以獲得安全體驗。例如,處理API 令牌以將 Wiki.js 與其他應用程式整合:

設定電子郵件設定以管理 Wiki.js 中的通知、邀請和密碼復原流程:

安全性設定也可以微調,涵蓋會話逾時、密碼策略和存取限制等面向:

此外,您可以設定SSL/TLS憑證以確保您的 Wiki.js 實例透過 HTTPS 安全地運作:

此外,從系統資訊部分驗證您的 Wiki 訊息,例如係統診斷、伺服器規格和運行時環境統計資訊:

從「實用程式」標籤執行維護活動,例如重新索引搜尋結果、清除快取資料或重置配置:

最後,開發者工具提供進階資源,如 GraphQL 遊樂場、日誌偵錯功能或自訂腳本整合:

現在您已經掌握了使用 Docker 設定 Wiki.js 的知識,您可以自信地使用此平台輕鬆建立內部文件、協作團隊 wiki 或公共知識庫。
發佈留言