便民服务还是挺方便的，不用出小区就可以做了

本文完成于 10
月初，撰写时 Logseq
的版本为 v0.8.8
，发布时的最新版本是 v0.8.11

什么是 Logseq ？

Logseq
是一个本地优先的非线性大纲笔记本，用于组织和共享您的个人知识库。可以用它来组织你的待办事项列表，写你的日记，或者记录你独特的生活。

最早接触 Logseq
还是在 2020
年下半年，和 Obsidian
一样，Logseq
采用大纲，支持双链，当时笔记存储在 github
的私有仓库中，现在则存储在本地，支持通过 Github
同步笔记，笔记采用纯文本文件，目前支持 Markdown
和 Emacs Org
模式

直到 v0.5.6
开始，官方才提供了 Web App
的 Docker
镜像，除此之外，还支持主流平台的客户端应用，目前最新的版本是 v0.8.8

支持 Web App
这一点上，Logseq
比 Obsidian
做的好，更何况还开源呢

安装

ghcr.io 镜像下载

官方的镜像没有发布在 docker hub
，而是在 ghcr.io
，所以直接用命令行来安装。

在 SSH
客户端中依次执行下面的命令

# 下载镜像
docker pull ghcr.io/logseq/logseq-webapp:latest

如果没有科学上网，很可能会拉不动，可以试试 docker
代理网站：https://dockerproxy.com/，但是会多几个步骤

# 如果拉不动的话加个代理
docker pull ghcr.dockerproxy.com/logseq/logseq-webapp:latest

# 重命名镜像（如果是通过代理下载的）
docker tag ghcr.dockerproxy.com/logseq/logseq-webapp:latest ghcr.io/logseq/logseq-webapp:latest

# 删除代理镜像（如果是通过代理下载的）
docker rmi ghcr.dockerproxy.com/logseq/logseq-webapp:latest

当然代理网站也不是什么时候都好使，有时候也会报错，例如下面👇这样的

Error response from daemon: received unexpected HTTP status: 500 Internal Server Error

所以有一个稳定的科学上网环境还是很重要的

docker cli 安装

现在可以开始运行了

# 运行容器
docker run -d \
   --restart unless-stopped \
   --name logseq \
   -p 3880:80 \
   ghcr.io/logseq/logseq-webapp:latest 

docker compose 安装

也可以用 docker-compose
安装，将下面的内容保存为 docker-compose.yml
文件

version: '3'

services:
  logseq:
    image: ghcr.io/logseq/logseq-webapp:latest
    container_name: logseq
    restart: unless-stopped
    ports:
      - 3880:80

然后执行下面的命令

# 新建文件夹 logseq
mkdir -p /volume2/docker/logseq

# 进入目录
cd /volume2/docker/logseq

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中输入 http://群晖IP:3880
就能看到主界面

都展开之后，可以看到界面是简体中文

首先需要设置本地文件夹， 用于存储笔记。Logseq Web
应用程序使用 The File System Access API
来访问文件系统，所以您需要一个兼容的浏览器。

但是很奇怪，老苏的 Chrome
并没有被正确识别。其实真实的原因是，如果你是远程（非本地）访问，需要采用 https
协议连接才行

如果是开发，可以用 mkcert
生成本地受信任的开发证书，但对于我们来说，反代才是最简单的方式

反向代理

实际访问地址为：https://lnote.laosu.ml:444

在 npm
中的设置

SSL
都勾选了

在浏览器中打开 https://lnote.laosu.ml:444
，这次正常了

点击 Choose a folder
，然后选择本地用来保存笔记的文件夹

完成之后，就可以开始编辑笔记了

这个时候看本地文件夹

• /journals
  - 保存你的日记
• /logseq
  - 保存配置，custom.css
  和一些元数据
• /pages
  - 保存其他页面

网上能搜到大量 Logseq
的使用教程和视频，这里就不展开了

参考文档

logseq/logseq: A privacy-first, open-source platform for knowledge management and collaboration. Desktop app download link: https://github.com/logseq/logseq/releases, roadmap: https://trello.com/b/8txSM12G/roadmap
地址：https://github.com/logseq/logseq

logseq/docker-web-app-guide.md at master · logseq/logseq
地址：https://github.com/logseq/logseq/blob/master/docs/docker-web-app-guide.md

The File System Access API: simplifying access to local files
地址：https://web.dev/file-system-access/

FiloSottile/mkcert：一个简单的零配置工具，可以使用您想要的任何名称制作本地受信任的开发证书。
地址：https://github.com/FiloSottile/mkcert

@所有人：写文不易，如果你都看到了这里，请点个赞
和在看
，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。