前言

日常记录的内容越来越多后，笔记很容易散落在不同软件、文件夹和聊天记录中。临时记下一条信息并不困难，真正麻烦的是过一段时间以后，能不能快速找到它，并继续补充相关内容。

对于注重数据保存和隐私的用户来说，笔记工具除了使用方便，还要考虑数据存放在哪里、能否离线访问，以及以后更换软件时能不能继续保留原有内容。相比完全依赖云端服务，本地部署会带来更多自主权。

Logseq是一款以大纲结构组织内容的知识管理工具，支持页面、块、图谱和白板等功能。将它部署在极空间中，可以通过浏览器打开统一的笔记界面，体验基础记录和内容整理功能。

本文将从极空间的SSH与Docker环境检查开始，完成Logseq Web应用部署，并介绍页面设置、新建笔记和白板等基础操作。最后再通过cpolar配置公网访问，让人在其他网络环境中也能打开这套笔记页面。

1.什么是Logseq？

Logseq是一款开源、本地优先、隐私友好的知识管理与笔记工具，专为构建个人知识库（PKM） 而设计。它结合了 大纲笔记（Outline Notes） 与 双向链接（Bi-directional Links） 两大核心理念，帮助用户以更自然、更结构化的方式记录、连接和探索想法。

核心特点：

本地优先（Local-First）

• 所有笔记默认保存在你自己的电脑上（以纯文本 Markdown 或 Org-mode 格式存储），无需依赖云端服务，数据完全由你掌控，保障隐私与长期可访问性。

大纲笔记（Outliner）

• 采用层级缩进的块（Block）结构组织内容，支持无限嵌套，非常适合梳理逻辑、做读书笔记、列任务清单或进行头脑风暴。

双向链接（Bi-directional Links）

• 通过 [[页面名]] 或 ((块ID)) 引用其他笔记或段落，系统会自动建立反向链接，在“引用”面板中显示所有关联内容，让知识网络自然生长。

知识图谱（Graph View）

• 可视化展示笔记之间的链接关系，帮助你发现隐藏的联系，宏观把握知识体系结构。

强大的查询能力（Query）

• 支持类似数据库的查询语法（如 {{query (and [[标签]] (task TODO))}}），动态聚合分散的信息，实现“活”的笔记系统。

插件生态 & 高度可定制

• 支持社区开发的插件（如日历、思维导图、代码高亮等），也可通过自定义 CSS 或快捷键优化工作流。

免费 & 开源

• 项目托管在 GitHub，代码透明，社区活跃，持续迭代。

适合谁用？

• 喜欢 Zettelkasten（卡片盒笔记法） 或 PARA 方法 的知识管理者
• 需要 离线使用、注重隐私 的用户
• 追求 纯文本、版本控制（如 Git）友好 的开发者或写作者
• 希望用 非线性方式 组织复杂思想的研究者、学生或创作者

简单来说：

Logseq = 大纲编辑器 + 双向链接维基 + 本地知识图谱

它不是另一个 Evernote 或 Notion，而是一个让你思考更清晰、连接更深入、知识可沉淀的“第二大脑”构建工具。

2.前提条件

2.1ssh远程连接到极空间

• 开启【SSH 服务】
• 使用终端（Windows PowerShell / Mac Terminal）登录：

sshroot@IP

2.2验证docker是否开启

使用命令：

docker-vsystemctl status-v

3.部署Logseq

通过Docker部署Logseq：

在开始部署之前，确保你的系统已经安装了Docker。可以通过以下命令检查 Docker 是否已安装：

docker--version

下载镜像并运行容器：

dockerrun-d--rm-p9090:80 ghcr.io/logseq/logseq-webapp:latest

部署完成后，在浏览器中输入http://极空间IP:9090就能看到Photoshop的界面：

4.使用Logseq

点开右侧栏，有三个模块分别是：目录、页面图谱和帮助：

点击如图所示按钮：

可以在设置中，设置自己喜欢的基础信息：

点击左侧展开：

可以跟需求使用：

点击左下角新建，即可开始记笔记啦！

新建白板：

在本地优先、注重隐私的知识管理工具Logseq中，你的所有笔记都安全地保存在个人设备上——但这也带来一个现实挑战：如何在外出时访问这些数据？此时，内网穿透工具cpolar成为关键桥梁。通过cpolar，你可以将运行在本地电脑上的Logseq服务安全地暴露到公网，生成一个HTTPS加密的临时或固定域名链接，随时随地用浏览器查看甚至编辑你的知识库。这种组合既保留了Logseq“数据完全自主”的核心优势，又突破了物理位置限制，让私有化知识系统真正实现“随身携带”。

5.安装cpolar实现随时随地开发

5.1 什么是cpolar？

cpolar是一款安全高效的内网穿透工具，无需公网IP或复杂配置，只需一条命令，即可将本地服务器、Web服务或任意端口映射到公网，让你随时随地远程访问内网应用，特别适合开发调试、远程运维和应急部署等场景。

5.2 部署cpolar

cpolar 可以将你本地电脑中的服务（如 SSH、Web、数据库）映射到公网。即使你在家里或外出时，也可以通过公网地址连接回本地运行的开发环境。

❤️以下是安装cpolar步骤：

使用一键脚本安装命令：

sudocurlhttps://get.cpolar.sh|sh

安装完成后，执行下方命令查看cpolar服务状态：（如图所示即为正常启动）

sudosystemctl status cpolar

Cpolar安装和成功启动服务后，在浏览器上输入虚拟机主机IP加9200端口即:【http://ip:9200】访问Cpolar管理界面，使用Cpolar官网注册的账号登录,登录后即可看到cpolar web 配置界面,接下来在web 界面配置即可：

打开浏览器访问本地9200端口，使用cpolar账户密码登录即可,登录后即可对隧道进行管理。

6.配置公网地址

登录cpolar web UI管理界面后,点击左侧仪表盘的隧道管理——创建隧道：

• 隧道名称：可自定义，本例使用了:logseq，注意不要与已有的隧道名称重复
• 协议：http
• 本地地址：9090
• 域名类型：随机域名
• 地区：选择China Top

创建成功后，打开左侧在线隧道列表,可以看到刚刚通过创建隧道生成了公网地址，接下来就可以在其他电脑或者移动端设备（异地)上，使用地址访问。

访问成功。

7.保留固定公网地址

使用cpolar为其配置二级子域名，该地址为固定地址，不会随机变化。

点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是logseq，大家可以自定义。填写备注信息，点击保留。

登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名
• Sub Domain：填写保留成功的二级子域名
• 地区: China Top

点击更新

更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。

最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。

总结

完成以上配置后，Logseq的Web页面就可以在极空间中运行。进入系统后，可以查看目录、页面图谱和基础设置，并根据需要新建笔记页面或白板，开始整理自己的内容。

从本文演示的功能来看，这套部署更适合用来体验Logseq的基本界面和记录方式。后续如果准备长期使用，还需要进一步确认笔记数据的保存目录、容器重启后的数据持久化方式，以及不同设备之间的数据管理方案。

通过cpolar创建公网隧道后，原本只能在家庭局域网中打开的Logseq页面，也可以从其他网络环境访问。继续配置固定二级子域名后，访问地址能够保持不变，日常打开会更加方便。

需要注意的是，笔记内容通常包含个人资料、工作信息和长期积累的知识数据。配置公网访问后，应确认页面是否具备可靠的身份验证和访问限制，并定期备份相关数据。双向链接、块引用、查询语法和模板等进阶能力，也需要在基础部署完成后继续单独配置和学习。