基于开发者空间部署OtterWiki知识管理工具【华为开发者空间】

前言
一、相关服务介绍
- [1.1 华为开发者空间介绍](#1.1 华为开发者空间介绍)
- [1.2 OtterWiki介绍](#1.2 OtterWiki介绍)
二、进入华为开发者空间
- [2.1 登录华为云](#2.1 登录华为云)
- [2.2 进入远程终端](#2.2 进入远程终端)
三、安装Docker环境
- [3.1 安装Docker](#3.1 安装Docker)
- [3.2 配置Docker镜像加速](#3.2 配置Docker镜像加速)
- [3.3 检查Docker版本](#3.3 检查Docker版本)
- [3.4 安装Docker compose工具](#3.4 安装Docker compose工具)
四、安装OtterWiki工具
- [4.1 创建部署目录](#4.1 创建部署目录)
- [4.2 下载镜像](#4.2 下载镜像)
- [4.3 编辑部署文件](#4.3 编辑部署文件)
- [4.4 创建容器](#4.4 创建容器)
- [4.5 检查容器状态](#4.5 检查容器状态)
五、访问与测试
六、基本使用
- [6.1 注册账号](#6.1 注册账号)
- [6.2 新建文档](#6.2 新建文档)
七、总结

前言

在知识管理日益重要的今天，搭建一个轻量、高效且易于维护的 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。

bash 复制代码

sudo apt update 
sudo apt install docker.io -y

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

bash 复制代码

sudo usermod -aG docker $USER
newgrp docker

3.2 配置Docker镜像加速

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

bash 复制代码

sudo mkdir -p /etc/docker

bash 复制代码

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

3.3 检查Docker版本

检查Docker版本

bash 复制代码

sudo docker -v

启动Docker服务

bash 复制代码

sudo systemctl daemon-reload
sudo systemctl restart docker

检查Docker状态

bash 复制代码

sudo  systemctl status docker

设置开机启动

bash 复制代码

sudo systemctl enable docker &&  sudo systemctl start docker

3.4 安装Docker compose工具

bash 复制代码

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

下载docker compose安装包：

bash 复制代码

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

bash 复制代码

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

检查docker compose版本

bash 复制代码

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

四、安装OtterWiki工具

4.1 创建部署目录

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

bash 复制代码

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

目录授权工作：

bash 复制代码

sudo  chmod -R 777 /data/otterwiki/

4.2 下载镜像

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

bash 复制代码

docker pull redimp/otterwiki:2

4.3 编辑部署文件

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

bash 复制代码

sudo vim docker-compose.yaml

yaml 复制代码

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

4.4 创建容器

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

bash 复制代码

docker compose up -d

4.5 检查容器状态

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

bash 复制代码

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 版本追踪等特性，非常适合用于个人笔记或小团队知识沉淀。希望本教程能为您在云端搭建高效知识管理平台提供实用参考。