软件名称

Logseq

操作系统支持

支持 Windows、Mac、Linux 系统，可通过 Docker 部署在极空间等私有设备，移动端可通过浏览器访问部署后的 Web 版本。

软件介绍

Logseq 是一款开源、本地优先的知识管理工具，主打大纲笔记和双向链接功能，所有数据以 Markdown/Org-mode 纯文本格式存在本地，不依赖云端，还能生成知识图谱、支持自定义查询和插件扩展，像一个能自己梳理逻辑的「私人知识库管家」，不是简单的记事本，而是帮你搭建「第二大脑」的工具。

Logseq 的出色功能

Logseq 最核心的优势是「把零散信息变成有逻辑的知识网络」：

• 大纲笔记：以块为单位的层级缩进结构，支持无限嵌套，不管是拆分复杂方案、整理读书笔记，还是列任务清单，都能把混乱的信息理出清晰层级，比传统线性笔记更贴合人类思考方式；
• 双向链接：用 [[页面名]] 或 ((块 ID)) 关联内容，系统自动生成反向链接，比如记「阅读方法」时关联「精读技巧」，点一下就能看到所有提到「精读技巧」的笔记，知识不再孤立；
• 本地优先：所有数据存在自己的设备里，不用担心里程碑数据泄露或平台跑路，还能配合 Git 做版本控制，开发者和写作者用着更安心；
• 知识图谱：可视化展示笔记间的链接关系，能快速发现隐藏的知识关联，比如突然发现「时间管理」和「番茄工作法」的关联比想象中多。

实用场景

场景 1：学术研究 / 备考笔记整理

• 痛点：知识点零散，跨章节关联难，离线整理后外出无法访问，反复拷贝文件易丢失版本；
• 爽点：用 Logseq 的大纲结构拆分教材章节，双向链接关联跨章节知识点，部署在极空间后，通过 cpolar 穿透，图书馆、自习室不管有没有内网，打开浏览器就能访问完整知识库，不用带 U 盘拷贝，也不用怕手机和电脑笔记不同步。

场景 2：职场项目 / 任务管理

• 痛点：项目需求多、任务杂，团队沟通时逻辑讲不清，下班想处理紧急任务却连不上公司内网的笔记；
• 爽点：把项目拆成大纲块，给每个任务标 TODO，用查询语法 {{query (and [[项目名]] (task TODO))}} 快速筛选待办；通过 cpolar 把部署在公司极空间的 Logseq 穿透到公网，下班在家用手机就能修改任务进度，不用再跑回公司。
  

cpolar内网穿透技术带来的便利

Logseq 的本地优先是优点，但也有个小局限 —— 离开部署的内网环境（比如极空间、家里的电脑），就没法访问知识库。而 cpolar 内网穿透刚好补上这个短板，而且全程不用复杂的代码操作，普通人也能搞定：

1. 打破物理位置限制：不管是在公司、咖啡馆、高铁站，只要有网络，就能通过 cpolar 生成的公网地址访问内网里的 Logseq，不用再局限于「只有连家里 / 公司内网才能看笔记」。比如出差忘带笔记本，打开手机浏览器，输入 cpolar 的固定域名，就能查看或修改知识库，不用再等回到住处才能处理。
2. 固定地址更省心：cpolar 能申请固定的二级子域名，不用每次重启隧道都记新的随机地址。像把 Logseq 部署在极空间的用户，设置好固定域名后，不管是自己用还是分享给信任的人（比如团队协作），只用记一个地址，不用反复发新链接，实测配置一次能一直用，省了每次核对地址的时间。
3. 不用折腾公网 IP：普通人家里 / 公司的网络基本没有公网 IP，想远程访问内网应用，以前要找运营商申请、改路由器设置，折腾半天还不一定成。cpolar 不用公网 IP，一键安装后简单配置隧道，10 分钟内就能把 Logseq 暴露到公网，对不懂网络配置的人特别友好。
4. 多设备同步更丝滑：Logseq 本身是本地存储，多设备同步要手动拷贝文件，容易出版本冲突。用 cpolar 穿透后，所有设备都访问同一个内网里的 Logseq 实例，手机改的内容，电脑打开直接同步，不用再手动传文件，也不会出现「手机记了内容，电脑里还是旧版本」的情况。
5. 隐私有保障：cpolar 的穿透链接是 HTTPS 加密的，比自己搭的普通公网链接更安全，而且 Logseq 的数据本身还在本地，只是通过 cpolar 的链接访问，既保留了 Logseq 本地优先的隐私优势，又有远程访问的便利，不用为了远程访问把数据放到第三方云端。
   

总结

Logseq 不是普通的笔记工具，它用大纲笔记 + 双向链接帮我们把零散的信息梳理成有体系的「第二大脑」，本地存储的特性又让数据安全掌握在自己手里；而 cpolar 内网穿透则解决了 Logseq「只能内网访问」的局限，让这份「私人知识库」能突破物理空间的限制，随时随地访问、编辑。

对注重隐私又需要高效整理知识的人来说，Logseq+cpolar 的组合，既保留了「数据自主」的核心需求，又补齐了「远程访问」的使用痛点，不管是学生、职场人还是自由创作者，都能把知识管理的效率拉满，不用再在「数据安全」和「使用便利」之间做选择。

好助理真的是不用操心的。获得好助理的方法就在下面！

本文将带你从零开始上手 Logseq，逐步掌握其核心功能——从安装配置、创建第一条笔记，到熟练运用双向链接、查询语法与图谱分析，助你打造一个真正属于自己的、可长期演进的第二大脑。无论你是学生、研究者，还是终身学习者，Logseq都可能成为你数字工作流中不可或缺的一环。

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）登录：

ssh root@IP

2.2验证docker是否开启

使用命令：

docker -v 
systemctl status -v

3.部署Logseq

通过Docker部署Logseq：

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

docker --version

下载镜像并运行容器：

docker run -d --rm -p 9090: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步骤：

使用一键脚本安装命令：

sudo curl https://get.cpolar.sh | sh

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

sudo systemctl 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是一款支持大纲笔记与双向链接、数据完全本地存储的开源知识管理工具。

文章从安装、界面介绍、基本操作（如创建页面、块、嵌套大纲）、使用双向链接建立知识网络，到高级技巧（如查询语法、模板、任务管理）逐步引导用户上手，并强调其隐私安全、离线可用、兼容Markdown和Org-mode等优势，适合追求自主可控、构建个人第二大脑的用户。

Logseq是一个本地优先、支持大纲编辑与双向链接的免费开源笔记工具，帮助用户高效构建个人知识网络。