【Docker项目实战】使用Docker部署OtterWiki知识管理工具一、OtterWiki介绍1.1 OtterWiki项目简介1.2 OtterWiki主要特点二、本次实践规划2.1 本地环境规划2.2 本次实践介绍三、本地环境检查3.1 检查Docker服务状态3.2 检查Docker版本3.3 检查docker compose 版本四、拉取OtterWiki镜像五、部署OtterWiki服务5.1 创建部署目录5.2 编辑部署文件5.3 创建OtterWiki容器5.4 查看OtterWiki容器状态5.5 检查OtterWiki容器日志六、访问OtterWiki服务6.1 访问OtterWiki初始页6.2 注册账号6.3 编辑文档七、总结一、OtterWiki介绍1.1 OtterWiki项目简介OtterWiki是一个基于 Python 和 Flask 框架开发的轻量级 Wiki 协作系统内容存储于 Git 仓库中使用 Markdown 作为标记语言结合 Halfmoon CSS 框架与 CodeMirror 编辑器提供简洁高效的协作编辑体验。1.2 OtterWiki主要特点极简界面采用简洁设计并内置深色模式提供舒适的视觉体验。智能编辑器集成支持表格等扩展语法的 Markdown 高亮编辑器提升写作效率。可定制侧边栏支持自定义菜单和页面索引方便内容导航与组织。完整变更日志通过 Git 记录所有页面修改历史便于追溯与回滚。用户认证机制提供用户登录与权限管理保障内容安全。页面附件支持允许为页面添加文件附件丰富内容表现形式。扩展 Markdown 语法支持表格、脚注、高亮块、警告框和 Mermaid 图表等增强功能。Git HTTP 服务实验性可直接通过 HTTP 协议克隆、拉取和推送 Wiki 内容仓库。可爱水獭 Logo项目以 Christy Presler 创作的 CC BY 3.0 许可水獭插画作为吉祥物。二、本次实践规划2.1 本地环境规划本次实践为个人测试环境操作系统版本为 Ubuntu 24.04.2 LTS。hostnameIP地址操作系统版本Docker版本部署项目备注jeven192.168.3.88Ubuntu 24.04.2 LTS28.5.0OtterWiki——2.2 本次实践介绍1.本次实践部署环境为个人测试环境生产环境请谨慎2.在Docker环境下部署OtterWiki知识管理工具。三、本地环境检查3.1 检查Docker服务状态检查Docker服务是否正常运行确保Docker正常运行。rootjeven:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/usr/lib/systemd/system/docker.service;enabled;preset: enabled)Active: active(running)since Sat2025-10-0413:29:05 UTC;2days ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID:888(dockerd)Tasks:65Memory:1.2G(peak:1.4G)CPU: 3min23.296s CGroup: /system.slice/docker.service3.2 检查Docker版本检查Docker版本rootjeven:~# docker -vDocker version28.5.0, build 887030f3.3 检查docker compose 版本检查Docker compose版本确保2.0以上版本。rootjeven:~# docker compose versionDocker Compose version v2.39.4四、拉取OtterWiki镜像下载OtterWiki容器镜像镜像名称为redimp/otterwiki:2。dockerpull redimp/otterwiki:2五、部署OtterWiki服务5.1 创建部署目录创建部署目录mkdir-p/data/otterwiki/datacd/data/otterwiki/目录授权chmod-R777/data/otterwiki/5.2 编辑部署文件使用docker-cli方式部署可参考以下命令dockerrun-d\--restartunless-stopped\--nameotterwiki\-p490080\-v$(pwd)/data:/app-data\redimp/otterwiki:latest在部署目录下创建docker-compose.yaml文件内容如下所示vimdocker-compose.yamlservices:otterwiki:image:redimp/otterwiki:2restart:unless-stoppedports:-5600:80volumes:-/data/otterwiki/data:/app-data5.3 创建OtterWiki容器执行以下命令创建OtterWiki容器。dockercompose up-d5.4 查看OtterWiki容器状态检查OtterWiki容器运行状态确保OtterWiki容器正常启动。rootjeven:/data/otterwiki# docker compose psNAME IMAGE COMMAND SERVICE CREATED STATUS PORTS otterwiki-otterwiki-1 redimp/otterwiki:2/entrypoint.sh /usr…otterwiki28seconds ago Up27seconds(health: starting)0.0.0.0:5600-80/tcp,[::]:5600-80/tcp5.5 检查OtterWiki容器日志检查容器运行日志确保OtterWiki服务正常运行。dockercompose logs六、访问OtterWiki服务6.1 访问OtterWiki初始页浏览器地址http://个人的服务器IP:5600访问OtterWiki初始页。如果无法访问请确保宿主机的防火墙已关闭或已放行相关端口对于云服务器还需配置相应的安全组规则。6.2 注册账号第一次进入首页后我们注册一个用户如下所示注册账号完毕后使用注册的账号登录即可。6.3 编辑文档点击“Create page”选项编辑文章标题和内容保存文档效果如下所示七、总结通过本次实践我们成功使用Docker快速部署了OtterWiki知识管理工具整个过程简洁高效体现了容器化部署的优势。OtterWiki凭借其轻量设计、Git驱动的内容管理以及对Markdown的完善支持非常适合团队协作与知识沉淀。通过浏览器即可完成文档编写、版本追踪和用户管理使用体验流畅。未来可进一步探索其Git同步功能与权限配置将其深度集成到实际的项目文档管理体系中。