AI 助理
备案控制台
开发者社区 云原生 文章 正文

【云原生之Docker实战】使用Docker部署flatnotes笔记工具

2024-05-20 345
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 【5月更文挑战第17天】使用Docker部署flatnotes笔记工具

一、flatnotes介绍

1.1 flatnotes简介

flatnotes 是一个自托管的、无数据库的笔记 Web 应用程序，它利用文件夹存储 Markdown 文件。

1.2 flatnotes特点

  • 移动响应式web界面。

  • 原始/所见即所得标记编辑器模式。

  • 高级搜索功能。

  • 注意“标记”功能。

  • 浅色/深色主题。

  • 多个身份验证选项（无、只读、用户名/密码、2FA）。

  • Restful API。

1.3 flatnotes使用场景

FlatNotes 作为一个自托管、无数据库的笔记 Web 应用程序，特别适合以下几种使用场景：

  1. 个人知识管理：对于喜欢使用Markdown格式记录学习笔记、技术心得、读书感悟等个人知识的用户，FlatNotes提供了一个简洁高效的平台。用户可以轻松地通过文件夹结构来组织和分类自己的笔记，便于日后检索和回顾。

  2. 团队项目协作：在小型团队或项目组内部，FlatNotes 可以作为共享知识库使用。团队成员可以共同编辑和查看项目相关的文档、会议纪要、设计规范等，利用Markdown的简洁性和可读性提高沟通效率。自托管特性确保了数据的安全性和私密性。

  3. 学术研究与写作：学术研究人员可以利用FlatNotes整理研究资料、撰写论文草稿、记录实验结果。Markdown支持公式、代码高亮等特性，非常适合科技文献的编写。文件夹系统有助于按研究主题或论文章节组织内容。

  4. 博客或个人网站内容创作：博主和内容创作者可以利用FlatNotes作为后台编辑器，先在Markdown中撰写文章，然后直接从文件系统发布到网站上。这种方式简化了内容管理和发布的流程，尤其是对于使用静态站点生成器（如Jekyll、Hugo）的用户。

  5. 离线优先场景：由于FlatNotes依赖文件系统而非数据库，因此在没有网络连接或者网络不稳定的情况下，用户仍然可以通过本地文件系统访问和编辑笔记，实现离线工作，之后再同步更改。

  6. 教育与培训：教师可以使用FlatNotes创建课程大纲、讲义和作业说明，学生则可以用来整理课堂笔记和复习资料。Markdown的易学易用性降低了技术门槛，使得更多人能够专注于内容本身。

  7. 开源软件文档维护：开源项目团队可以利用FlatNotes来维护项目文档、开发者指南和贡献者手册。这样不仅便于版本控制，也方便社区成员贡献和编辑文档内容，促进项目的健康发展。

二、本地环境介绍

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为centos7.6。

hostname IP地址 操作系统版本 Docker版本

jeven|192.168.3.166 |centos 7.6|20.10.17|

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎使用；
2.在Docker环境下成功部署flatnotes笔记工具。

三、本地环境检查

3.1 检查Docker服务状态

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

[root@jeven ~]# systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2023-08-23 23:41:16 CST; 1 weeks 1 days ago
     Docs: https://docs.docker.com
 Main PID: 9562 (dockerd)
    Tasks: 50
   Memory: 1.4G
   CGroup: /system.slice/docker.service

3.2 检查Docker版本

检查Docker版本

[root@jeven ~]# docker version
Client: Docker Engine - Community
 Version:           20.10.17
 API version:       1.41
 Go version:        go1.17.11
 Git commit:        100c701
 Built:             Mon Jun  6 23:05:12 2022
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.17
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.17.11
  Git commit:       a89b842
  Built:            Mon Jun  6 23:03:33 2022
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.6.6
  GitCommit:        10c12954828e7c7c9b6e0ea9b0c02b01407d3ae1
 runc:
  Version:          1.1.2
  GitCommit:        v1.1.2-0-ga916309
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

3.3 检查docker compose 版本

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

