使用Docker部署WikiDocs文檔管理工具詳解
一、WikiDocs介紹
1.1 WikiDocs 簡(jiǎn)介
WikiDocs 是一款開源的、無需數(shù)據(jù)庫的 Markdown 靜態(tài)文件 Wiki 引擎,以純文本文件為基礎(chǔ)存儲(chǔ)內(nèi)容,輕量高效,適合個(gè)人知識(shí)管理與團(tuán)隊(duì)文檔協(xié)作。
1.2 WikiDocs 主要特點(diǎn)
- 開源:代碼完全開放,便于審查、定制和自由使用。
- 純文本文件:所有內(nèi)容以普通文件形式保存,便于版本控制和備份。
- 無需數(shù)據(jù)庫:直接讀寫文件系統(tǒng),部署簡(jiǎn)單,維護(hù)成本低。
- Markdown 語法:使用標(biāo)準(zhǔn) Markdown 編寫內(nèi)容,簡(jiǎn)潔易讀易寫。
- 編輯器全功能所見即所得(WYSIWYG):實(shí)時(shí)預(yù)覽編輯效果,提升寫作體驗(yàn)。
- 支持?jǐn)?shù)學(xué)公式 KaTeX:輕松渲染復(fù)雜的數(shù)學(xué)表達(dá)式,適合技術(shù)與學(xué)術(shù)文檔。
- 無限頁面版本記錄:自動(dòng)保存每次修改,可隨時(shí)回溯歷史內(nèi)容。
- 支持附件上傳與下載:方便附加文檔、資料等文件資源。
- 支持圖片上傳(包括剪貼板粘貼):可直接粘貼截圖或上傳圖片,圖文并茂更直觀。
- 支持命名空間分類內(nèi)容:通過命名空間組織頁面,結(jié)構(gòu)清晰易于管理。
- 自動(dòng)生成索引和站點(diǎn)地圖:自動(dòng)整理頁面結(jié)構(gòu),便于導(dǎo)航與搜索引擎發(fā)現(xiàn)。
- 支持公開與私有瀏覽模式:可靈活控制頁面訪問權(quán)限,保護(hù)敏感信息。
- 語法高亮:代碼塊自動(dòng)高亮顯示,提升技術(shù)文檔可讀性。
- 多語言支持:適配多種語言界面,滿足國際化使用需求。
- 暗色模式:提供護(hù)眼暗色主題,適應(yīng)不同環(huán)境下的閱讀習(xí)慣。
- 站點(diǎn)地圖(Sitemap):生成標(biāo)準(zhǔn) Sitemap 文件,有利于 SEO 優(yōu)化。
- 更多功能:持續(xù)更新,集成實(shí)用特性,滿足多樣化文檔需求。
二、本次實(shí)踐規(guī)劃
2.1 本地環(huán)境規(guī)劃
本次實(shí)踐為個(gè)人測(cè)試環(huán)境,操作系統(tǒng)版本為 Ubuntu 24.04.2 LTS。
| hostname | IP地址 | 操作系統(tǒng)版本 | Docker版本 | 部署項(xiàng)目 |
|---|---|---|---|---|
| jeven01 | 192.168.3.88 | Ubuntu 24.04.2 LTS | 28.3.3 | WikiDocs |
2.2 本次實(shí)踐介紹
1.本次實(shí)踐部署環(huán)境為個(gè)人測(cè)試環(huán)境,生產(chǎn)環(huán)境請(qǐng)謹(jǐn)慎;
2.在Docker環(huán)境下部署WikiDocs文檔管理工具。
三、本地環(huán)境檢查
3.1 檢查Docker服務(wù)狀態(tài)
檢查Docker服務(wù)是否正常運(yùn)行,確保Docker正常運(yùn)行。
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
Active: active (running) since Mon 2025-08-04 10:10:52 UTC; 30min ago
TriggeredBy: ● docker.socket
Docs: https://docs.docker.com
Main PID: 860 (dockerd)
Tasks: 10
Memory: 97.2M (peak: 98.4M)
CPU: 606ms
CGroup: /system.slice/docker.service
3.2 檢查Docker版本
檢查Docker版本
root@jeven:~# docker -v Docker version 28.3.3, build 980b856
3.3 檢查docker compose 版本
檢查Docker compose版本,確保2.0以上版本。
root@jeven:~# docker -v Docker version 28.3.3, build 980b856
四、拉取WikiDocs鏡像
拉取WikiDocs容器鏡像,當(dāng)前最新版本為zavy86/wikidocs:1.
docker pull zavy86/wikidocs:1

五、部署WikiDocs服務(wù)
5.1 創(chuàng)建部署目錄
- 創(chuàng)建部署目錄
mkdir -p /data/wikidocs/data && cd /data/wikidocs
- 目錄授權(quán)
chmod -R 755 /data/wikidocs/
5.2 編輯部署文件
在部署目錄下,創(chuàng)建docker-compose.yaml文件,內(nèi)容如下所示:
vim docker-compose.yaml
version: '3'
services:
wikidocs:
image: zavy86/wikidocs:1
container_name: wikidocs
restart: always
ports:
- 5200:80
volumes:
- /data/wikidocs/data:/datasets
environment:
- PUID=1000
- PGID=1000
5.3 創(chuàng)建WikiDocs容器
執(zhí)行以下命令,創(chuàng)建WikiDocs容器。
docker compose up -d

