Docker实战 | Docker部署Haptic笔记管理工具完整指南

一、Haptic介绍

1.1 Haptic简介

Haptic是一个本地优先、注重隐私的开源 Markdown 笔记管理工具。它设计简洁、轻量且高效，专注于提供用户所需的核心功能，而不会添加不必要的复杂性。Haptic 的目标是为用户提供一个安全可靠的地方来存储和管理他们的笔记，同时确保数据的私密性和完整性。

1.2 Haptic特点

1. 本地优先：

   • 所有数据默认存储在用户的本地设备上，无需依赖云端服务。
   • 支持离线使用，即使没有互联网连接也能访问和编辑笔记。

2. 隐私保护：

   • 无须注册账户，减少了个人信息泄露的风险。
   • 不会收集或传输用户的笔记内容到第三方服务器。

3. 开源软件：

   • 源代码公开透明，任何人都可以查看、审核甚至贡献改进。
   • 开源社区的支持意味着软件能够持续发展并获得新的特性。

4. Markdown 支持：

   • 完全兼容 Markdown 格式，支持丰富的文本格式化选项。
   • 提供实时预览功能，方便用户即时看到排版效果。

5. 简约界面：

   • 用户界面干净、直观，减少干扰，让用户专注于写作。
   • 快速导航和搜索功能，轻松找到所需笔记。

6. 跨平台：

   • 可能在多种操作系统（如 Windows, macOS, Linux）上运行。
   • 数据同步机制允许用户在不同设备间保持笔记一致。

7. 自定义与扩展：

   • 允许用户根据自己的喜好调整界面风格。
   • 通过插件系统支持额外的功能和定制。

1.3 主要使用场景

• 个人知识管理：对于需要记录日常想法、学习资料或项目笔记的人来说，Haptic 提供了一个结构化的方式来整理这些信息。
• 技术文档编写：程序员和技术人员可以利用 Haptic 来撰写技术文档、教程或是维护项目日志。
• 作家和博客作者：适合那些希望有一个简单工具来起草文章草稿，并能以 Markdown 格式导出的写作者。
• 学生笔记：学生可以用它来整理课堂笔记、研究材料和个人复习指南。
• 科研工作者：研究人员可以用来记录实验结果、文献综述和其他重要信息。
• 团队协作：虽然 Haptic 主要是单人使用的工具，但通过共享文件夹等方式，也可以用于小规模的团队协作。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为|Ubuntu 22.04.1。

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；
2.在Docker环境下部署Haptic笔记管理工具。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

root@jeven01:~# systemctl status docker● docker.service - Docker Application Container Engine Loaded: loaded(/lib/systemd/system/docker.service;enabled;vendor preset: enabled)Active: active(running)since Mon2024-09-0910:43:35 CST;3weeks5days ago Docs: https://docs.docker.com Main PID:695(dockerd)Tasks:135(limit:9387)Memory:4.0G CPU: 46min46.854s CGroup: /system.slice/docker.service ├─695/usr/bin/dockerd ├─846containerd--config/var/run/docker/containerd/containerd.toml

3.2 检查Docker版本

检查Docker版本

root@jeven01:~# docker -vDocker version27.1.1, build6312585

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

root@jeven01:~# docker compose versionDocker Compose version v2.19.1

四、下载Haptic镜像

拉取Haptic镜像，镜像名称为：chroxify/haptic-web:v0.1.4。

root@jeven01:~# docker pull chroxify/haptic-web:v0.1.4v0.1.4: Pulling from chroxify/haptic-web e4fff0779e6d: Already exists 57bfd8b087cd: Pull complete 955fc5fe26b2: Pull complete 8f50a2be0867: Pull complete 29852a384601: Pull complete b4872c95011a: Pull complete 4f5185938b7c: Pull complete 4c6462cbaaaf: Pull complete fb62c4e3c9ab: Pull complete 736fffd73589: Pull complete Digest: sha256:fd8c09f777c177f9c6fc86acfb81ca9dd8cfa3c64ff379af8be6049ead0d5b97 Status: Downloaded newer imageforchroxify/haptic-web:v0.1.4 docker.io/chroxify/haptic-web:v0.1.4

五、部署Haptic应用

5.1 创建部署目录

• 创建部署目录

mkdir-p/data/haptic&&cd/data/haptic

5.2 编辑部署文件

• 如果使用docker-cli部署，可参考以下命令：

dockerrun-d\--restartalways\--namehaptic\-p8900:80\chroxify/haptic-web:v0.1.4

在`部署目录下，创建docker-compose.yaml文件，其中宿主机映射端口等可以自定义配置。

vimdocker-compose.yaml

version:'3'services:haptic:image:chroxify/haptic-web:v0.1.4container_name:hapticrestart:alwaysports:-8900:80

5.3 创建Haptic容器

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

root@jeven01:/data/haptic# docker compose up -d[+]Running2/2 ✔ Network haptic_default Created0.1s ✔ Container haptic Started0.3s

5.4 查看Haptic容器状态

检查Haptic容器状态状态，确保Haptic容器正常启动。

root@jeven01:/data/haptic# docker compose psNAME IMAGE COMMAND SERVICE CREATED STATUS PORTS haptic chroxify/haptic-web:v0.1.4"/docker-entrypoint.…"haptic2minutes ago Up2minutes0.0.0.0:8900->80/tcp, :::8900->80/tcp

5.5 查看Haptic容器日志

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

dockercompose logs

六、访问Haptic服务

访问地址：http://192.168.3.88:8900，将IP替换为自己服务器IP地址。如果无法访问到以下页面，则检查宿主机的防火墙是否关闭或者放行相关端口，云服务器则还需要设置安全组规则。

七、Haptic基本使用

7.1 新建笔记

• 在左上角中，点击新建文件夹。

• 重命名文件夹，这里命名为Linux。

• 在该文件夹下新建笔记

7.2 编辑笔记内容

在右侧编辑器内，编辑文章内容。

7.3 日记模块

Haptic支持日记模式，选择“Daily desk”，进入日记模块。

7.4 任务模块

Haptic支持任务管理模式，选择“Tasks”，进入任务模块。

八、总结

通过使用Docker部署Haptic笔记管理工具，我们体验到了容器化带来的便捷性和高效性。整个部署过程简洁流畅，只需几条命令即可快速搭建起一个本地优先且注重隐私的Markdown笔记环境。Haptic在Docker中的运行稳定可靠，不仅简化了安装步骤，还确保了跨平台的一致性，极大地提升了我的笔记管理和写作效率。此外，Docker的隔离特性让我不必担心系统依赖问题，使得维护和更新变得更加轻松。