[[root@jeven ~]# docker compose version
Docker Compose version v2.19.1

四、下载flatnotes镜像

从docker hub下载flatnotes镜像

[root@jeven ~]# docker pull  dullage/flatnotes
Using default tag: latest
latest: Pulling from dullage/flatnotes
1d5252f66ea9: Pull complete
eefb43356e06: Pull complete
c26db0eb1f01: Pull complete
300843d99304: Pull complete
daddf7df59b6: Pull complete
fd5b7d323a9e: Pull complete
956d12ab1aba: Pull complete
3a27da5a148e: Pull complete
9bc9c825c797: Pull complete
4f4fb700ef54: Pull complete
2dff9aeca767: Pull complete
745990a309e1: Pull complete
cf33157fe535: Pull complete
1f4f074b255f: Pull complete
042bd107273a: Pull complete
Digest: sha256:666b237abff5a16d781ee7f06ccdadef9e42951de3ec320a071407a9e85666ef
Status: Downloaded newer image for dullage/flatnotes:latest
docker.io/dullage/flatnotes:latest

五、部署flatnotes笔记工具

5.1 创建目录

新建挂载目录

mkdir -p /data/flatnotes/data   && cd /data/flatnotes/

目录授权工作

 chmod -R 777 /data/flatnotes/

5.2 使用docker-cli部署

使用docker-cli命令部署flatnotes笔记工具

  • 生成随机KEY
[root@jeven flatnotes]# cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 24 | head -n 1
Nl1rQmfg4gsnJfBfsmkXOo7G

docker run -d \
   --restart unless-stopped \
   --name flatnotes \
   -p "28880:8080" \
   -v "/data/flatnotes/data:/data" \
   -e "FLATNOTES_AUTH_TYPE=password" \
   -e "FLATNOTES_USERNAME=admin" \
   -e "FLATNOTES_PASSWORD=admin" \
   -e "FLATNOTES_SECRET_KEY=Nl1rQmfg4gsnJfBfsmkXOo7G" \
   -e "PORT=8080" \
  dullage/flatnotes:latest

5.3 编辑docker-compose.yaml文件

编辑docker-compose.yaml文件，内容如下：

version: '3'

services:
  flatnotes:
    image: dullage/flatnotes:latest
    container_name: flatnotes
    restart: always
    ports:
      - 28880:8080
    volumes:
      - /data/flatnotes/data:/data
    environment:
      - FLATNOTES_AUTH_TYPE=password
      - FLATNOTES_USERNAME=admin
      - FLATNOTES_PASSWORD=admin
      - FLATNOTES_SECRET_KEY=Nl1rQmfg4gsnJfBfsmkXOo7G
      - PORT=8080

5.4 创建flatnotes容器

使用docker compose快速创建flatnotes容器


[root@jeven flatnotes]# docker compose up -d
[+] Running 2/2
 ⠿ Network flatnotes_default  Created                                                                                                                                     0.1s
 ⠿ Container flatnotes        Started                                                                                                                                     0.4s

5.5 检查flatnotes容器状态

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

[root@jeven flatnotes]# docker ps
CONTAINER ID   IMAGE                      COMMAND            CREATED          STATUS          PORTS                                         NAMES
23eebd85b174   dullage/flatnotes:latest   "/entrypoint.sh"   13 seconds ago   Up 13 seconds   0.0.0.0:28880->8080/tcp, :::28880->8080/tcp   flatnotes

5.6 检查flatnotes容器日志

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

[root@jeven flatnotes]# docker logs flatnotes
Setting up user and group...
Adding group `flatnotes' (GID 1000) ...
Done.
Adding user `flatnotes' ...
Adding new user `flatnotes' (1000) with group `flatnotes' ...
Creating home directory `/home/flatnotes' ...
Copying files from `/etc/skel' ...
Setting file permissions...
WARNING: Breaking changes introduced in version 3.x:
  - The port flatnotes uses inside the Docker container has been changed to 8080 (previously 80).
  - To accompany the above change, support for the PORT environment variable has been removed.
  - The note directory inside the Docker container has moved from /app/data to simply /data.
Starting flatnotes...
2023-09-01 10:22:51 [INFO]: Creating new index
INFO:     Started server process [1]
INFO:     Waiting for application startup.
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8080 (Press CTRL+C to quit)

六、访问flatnotes

6.1 进入flatnotes登录页

访问地址：http://192.168.3.166:28880 ，将IP替换为自己服务器的IP地址

在这里插入图片描述

6.2 访问flatnotes首页

账号密码为自定义设置的admin/admin

在这里插入图片描述

七、flatnotes的基本使用

7.1 新建笔记

点击右上角的New"，新建笔记。

在这里插入图片描述

7.2 编辑笔记内容

编辑笔记内容，使用markdown格式。

在这里插入图片描述

7.3 预览笔记内容

点击预览笔记内容

在这里插入图片描述

7.4 保存笔记内容

保存笔记内容

在这里插入图片描述

7.5 查看首页笔记

回到首页，可以看到显示刚才编辑保存的笔记。

在这里插入图片描述

7.6 查看文件存储

在挂载目录/data/flatnotes/data上，可以看到刚才编辑保存的笔记文件。

[root@jeven data]# pwd
/data/flatnotes/data
[root@jeven data]# ls -l
total 8
-rw-r--r--. 1 admin admin 5680 Sep  1 18:52 Linux系统之普通用户sudo提权配置.md

八、总结

使用FlatNotes的感觉就像是拥有了一个既简约又强大的私人图书馆，所有知识和灵感都以Markdown笔记的形式井然有序地安放在各个文件夹书架上。无需担心云端数据库的繁琐与隐私问题，因为一切由我掌控，在本地或私有服务器安静地绽放。编辑体验流畅，随时离线访问让我在任何环境下都能自由思考、记录，这种返璞归真的自托管方式，让知识管理变得既直接又安心。

文章标签：
容器
Docker
Cloud Native
数据库
测试技术
关键词：
Docker实战
Docker部署
云原生部署
Docker工具
云原生实战
江湖有缘
目录
相关文章
蓝易云
|
21天前
|
Ubuntu Linux Docker
Docker容器的实战讲解
这只是Docker的冰山一角，但是我希望这个简单的例子能帮助你理解Docker的基本概念和使用方法。Docker是一个强大的工具，它可以帮助你更有效地开发、部署和运行应用。
蓝易云
89 27
蓝易云
|
1月前
|
Ubuntu 安全 Docker
Ubuntu下部署及操作Docker技巧
以上就是在Ubuntu下部署及操作Docker的具体步骤。但这只是冰山一角，Docker的魅力远不仅如此。你可以将其视为存放各种工具的小箱子，随时随地取用，极大地提升工作效率。你也可以私人订制，适应不同的开发环境，就像一个拥有各种口味冰淇淋的冰箱，满足各种各样的需求。好了，现在你已经掌握了基本的Docker运用技巧，快去尝试使用吧！记住，沉浸在探索中，你会找到无尽的乐趣和满满的收获。
蓝易云
95 23
dotNative
|
2月前
|
存储 开发工具 开发者
揭秘 Microsoft.Docker.SDK：让容器开发更轻松的强大工具揭秘
随着云计算和容器技术的快速发展，`Docker` 已经成为容器化技术的事实标准。`Microsoft` 作为 `Docker` 的主要支持者和参与者，推出了 `Microsoft.Docker.SDK`，旨在帮助开发者更轻松地进行容器开发。本文将深入揭秘 Microsoft.Docker.SDK 的功能、使用方法以及它在容器开发中的应用。
dotNative
92 12
喜欢猪猪
|
2月前
|
安全 API 算法框架/工具
大模型文件Docker镜像化部署技术详解
大模型文件Docker镜像化部署技术详解
喜欢猪猪
251 2
竹相_左小空空
|
2月前
|
开发工具 虚拟化 git
自学软硬件第755 docker容器虚拟化技术youtube视频下载工具
docker容器虚拟化技术有什么用？怎么使用？TubeTube 项目使用youtube视频下载工具
竹相_左小空空
90 13
蓝易云
|
2月前
|
JSON 运维 Ubuntu
在Docker上部署Ollama+AnythingLLM完成本地LLM Agent部署
通过以上步骤，您可以成功在Docker上部署Ollama和AnythingLLM，实现本地LLM Agent的功能。在部署过程中，确保环境和配置正确，以避免不必要的问题。希望本文能够帮助您顺利完成部署，并在本地环境中高效地使用LLM模型。
蓝易云
742 8
脆皮架构师
|
2月前
|
Docker Python 容器
Docker——阿里云服务器使用Docker部署python项目全程小记
本文记录了我在阿里云服务器上使用Docker部署python项目（flask为例）的全过程，在这里记录和分享一下，希望可以给大家提供一些参考。
脆皮架构师
215 1
HaydenGuo
|
1月前
|
存储 SQL 关系型数据库
docker部署n9e开源版本7.4.0
n9e开源版本7.4.0
HaydenGuo
58 0
流水刀客6
|
2月前
|
Linux 虚拟化 Docker
Linux服务器部署docker windows
在当今软件开发中，Docker成为流行的虚拟化技术，支持在Linux服务器上运行Windows容器。流程包括：1) 安装Docker；2) 配置支持Windows容器；3) 获取Windows镜像；4) 运行Windows容器；5) 验证容器状态。通过这些步骤，你可以在Linux环境中顺利部署和管理Windows应用，提高开发和运维效率。
流水刀客6
223 1
java填坑路
|
Java 测试技术 Docker
让Docker日臻完善的8个优秀工具
一眨眼，你可能错过如今Docker领域最值得关注的动向之一。除了Docker本身的进步外，其他许多实用的项目都建立在Docker的基础上，或者得到Docker的支持。
java填坑路
1324 0

