前言
在信息爆炸的时代，如何高效地记录、组织和连接知识，成为每个学习者与思考者的核心挑战。传统的笔记工具往往局限于线性书写，难以反映思想之间的复杂关联；而云端笔记虽功能强大，却常伴随隐私顾虑与平台依赖风险。Logseq作为一款开源、本地优先、支持大纲笔记与双向链接的知识管理工具，正为这一困境提供优雅的解决方案。它以纯文本（Markdown 或 Org-mode）存储数据，确保你的知识资产完全由你掌控；通过块（Block）级引用与图谱视图，让想法自由交织、灵感自然涌现；其独特的层级大纲结构，更契合人类思维的展开方式，无论是读书笔记、项目规划，还是个人知识库构建，都能游刃有余。
本文将带你从零开始上手 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
没有ssh的小伙伴可以参考这篇文章：
连接成功：极空间别再吃灰了！开启SSH，秒变全能服务器！ – cpolar 极点云官网
2.2验证docker是否开启
使用命令：
docker -v
systemctl status -v
没有docker的小伙伴可以参考这篇文章：极空间开箱实录：从拆箱到远程访问保姆级教程，30分钟上手！ – cpolar 极点云官网
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为其配置二级子域名（cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站），该地址为固定地址，不会随机变化。
点击左侧的预留，选择保留二级子域名，地区选择china Top，然后设置一个二级子域名名称，我使用的是logseq，大家可以自定义。填写备注信息，点击保留。
登录cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道，点击右侧的编辑。
修改隧道信息，将保留成功的二级子域名配置到隧道中
- 域名类型：选择二级子域名
- Sub Domain：填写保留成功的二级子域名
- 地区: China Top
点击更新
更新完成后，打开在线隧道列表，此时可以看到随机的公网地址已经发生变化，地址名称也变成了保留和固定的二级子域名名称。
最后，我们使用固定的公网地址在任意设备的浏览器中访问，可以看到成功访问的页面，这样一个永久不会变化的二级子域名公网网址即设置好了。
总结
Logseq是一款支持大纲笔记与双向链接、数据完全本地存储的开源知识管理工具。
文章从安装、界面介绍、基本操作（如创建页面、块、嵌套大纲）、使用双向链接建立知识网络，到高级技巧（如查询语法、模板、任务管理）逐步引导用户上手，并强调其隐私安全、离线可用、兼容Markdown和Org-mode等优势，适合追求自主可控、构建个人第二大脑的用户。
Logseq是一个本地优先、支持大纲编辑与双向链接的免费开源笔记工具，帮助用户高效构建个人知识网络。
感谢您对本篇文章的喜爱，有任何问题欢迎留言交流。cpolar官网-安全的内网穿透工具 | 无需公网ip | 远程访问 | 搭建网站
