前言

在知识管理日益重要的今天，搭建一个轻量、高效且易于维护的 Wiki 系统成为许多团队和个人的迫切需求。华为开发者空间为开发者提供了开箱即用的云端开发环境，结合 Docker 容器技术，可快速部署各类应用。本文将指导您在华为开发者空间中部署 OtterWiki——一款基于 Git 与 Markdown 的轻量级知识协作工具。通过本教程，您将掌握从环境准备到实际使用的完整流程。

一、相关服务介绍

1.1 华为开发者空间介绍

华为开发者空间简介：

华为开发者空间（Huawei Developer Space）是华为云面向AI与智能应用开发者推出的一站式开发平台。它整合了免费算力资源、主流开发框架与工具链、以及丰富的学习与实践内容，旨在降低AI应用的开发门槛，提升研发效率。

华为开发者空间主要特点：

• 海量免费算力支持：提供高达180小时的免费资源，降低开发者使用门槛。
• 集成华为根技术创新：汇聚昇腾、鸿蒙、鲲鹏等华为核心技术，打造全栈开发环境。
• 开箱即用的云开发环境：桌面版即开即用，服务器/容器版兼容多IDE，覆盖多样化开发场景。
• 一站式AI开发平台：支持一键开发AI Agent、部署MCP，赋能智能应用快速构建。
• 丰富的开发者工具链：整合云上AI开发工具及技术案例，提升开发效率与创新能力。
• 便捷的工具与资源访问：集中提供华为生态开发工具，简化技术集成与调用流程。
• 云端学习与资产留存：配套学习路径、云文档和免费存储空间，助力开发者持续成长与成果保存。

1.2 OtterWiki介绍

OtterWiki 项目简介

OtterWiki 是一个基于 Python 与 Flask 框架构建的轻量级 Wiki 协作系统。它以 Git 作为后端存储机制，采用 Markdown 作为内容标记语言，并融合 Halfmoon CSS 框架与 CodeMirror 编辑器，致力于为用户提供简洁、高效且功能丰富的协作编辑体验。

OtterWiki 主要特点

• 极简界面设计：界面清爽直观，内置深色模式，兼顾美观与长时间使用的视觉舒适度。
• 智能 Markdown 编辑器：集成 CodeMirror 编辑器，支持语法高亮及表格等扩展语法，显著提升写作效率。
• 可自定义侧边栏：支持灵活配置菜单项与页面索引，便于用户快速导航和组织内容结构。
• 完整的版本控制：依托 Git 记录每一次页面修改，提供详尽的变更历史，支持便捷的追溯与回滚操作。
• 用户认证与权限管理：内置登录系统与权限控制机制，有效保障 Wiki 内容的安全性与私密性。
• 页面附件支持：允许为页面上传并关联文件附件，丰富内容的表现形式与实用性。
• 增强型 Markdown 语法：除标准语法外，还支持表格、脚注、高亮块、警告框以及 Mermaid 图表等扩展功能，满足多样化排版需求。
• Git HTTP 服务（实验性）：提供实验性的 Git HTTP 接口，支持通过标准 Git 客户端直接克隆、拉取或推送 Wiki 仓库内容。
• 可爱吉祥物形象：项目采用 Christy Presler 创作、遵循 CC BY 3.0 许可协议的水獭插画作为官方 Logo，传递友好与协作的理念。

二、进入华为开发者空间

2.1 登录华为云

登录华为云官网：https://developer.huaweicloud.com/，点击【开发者空间】进入华为开发者空间页面。

可以看到我们已经成功进入到开发者空间，如果是首次进入则可按照页面提示进行操作，可快速开通开发者空间服务。

2.2 进入远程终端

我们进入到华为开发者空间后，点击左侧的【云开发环境】。

我们选择“进入远程终端”选项，点击后进入到云开发桌面。这里之前已经创建好云主机，如果初始进入没有创建云主机，可自行创建。

备注：云主机与开发环境共享时长，基础会员全年总时长为180小时，您可分12次申请，每次15小时。当您的云主机使用时长小于等于60分钟时，可点击“更多”按钮申请延时。

进入开发桌面（云主机）需等待环境初始化，待准备完成后即可进入云主机远程终端。

三、安装Docker环境

3.1 安装Docker

• 我们使用以下命令，快速安装Docker。

sudo apt update 
sudo apt install docker.io -y

将当前用户加入到docker组中：

sudo usermod -aG docker $USER
newgrp docker

3.2 配置Docker镜像加速

配置 Docker 镜像加速时，只需将加速地址替换为对应华为云账号的专属镜像加速地址即可。

sudo mkdir -p /etc/docker

sudo tee /etc/docker/daemon.json <<-'EOF'
{
    "registry-mirrors": [ "https://xxxxx.mirror.swr.myhuaweicloud.com" ]
}
EOF

3.3 检查Docker版本

检查Docker版本

sudo docker -v

• 启动Docker服务

sudo systemctl daemon-reload
sudo systemctl restart docker

• 检查Docker状态

sudo  systemctl status docker

• 设置开机启动

sudo systemctl enable docker &&  sudo systemctl start docker

3.4 安装Docker compose工具

• 创建目录：

DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
mkdir -p $DOCKER_CONFIG/cli-plugins

• 下载docker compose安装包：

curl -SL https://github.com/docker/compose/releases/download/v2.40.3/docker-compose-linux-aarch64 -o $DOCKER_CONFIG/cli-plugins/docker-compose

sudo chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose

• 检查docker compose版本

developer@developer:/data/dashdot$ docker compose version
Docker Compose version v2.40.3

四、安装OtterWiki工具

4.1 创建部署目录

创建部署目录/data/otterwiki，如下所示：

sudo  mkdir -p /data/otterwiki/data &&  cd  /data/otterwiki/

目录授权工作：

sudo  chmod -R 777 /data/otterwiki/

4.2 下载镜像

执行以下命令，拉取redimp/otterwiki:2容器镜像。

docker pull redimp/otterwiki:2

4.3 编辑部署文件

使用docker compose方式，新建及编辑部署文件。

sudo vim docker-compose.yaml

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

4.4 创建容器

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

docker compose up -d 

4.5 检查容器状态

我们检查OtterWiki容器状态，确保OtterWiki容器正常运行。

developer@developer:/data/otterwiki$ docker compose ps
NAME                    IMAGE                COMMAND                   SERVICE     CREATED          STATUS                    PORTS
otterwiki-otterwiki-1   redimp/otterwiki:2   "/entrypoint.sh /usr…"   otterwiki   10 minutes ago   Up 10 minutes (healthy)   0.0.0.0:5600->80/tcp, [::]:5600->80/tcp
developer@developer:/data/otterwiki$ 

五、访问与测试

重新回到华为开发空间控制台，点击【进入主机】。

我们打开浏览器，地址：http: // localhost :5600，即可访问到OtterWiki服务。

六、基本使用

6.1 注册账号

点击OtterWiki首页右上角的login选项，进入账号注册页面。

自行注册账号，如下所示：

6.2 新建文档

我们点击“Create page”选项，编辑文章标题和内容后，确保保存即可。

七、总结

通过本次部署，我们成功在华为开发者空间中运行了 OtterWiki，构建了一个私有化、版本可控的知识库系统。整个过程依托 Docker 容器化技术，操作简便、环境隔离性强，便于后续维护与扩展。OtterWiki 凭借其简洁界面、Markdown 支持和 Git 版本追踪等特性，非常适合用于个人笔记或小团队知识沉淀。希望本教程能为您在云端搭建高效知识管理平台提供实用参考。