【一款超好用的开源笔记Logseq本地Docker部署与远程使用指南】

在开始今天的分享之前，我想先推荐一篇非常精彩的文章。 文章就是《渗透测试文件包含漏洞原理与验证(1)——文件包含概述》🚀🌟🚀🌟🚀🌟 链接是：点击这里。 这篇文章详细解释了文件包含漏洞的原理，以及如何在实际的 Web 应用程序中发现和验证这类漏洞。它提到，文件包含漏洞通常发生在 PHP 等脚本语言中，当开发者在引入文件时没有对文件名进行充分的校验，就可能导致意外的文件泄露或恶意代码注入。 文章还介绍了几种 PHP 中的文件包含函数，包括include()、include_once()、require()和require_once()，以及它们在找不到文件时的不同行为。此外，文章还探讨了利用文件包含漏洞的条件，比如函数通过动态变量引入文件，以及用户能够控制这个动态变量。 通过一些实际的示例，文章展示了如何通过修改文件扩展名来绕过某些安全限制，以及如何通过修改 URL 参数来实现文件包含攻击。 这篇文章不仅提供了丰富的技术细节，还强调了合法合规的重要性。它提醒我们，所有的渗透测试活动都应该在获得明确授权的情况下进行，并且要遵守相关法律法规。 如果你对 Web 安全感兴趣，或者想要提高你的 Web 应用程序的安全性，我强烈推荐你阅读这篇文章。它不仅能够提供实用的技术知识，还能帮助你更好地理解安全领域的法律和道德规范。让我们一起在合法合规的前提下，探索和提升 Web 安全吧！

前言

本文主要介绍如何在本地 Linux 服务器使用 Docker 快速部署一款超好用的开源笔记 Logseq，并结合 cpolar 内网穿透工具轻松实现远程访问与使用该笔记的详细操作指南。

在日常工作和学习中，我们都或多或少接触并使用过笔记软件来记录要点与提高效率。但市面上虽然有不少知识管理工具，但它们要么价格昂贵，要么功能单一，很难满足个性化的知识管理需求。同时，数据安全和长期可用性也是一个重要的考虑因素。

最近在 github 发现了一款高达 33.8K 星的开源笔记软件 Logseq，它提供了一系列强大的知识管理、协作、PDF 注释和任务管理工具，支持多种文件格式，包括 Markdown 和 Org-mode，以及用于组织和构建笔记的各种功能。而且作为一款优秀的知识管理和协作平台，它还专注于保护隐私、长期可用性和数据安全。

Logseq 提供了多个平台的客户端支持，支持 macOS(Intel/M1)、Windows、Linux 系统，桌面端用户下载对应系统的安装包后直接安装运行。移动端可以通过 App Store 安装或其官网获取安卓 APK 进行下载安装，支持与桌面端数据同步。

而在本例中为大家演示的是，如何在 Linux 系统中使用 Docker 快速部署，然后通过浏览器进行访问，同样非常简单，下面就来进行具体操作。

image-20241218144821491

image-20241218145434393

1. 安装 Docker

本例使用 Ubuntu 22.04 进行演示，使用 Docker 进行部署，如果没有安装 Docker，可以查看这篇教程进行安装：《Docker 安装教程——Linux、Windows、MacOS》

打开终端执行这行命令启动容器即可：

sudo docker run -d --rm -p 8010:80 ghcr.io/logseq/logseq-webapp:latest

现在就已经部署完毕了，打开 Web 浏览器输入 localhost:8010，就可以访问到 Logseq 笔记的 web 页面了。

2. 简单使用演示

首次登录后为英文界面，我们可以点击右上角设置按钮，先将语言修改为简体中文：

image-20241218145635328

在这里也可以修改主题模式，Accent color 等常规设置。而在下面的编辑器设置中，我们可以修改首选文件格式是使用 Markdown 还是 Org。

image-20241218150017722

还有一些其他设置功能，大家可以根据自己喜好进行调整。

image-20241218155127163

作为一款超好用的笔记软件，Logseq 支持大纲，双向链接，本地存储。想要开始使用笔记，我们首先需要设置本地文件夹用来存储笔记。不同的浏览器因为兼容问题可能识别不到创建按钮，我这里使用的是谷歌浏览器，可以正常显示，点击右上角的添加图谱，跳转后点击Choose a folder ，然后选择本地用来保存笔记的文件夹即可。

image-20241218155412884

完成之后，就可以点击左下角的新建，开始编辑笔记了：

image-20241218155859675

而在刚才创建的本地文件夹中，我们可以看到生成了 3 个目录，/journals - 保存你的日记，/logseq - 保存配置，/pages - 保存其他页面。

image-20241218160001256

更多 Logseq 笔记使用相关的说明可以点击右上角的展开侧边栏按钮，然后点击帮助即可看到详细的使用说明：

image-20241218160940587

3. 安装 cpolar 内网穿透

Logseq 的开源特性和强大功能让它成为了一个理想的知识管理工具。无论是用于学习笔记整理、项目文档管理还是个人知识库构建，都能带来更高效、更有条理的工作体验。不过我们目前只能在本地局域网内访问刚刚部署的笔记，如果想不在同一局域网内时，也能在外部网络环境使用手机、平板、电脑等设备远程访问它来记笔记，应该怎么办呢？我们可以使用 cpolar 内网穿透工具来实现远程访问的需求。无需公网 IP，也不用设置路由器那么麻烦。

下面是安装 cpolar 步骤：

Cpolar 官网地址: https://www.cpolar.com

使用一键脚本安装命令：

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

img

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

sudo systemctl status cpolar

img

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

image-20240801133735424

4. 配置公网地址

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

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

点击创建：

image-20241218161037657

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

image-20241218161145367

如下图所示，现在就已经成功实现使用公网地址异地远程访问本地部署的 Logseq 笔记随时随地记笔记啦。同样，你需要在当前使用的设备上创建一个本地文件夹，来保存你的笔记。

image-20241218161442276

小结

为了方便演示，我们在上边的操作过程中使用 cpolar 生成的 HTTP 公网地址隧道，其公网地址是随机生成的。这种随机地址的优势在于建立速度快，可以立即使用。然而，它的缺点是网址是随机生成，这个地址在 24 小时内会发生随机变化，更适合于临时使用。

如果有长期使用 Logseq 笔记，或者异地访问与使用其他本地部署的服务的需求，但又不想每天重新配置公网地址，还想让公网地址好看又好记并体验更多功能与更快的带宽，那我推荐大家选择使用固定的二级子域名方式来配置公网地址。

5. 配置固定公网地址

由于以上使用 cpolar 所创建的隧道使用的是随机公网地址，24 小时内会随机变化，不利于长期远程访问。因此我们可以为其配置二级子域名，该地址为固定地址，不会随机变化。

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

image-20241218161711350

保留成功后复制保留的二级子域名地址：

image-20241218161750793

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

image-20241218161912673

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

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

点击更新

image-20241218161956129

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

image-20241218162059210

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

image-20241218163841293

更多项目详情可以访问作者 github 项目主页：https://github.com/logseq/logseq

以上就是如何在本地 Ubuntu 系统使用 Docker 快速部署开源笔记 Logseq，并安装 cpolar 内网穿透工具配置固定不变的二级子域名公网地址，实现随时随地远程远程在线记笔记的全部流程，感谢您的观看，有任何问题欢迎留言交流。