【打工日常】docker部署一款开源的笔记管理和协作工具

一、项目介绍

1.项目简述
Logseq 是一个隐私优先的开源知识库。

2.项目功能
插件系统：允许用户根据自己的需求扩展功能，社区开发的插件可以添加新特性或改进现有功能。

主题和定制：支持主题定制，用户可以根据自己的喜好更改应用程序的外观。

多语言支持：包括中文、英文、土耳其语、意大利语和日语等，方便不同语言背景的用户使用。

版本控制：基于本地文件，用户可以轻松使用Git等版本控制系统来管理笔记的历史更改。

闪卡功能：帮助用户记忆和回顾重要信息，适用于学习和复习。

文档导出：允许用户将笔记导出为PDF、Markdown等格式，方便分享和存档。

隐私优先：数据存储在本地，而不是云端，提供了更高的隐私保护。

Markdown支持：使用Markdown作为主要编辑语言，使文本编辑和格式化变得简单而高效。

双向链接和动态块：通过双向链接功能，用户可以在笔记之间创建丰富的连接，构建复杂的知识网络；动态块和属性功能则提供了更细致的信息分类和组织方式。

3.项目开源地址
https://github.com/logseq/logseq

---

二、项目搭建环境

1. 项目测试环境

A.项目映射在华为云centos8.2,外网地址为124.71.67.131，实际搭建在我的minipc，通过内网穿透映射到华为云进行访问
Linux hcss-ecs-031b 4.18.0-348.7.1.el8_5.x86_64 #1 SMP Wed Dec 22 13:25:12 UTC 2021 x86_64 x86_64 x86_64 GNU/Linux

B.docker版本为26.1.3，docker-compose版本为26.1.3
注意：本次实践部署环境为个人的测试环境，若是生产环境请谨慎部署；对应开启了容器的端口，在linux下和防火墙下需开放对应端口。

2. 本次项目实施过程

使用docker下载镜像，创建好项目需要挂载的路径，通过docker compose启动容器，启动容器后查看容器启动状态，查看容器的运行日志是否正常，以上全部正常执行后体验项目功能。

3.注意：docker下载镜像有可能遇到比较慢的情况，参考以下解决措施：

A.docker配置换源，进入/etc/docker的路径，如果没有就创建这个目录
cd /etc/docker/
mkdir -p /etc/docker

B.编辑配置文件
vim daemon.json   ##可以清空里面的内容：%d 然后复制下面的源进去wq保存

{
    "registry-mirrors":[
        "https://286u3d9d.mirror.aliyuncs.com"
    ]
}

C.registry-mirrors：指定了一个镜像仓库的 URL https://286u3d9d.mirror.aliyuncs.com。 这个配置项用于设置 Docker镜像的镜像仓库地址，使得在拉取和推送 Docker 镜像时能够通过该镜像仓库进行加速。这边提供的是广东广州服务器的镜源，建议个人自己去阿里云建一个个人账号，根据实际所在区获取镜源。

D.重新加载源，重启docker服务
sudo systemctl daemon-reload 
sudo systemctl restart docker

---

三、项目搭建前巡检

1. 检查docker是否正常运行
systemctl status docker
or
service docker status
注：我个人测试环境是使用systemctl进行管理，若有使用service管理请使用第二条的命令进行查看。   

[root@VM-8-12-centos ~]# 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 Mon 2024-04-22 23:13:57 CST; 4 days ago
     Docs: https://docs.docker.com
 Main PID: 17092 (dockerd)
    Tasks: 158
   Memory: 142.3M
   CGroup: /system.slice/docker.service

若显示docker的Active是active (running)，即表明docker是正常运行的。

2.一般我会使用docker-compose去管理，所以预先需要创建好yaml文件，vim docker-compose.yml,格式如下例子：

services:
    nginx:
        image: nginx
        logging:
            options:
                max-size: 1g
        restart: always
        volumes:
            - '/var/run/docker.sock:/tmp/docker.sock:ro'
        ports:
            - '80:80'

---

四、项目实施过程

1.根据开源项目，找到对应的镜像进行pull，若遇到很慢的情况，先检查是否网络问题以及是否已经换源。
docker pull ghcr.io/logseq/logseq-webapp:latest

[root@VM-8-12-centos ~]# docker pull ghcr.io/logseq/logseq-webapp:latest
Using default tag: latest
latest: Pulling from ghcr.io/logseq/logseq-webapp
d1669123f281: Pull complete 
2ec73b48ae40: Pull complete 
64ed7897b25d: Pull complete 
eefea741bc5a: Pull complete 
28cc9a8a9caf: Pull complete 
c6243262b905: Pull complete 
5c2d9fd83087: Pull complete 
e3ebcbb7b55e: Pull complete 
4f4fb700ef54: Pull complete 
Digest: sha256:39a32a34a4e4ecd6e289d08d649f530441d5fe3c6cdb60bdc0f1fbc9d1f2bd26
Status: Downloaded newer image for ghcr.io/logseq/logseq-webapp:latest
ghcr.io/logseq/logseq-webapp:latest

2.若已经下载完成显示新的一行，可以输入命令查看是否上一条命令执行成功
echo$?
若返回0，则成功；返回其他则根据实际情况重新下载或者查找原因。

3.docker下载完后，可以查看对应的镜像是否下载成功
docker images |grep logseq
 
4.下载成功后，编辑docker-compose.yml文件

services:
  logseq:
    container_name: logseq
    image: ghcr.io/logseq/logseq-webapp:latest
    ports:
      - 38686:80
    restart: always


编辑后输入wq进行保存

5.启动docker-compose

docker compose up -d  

6.启动容器后，查看容器的状态是否正常  

docker ps |grep  logseq
    
root@HEJIAJIN-PC:/opt# docker ps |grep  logseq
35937ae05a01   ghcr.io/logseq/logseq-webapp:latest                             "/docker-entrypoint.…"   25 minutes ago   Up 25 minutes   0.0.0.0:38686->80/tcp, :::38686->80/tcp                                                logseq

7.启动容器后，查看容器的日志是否正常

docker logs -f logseq

root@HEJIAJIN-PC:/opt# docker logs -f logseq
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
2024/06/14 09:06:26 [notice] 1#1: using the "epoll" event method
2024/06/14 09:06:26 [notice] 1#1: nginx/1.24.0
2024/06/14 09:06:26 [notice] 1#1: built by gcc 12.2.1 20220924 (Alpine 12.2.1_git20220924-r4) 
2024/06/14 09:06:26 [notice] 1#1: OS: Linux 6.6.25-amd64-desktop-hwe
2024/06/14 09:06:26 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2024/06/14 09:06:26 [notice] 1#1: start worker processes
2024/06/14 09:06:26 [notice] 1#1: start worker process 29
2024/06/14 09:06:26 [notice] 1#1: start worker process 30
2024/06/14 09:06:26 [notice] 1#1: start worker process 31
2024/06/14 09:06:26 [notice] 1#1: start worker process 32

---

五、项目体验

注：云服务器记得放开防火墙！
访问地址http://124.71.67.131:38686/,欢迎点击玩一下！
ps：内网穿透搭建好了，minipc可以撑一段时间，这些测试的服务应该会保留一段时间...如果有需要体验的但是服务已经被我down了的，可以在微信公众号《零氪的云原生》私我开启！