






# 一、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。


|hostname| IP地址  | 操作系统版本   |Docker版本   |部署项目|备注
|--|--| --|  --|--|--|
|jeven |192.168.3.88  | Ubuntu 24.04.2 LTS| 28.5.0   |OtterWiki            |  ——


## 2.2 本次实践介绍
>1.本次实践部署环境为个人测试环境，生产环境请谨慎；
>2.在Docker环境下部署OtterWiki知识管理工具。






# 三、本地环境检查

## 3.1 检查Docker服务状态
>检查Docker服务是否正常运行，确保Docker正常运行。



```bash
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 Sat 2025-10-04 13:29:05 UTC; 2 days ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 888 (dockerd)
      Tasks: 65
     Memory: 1.2G (peak: 1.4G)
        CPU: 3min 23.296s
     CGroup: /system.slice/docker.service
```



## 3.2  检查Docker版本
>检查Docker版本

```bash
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f
```


## 3.3 检查docker compose 版本
>检查Docker compose版本，确保2.0以上版本。


```bash
root@jeven:~# docker compose version
Docker Compose version v2.39.4

```


# 四、拉取OtterWiki镜像
>下载OtterWiki容器镜像，镜像名称为：`redimp/otterwiki:2`。



```bash
docker pull redimp/otterwiki:2
```

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/0c6641af447fdb511b7cc2dbb5d4fbba.png)














































# 五、部署OtterWiki服务


## 5.1 创建部署目录
- 创建部署目录

```bash
mkdir -p /data/otterwiki/data &&  cd  /data/otterwiki/
```

- 目录授权

```bash
chmod -R 777 /data/otterwiki/
```

## 5.2 编辑部署文件


>使用docker-cli方式部署，可参考以下命令：

```bash
docker run -d \
   --restart unless-stopped \
   --name otterwiki \
   -p 490080 \
   -v $(pwd)/data:/app-data \
   redimp/otterwiki:latest
```


>在部署目录下，创建docker-compose.yaml文件，内容如下所示：


```bash
vim docker-compose.yaml
```

```yaml
services:
  otterwiki:
    image: redimp/otterwiki:2
    restart: unless-stopped
    ports:
      - 5600:80
    volumes:
      - /data/otterwiki/data:/app-data





```







## 5.3 创建OtterWiki容器
>执行以下命令，创建OtterWiki容器。


```bash
docker compose up -d
```




![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/28af23f3bafa2cf6f0f5bc56a537ee60.png)






































## 5.4 查看OtterWiki容器状态
>检查OtterWiki容器运行状态，确保OtterWiki容器正常启动。

```bash
root@jeven:/data/otterwiki# docker compose ps
NAME                    IMAGE                COMMAND                  SERVICE     CREATED          STATUS                             PORTS
otterwiki-otterwiki-1   redimp/otterwiki:2   "/entrypoint.sh /usr…"   otterwiki   28 seconds ago   Up 27 seconds (health: starting)   0.0.0.0:5600->80/tcp, [::]:5600->80/tcp
```


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/024237a00ac93bd388d1dc6b0f46152a.png)




## 5.5 检查OtterWiki容器日志

>检查容器运行日志，确保OtterWiki服务正常运行。




```bash
docker compose logs
```
![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/78a9438e730b20d4de9e534827c15cf8.png)

















































# 六、访问OtterWiki服务






## 6.1 访问OtterWiki初始页








>浏览器地址： `http://<个人的服务器IP>:5600`，访问OtterWiki初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。













![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/27883439d9c9b5817084e8596d1e6813.png)
















## 6.2 注册账号

>第一次进入首页后，我们注册一个用户，如下所示：



![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/7bb8ea5ec7ab3c62a465a0ec61abd8f9.png)



>注册账号完毕后，使用注册的账号登录即可。

![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/837300bd6eafb2b02d4f5ea307f35c39.png)


## 6.3 编辑文档

>点击“Create page”选项，编辑文章标题和内容，保存文档，效果如下所示：


![在这里插入图片描述](https://developer.qcloudimg.com/http-save/yehe-4995888/3e6e826cbdec54f70c769fb5eece3a70.png)

# 七、总结


>通过本次实践，我们成功使用Docker快速部署了OtterWiki知识管理工具，整个过程简洁高效，体现了容器化部署的优势。OtterWiki凭借其轻量设计、Git驱动的内容管理以及对Markdown的完善支持，非常适合团队协作与知识沉淀。通过浏览器即可完成文档编写、版本追踪和用户管理，使用体验流畅。未来可进一步探索其Git同步功能与权限配置，将其深度集成到实际的项目文档管理体系中。






OtterWiki 是一个基于 Python 和 Flask 框架开发的轻量级 Wiki 协作系统，内容存储于 Git 仓库中，使用 Markdown 作为标记语言，结合 Halfmoon CSS 框架与 CodeMirror 编辑器，提供简洁高效的协作编辑体验。

零基础搭建个人知识库：使用 Docker 一键部署 OtterWiki 全攻略

开发工具

后端

运维

OtterWiki是基于Python和Flask开发的轻量级Wiki系统，支持Markdown编辑、Git版本控制、用户权限管理等功能。本文详细介绍在Ubuntu24.04系统下使用Docker部署OtterWiki的完整流程，包括环境检查、镜像拉取、容器创建及服务访问步骤，帮助用户快速搭建团队知识协作平台。

云服务器

智能编辑

内容安全

服务器

防火墙

容器

Docker

Python

2026新春采购季

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

零基础搭建个人知识库：使用 Docker 一键部署 OtterWiki 全攻略-腾讯云开发者社区-腾讯云

零基础搭建个人知识库：使用 Docker 一键部署 OtterWiki 全攻略

零基础搭建个人知识库：使用 Docker 一键部署 OtterWiki 全攻略

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