双链笔记Logseq的安装指南

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

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

什么是 Logseq ?

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

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

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

支持 Web App 这一点上,LogseqObsidian 做的好,更何况还开源呢

安装

ghcr.io 镜像下载

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

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

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

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

1
2
3
4
5
6
7
8
# 如果拉不动的话加个代理
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
Error response from daemon: received unexpected HTTP status: 500 Internal Server Error

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

docker cli 安装

现在可以开始运行了

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

docker compose 安装

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

1
2
3
4
5
6
7
8
9
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
10
# 新建文件夹 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

域名 局域网地址 备注
lnote.laosu.ml http://192.168.0.197:3880 Logseq Web 的访问地址

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