Otter Wiki
一个基于 Python、使用 Git 存储内容的轻量级 Wiki 系统，支持 Markdown 和暗黑模式。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
极简的 Markdown Wiki，所有内容存于 Git，一键 Docker 部署。
核心功能
- 简洁界面与暗黑模式
- Markdown 编辑器（支持表格、脚注、Mermaid 图表等）
- Git 版本控制：完整历史记录与差异对比
- 用户注册与权限管理
- 页面附件上传
避坑指南
- •首次部署需映射 app-data 卷到本地，否则重启后数据丢失,默认只监听 127.0.0.1:8080，需通过反向代理（Nginx/Apache/Caddy）暴露到公网,实验性 Git HTTP 服务器默认关闭，需手动启用,某些扩展 Markdown 特性（如图表）可能受编辑器渲染限制
适用场景
- 团队内部文档协作
- 个人知识库与笔记管理
- 项目 Wiki 或轻量级技术文档
- 替代传统 Wiki（需 Git 版本控制优势的场景）
详细介绍
Otter Wiki 是一个基于 Python 的轻量级 Wiki 系统，所有内容存储在 Git 仓库中，自动追踪每次修改。它使用 Markdown 编写，界面简洁并支持暗黑模式。核心功能包括：用户认证、页面附件、完整变更日志、可自定义侧边栏、以及扩展 Markdown（表格、脚注、警告框、Mermaid 图表）。实验性的 Git HTTP 服务器支持直接克隆和推送 Wiki 内容。通过 Docker Compose 可一键部署，首个注册用户自动成为管理员。
常见问题与排障 (1)
feature inquiry如何从 Otter Wiki 界面添加远程 Git 仓库？
此功能已经实现。您可以通过SSH配置向远程仓库的推送和拉取。请参阅官方文档：https://otterwiki.com/Configuration/Repository%20Management#pushing-to-and-pulling-from-ssh-remote
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
1. 创建 docker-compose.yml（见 README 示例）
2. 运行 docker-compose up -d 启动服务
3. 浏览器访问 http://127.0.0.1:8080
- 1. 创建 docker-compose.yml（见 README 示例）
- 2. 运行 docker-compose up -d 启动服务
- 3. 浏览器访问 http://127.0.0.1:8080
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
停止并删除容器：docker-compose down -v（-v 会删除 app-data 卷，请先备份）
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