自建Logseq知识库极空间NAS部署并通过cpolar实现随时随地访问前言如果只是想找一个“写字的地方”现在能选的笔记软件实在太多了。Logseq 比较特别的地方并不是界面有多漂亮也不是功能堆得有多满而是它从一开始就把重点放在了另外几件事上本地优先、纯文本存储、大纲式记录以及笔记之间的双向链接。它的使用逻辑和传统文档型笔记不太一样。很多时候不是先新建一篇完整文章再从头写到尾而是把每天想到的内容拆成一个个 Block用缩进建立层级再通过[[页面名]]或块引用把分散的信息连接起来。时间长了以后原本散落在不同日期、不同主题里的内容会逐渐形成一套能够相互引用的知识网络。这也是我觉得 Logseq 值得折腾的地方。它更适合长期积累而不是单纯追求一次把笔记整理得特别漂亮。读书时记下的一句话、项目里碰到的一个问题、临时想到的一个点子甚至一条待办事项都可以先放进去以后再通过页面、标签和链接重新组织。数据又以 Markdown 或 Org-mode 这类文本形式保存相比完全依赖某个云端平台的笔记系统文件本身更容易掌握在自己手里。这篇实际做法还有一点不同我没有只在电脑上安装 Logseq而是把它部署到了极空间上。在已经开启 Docker 的极空间里通过容器运行 Logseq Web App并把服务映射到 9090 端口。这样在家里的局域网中只需要使用浏览器访问极空间IP:9090就可以打开 Logseq。对于本来就有 NAS、希望把一些自建服务集中放在一台常开设备上的用户来说这种部署方式会比每台电脑分别维护一套环境更方便。不过部署到 NAS 之后同样会碰到一个很现实的问题IP:9090仍然只是局域网地址。人在家里没有问题一旦换成公司的网络、手机流量或者出门在外这个入口就无法直接访问。所以这套方案后面又加入了 cpolar 内网穿透把运行在极空间上的 9090 Web 服务映射到公网。这样 Logseq 本身仍然运行在自己的设备上但在外面也能通过浏览器访问。如果只是临时测试可以先使用随机公网地址如果准备长期作为个人知识库使用还可以继续配置固定二级子域名让访问地址保持不变。这篇文章主要记录的就是这样一套组合Logseq 负责知识记录和连接Docker 负责让它稳定运行在极空间上远程访问部分再单独解决。比较适合已经有 NAS或者希望自己管理笔记服务、又需要在不同地点访问知识库的用户。1.什么是LogseqLogseq是一款开源、本地优先、隐私友好的知识管理与笔记工具专为构建个人知识库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登录sshrootIP2.2验证docker是否开启使用命令docker-vsystemctl status-v3.部署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 什么是cpolarcpolar是一款安全高效的内网穿透工具无需公网IP或复杂配置只需一条命令即可将本地服务器、Web服务或任意端口映射到公网让你随时随地远程访问内网应用特别适合开发调试、远程运维和应急部署等场景。5.2 部署cpolarcpolar 可以将你本地电脑中的服务如 SSH、Web、数据库映射到公网。即使你在家里或外出时也可以通过公网地址连接回本地运行的开发环境。❤️以下是安装cpolar步骤使用一键脚本安装命令sudocurlhttps://get.cpolar.sh|sh安装完成后执行下方命令查看cpolar服务状态如图所示即为正常启动sudosystemctl status cpolarCpolar安装和成功启动服务后在浏览器上输入虚拟机主机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 服务再通过 cpolar 把 9090 端口开放到外网就能在不同网络环境下继续访问自己的知识库。这套方案也有自己的适用范围。Logseq 的大纲和 Block 思维需要一定适应时间如果平时更习惯传统长文档或者多人实时协作它未必就是最顺手的选择。NAS 部署也意味着需要自己维护 Docker、服务状态和数据备份不能因为数据放在自己的设备上就忽略备份这件事。如果本来就喜欢本地优先的笔记方式又有一台长期在线的极空间或其他 Docker 设备这种部署思路还是比较顺的。至于 Logseq 的大纲结构和双向链接是否真的适合自己的记录习惯最好实际用上一段时间再判断。