热门文章

最新文章

  • 1
    乐言科技：云原生加速电商行业赋能，云消息队列助力降本 37%
  • 2
    登顶TPC-C｜云原生数据库PolarDB技术揭秘：高可用-无感切换篇
  • 3
    登顶TPC-C｜云原生数据库PolarDB技术揭秘：弹性并行查询（ePQ）篇
  • 4
    Argo Workflows at KubeCon Europe 2025: 多元场景的云原生任务编排
  • 5
    登顶TPC-C｜云原生数据库PolarDB技术揭秘：弹性并行查询（ePQ）篇
  • 6
    光云科技 X AnalyticDB：构建 AI 时代下的云原生企业级数仓
  • 7
    PolarDB开源：云原生数据库的新篇章
  • 8
    OpenKruise v1.8版本解读：解锁云原生应用管理的无限可能
  • 9
    微服务引擎 MSE 及云原生 API 网关 2025 年 3 月产品动态
  • 10
    登顶TPC-C｜云原生数据库PolarDB技术揭秘：高可用-无感切换篇
  • 1
    docker compose 容器编排
    81
  • 2
    PolarDB产品使用问题之如何基于Docker进行PolarDB-X单机模拟部署
    603
  • 3
    【Docker实战项目】使用Docker部署Plik 临时文件上传系统
    120
  • 4
    docker部署keepalived(搭建keepalived)
    421
  • 5
    【Docker管理工具】使用Docker部署portainer-ce管理工具
    1054
  • 6
    Docker容器技术在软件开发中的应用
    168
  • 7
    云原生之使用Docker部署Firefox浏览器
    389
  • 8
    Docker 网络命令大全，建议收藏！
    331
  • 9
    直接停掉docker后镜像都没了
    1196
  • 10
    spring cloud使用jar包部署和docker部署的区别
    208

    • 相关课程

    更多
  • 云计算、容器和云原生基础课程
  • ALPD云架构师系列：云原生DevOps 36计 -阿里云云效出品
  • 云原生实践公开课
  • 云原生基础概念及阿里云云原生产品介绍
  • CNCF Alibaba 云原生技术公开课
  • Kubernetes云原生管理实践

    • 相关电子书

    更多
  • 阿里云云原生技术实践营 | 上海站
  • 阿里云云原生 Serverless 技术实践营西安站材料合集
  • 智算时代，基于 Kubernetes 落地云原生 AI

    • 相关实验场景

    更多
  • 通过workbench远程登录ECS，快速搭建Docker环境
  • 基于云原生网关实现微服务的多版本线上灰度
  • Docker安装和配置
  • 容器的共享网络模型
  • 容器的启动和操作

    • 推荐镜像

    更多
  • docker-ce
  • docker-toolbox
  • ubuntu-ports
    • 下一篇
    一文了解：阿里云对象存储OSS是什么？