双链笔记Logseq的安装指南

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

本文完成于 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
1
2

如果没有科学上网，很可能会拉不动，可以试试 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
1
2
3
4
5
6
7
8

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

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

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

docker cli 安装

现在可以开始运行了

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

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
1
2
3
4
5
6
7
8
9

然后执行下面的命令

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

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

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

# 一键启动
docker-compose up -d
1
2
3
4
5
6
7
8
9
10

运行

在浏览器中输入 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