5.4 查看WikiDocs容器狀態(tài)
檢查WikiDocs容器運(yùn)行狀態(tài),確保WikiDocs容器正常啟動(dòng)。
root@jeven:/data/wikidocs# docker compose ps WARN[0000] /data/wikidocs/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS wikidocs zavy86/wikidocs:1 "/start.sh" wikidocs 28 seconds ago Up 28 seconds 0.0.0.0:5200->80/tcp, [::]:5200->80/tcp
六、訪問WikiDocs服務(wù)
6.1 初始化安裝
瀏覽器地址: http://<個(gè)人的服務(wù)器IP>:5200,訪問WikiDocs的初始頁。如果無法訪問,請(qǐng)確保宿主機(jī)的防火墻已關(guān)閉或已放行相關(guān)端口,對(duì)于云服務(wù)器還需配置相應(yīng)的安全組規(guī)則。

環(huán)境檢查:系統(tǒng)將自動(dòng)檢測(cè)當(dāng)前安裝環(huán)境,當(dāng)所有檢測(cè)項(xiàng)均顯示為綠色對(duì)勾時(shí),表示環(huán)境正常,可點(diǎn)擊“繼續(xù)”進(jìn)入下一步。

填寫相關(guān)配置信息,可參考如下:
Owner:內(nèi)容的所有者- -
Notice:內(nèi)容版權(quán)聲明 Edit authentication code:自定義填寫密碼Repeat edit authentication code:確認(rèn)密碼

確認(rèn)配置信息,點(diǎn)擊繼續(xù)下一步。

出現(xiàn)以下提示,則表示安裝完成。

6.2 訪問WikiDocs
點(diǎn)擊按照你完成界面的“continue”,則進(jìn)入到WikiDocs首頁。

七、WikiDocs基本使用
7.1 設(shè)置中文
在WikiDocs首頁,我們點(diǎn)擊右上角的“小鎖”圖標(biāo)。

輸入之前我們?cè)O(shè)置的訪問密碼后,如下所示:

點(diǎn)擊右上角的“齒輪”圖標(biāo),進(jìn)入WikiDocs系統(tǒng)設(shè)置界面。

將系統(tǒng)語言設(shè)置為簡(jiǎn)體中文后,點(diǎn)擊“save”保存即可。

7.2 編輯文檔
點(diǎn)擊新增文檔選項(xiàng),操作如下所示:

設(shè)置路徑:我們需要輸入新文檔路徑,例如參數(shù)/章節(jié)/標(biāo)題這種,如下所示:

編輯文檔后,點(diǎn)擊保存即可。

7.3 查看文章效果
文章保存后,可識(shí)別markdown語法,效果如下所示:

八、總結(jié)
本次實(shí)踐通過Docker成功部署了WikiDocs文檔管理工具,整個(gè)過程簡(jiǎn)潔高效,體現(xiàn)了容器化部署的優(yōu)勢(shì)。
WikiDocs基于Markdown的輕量設(shè)計(jì)和豐富的功能特性,非常適合用于個(gè)人或團(tuán)隊(duì)的知識(shí)管理。通過簡(jiǎn)單的目錄映射和配置,實(shí)現(xiàn)了數(shù)據(jù)的持久化與服務(wù)的穩(wěn)定運(yùn)行。未來可進(jìn)一步探索其權(quán)限管理、多用戶協(xié)作等高級(jí)功能,提升文檔管理效率。
以上為個(gè)人經(jīng)驗(yàn),希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
docker?desktop搜索不到images問題的解決辦法
這篇文章主要給大家介紹了關(guān)于docker?desktop搜索不到images問題的解決辦法,主要包括檢查網(wǎng)絡(luò)連接、Docker配置、清理緩存和使用其他鏡像源,通過這些方法,用戶可以解決在實(shí)際應(yīng)用中搜索不到Images的問題,需要的朋友可以參考下2025-03-03
使用Docker Compose搭建 Confluence的教程
本文將介紹如何使用 Docker Compose 快速搭建 Confluence 、以及如何和 Traefik 一同使用,如果你看過之前的內(nèi)容,跟隨本文應(yīng)該能在十分鐘內(nèi)解決戰(zhàn)斗,感興趣的朋友快來看看吧2021-06-06
利用docker-compsoe部署前后端分離的項(xiàng)目方法
這篇文章主要介紹了利用docker-compsoe部署前后端分離的項(xiàng)目方法,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08
用Docker swarm快速部署Nebula Graph集群的教程
這篇文章主要介紹了用Docker swarm快速部署Nebula Graph集群的方法,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-09-09
docker在Centos上做DNS服務(wù)器的配置全過程
這篇文章主要介紹了docker在Centos上做DNS服務(wù)器的配置全過程,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2025-06-06

