小白必看！1小时搞定专属云笔记本：基于 Leanote 的轻松搭建指南

在腾讯云开发者社区闲逛时，我发现了一个热度超高的入门实验——《搭建个人云笔记本》。数据显示，已经有 2841 位小伙伴学完了课程，实验包含 14 个任务，总体时长仅需 1 小时，留言评论区也有 28 条互动，大家普遍反馈“通俗易懂、上手简单”。

今天这篇文章，就结合该实验的简介，跟各位开发者和笔记爱好者唠唠：如何零门槛打造一款属于自己的云笔记本（Leanote），以及它到底能给我们的工作和生活带来什么改变。

https://cloud.tencent.com/lab/courseDetail/10171?channel=c1004&sceneCode=devo

一、 为什么推荐你自己搭一个云笔记本？

市面上的笔记软件很多，但数据留在第三方平台，总归有些不方便：要么担心隐私，要么会员太贵，要么排版不合心意。而在这个实验中，官方明确提到：“本实验将带您一步步搭建属于自己的云笔记本，您将可以通过云笔记记录生活工作的点滴。” 自己动手，丰衣足食，数据完全自主掌控，岂不美哉？

二、 认识主角：Leanote 到底是什么？

根据实验简介，Leanote 是一款功能丰富的云笔记工具。它可不像传统的记事本那样单调，它自带了一系列硬核又实用的能力，特别适合程序员和技术写作者：

1. Markdown 输入：支持优雅的 MD 语法，写文档、写周报行云流水。
2. 代码高亮：作为开发者，直接把代码片段贴进去也能高亮展示，技术笔记神器。
3. 多人协作：不止自己用，还能拉上同事朋友一起完善团队知识库。
4. 笔记历史记录：手滑误删或者改错内容？翻翻历史记录就能找回来。
5. 笔记内导航：文章写长了也不怕，自带大纲导航，跳转方便。
6. 直接发布为博客：最香的一点！写完笔记点一下就能变成个人博客页面，分享给其他人看。

仅凭以上几点，Leanote 就足以成为个人知识管理的好帮手。

三、 小白友好：1 小时，14 个任务轻松拿捏

很多朋友看到“搭建”俩字就头大，觉得要敲一堆晦涩的命令。但其实这个实验定位就是“入门”级别：

• 任务拆解清晰：实验把整个过程拆成了 14 个任务，每一步该点哪里、该配什么，都给你安排得明明白白。
• 时间短：整体 1 小时实验时长，下班摸鱼或者周末抽出一小块时间就能搞完。
• 社区氛围好：有 2841 人已经跑通过，还有 28 条实验评论可以蹲别人的踩坑经验，简直是保姆级教学。

跟着实验的指引，你不需要是运维大佬，也能在自己的服务器或云端环境上把 Leanote 跑起来。

四、开始实验搭建

点击窗口右侧蓝色的【立即实验】按钮，在向导指导下，就可以启动搭建过程

实验目录

1. 相关概念

2. 下载 MongoDB

3. 创建用于存储的文件夹目录

4. 配置 MongoDB 的环境变量

5. 启动 MongoDB

6. 下载 Leanote

7. 编辑 Leanote 配置文件

8. 初始化数据库

9. 启动 Leanote 服务

10. 通过 ip 访问笔记本

11. 域名注册

12. 域名解析

13. 通过域名访问笔记本

14. 大功告成

下面为你逐条解读每个步骤的含义、目的和关键点：

1. 相关概念

• MongoDB: 一种非关系型数据库（NoSQL）。这里用来存储你笔记的内容、标签、附件等所有数据。它像一个仓库，专门存放笔记数据。
• Leanote: 一个开源的云笔记服务端程序。它提供了网页版编辑器、客户端和API，让你可以像使用商业笔记软件一样写笔记，但数据完全由自己掌控。
• 环境变量: 操作系统中的一些全局变量。配置后，你在命令行输入 mongo 或 mongod 时，系统能自动找到这些程序所在的文件夹，而不需要每次都输入完整路径。
• 域名解析: 将一串好记的网址（如 note.yourname.com）指向你服务器的公网IP地址。这样别人（或你自己）通过域名就能访问，而不是记一串数字IP。

2. 下载 MongoDB (下载 MongoDB)

• 目的: 从MongoDB官网获取数据库软件安装包。
• 关键点: 注意选择与你的服务器操作系统（Linux、Windows、macOS）和系统架构（x64、ARM）匹配的版本。

3. 创建用于存储的文件夹目录 (创建用于存储的文件夹目录)

• 目的: 为MongoDB的数据库文件（数据文件）和日志文件建立专门的存放位置。
• 示例: 通常创建类似 /data/db (Linux) 或 C:\data\db (Windows) 的文件夹。这是MongoDB默认的数据存储路径，也可以自定义。

4. 配置 MongoDB 的环境变量 (配置 MongoDB 的环境变量)

• 目的: 让系统知道MongoDB的可执行文件（如 mongod.exe 或 mongod）在哪个路径下。
• 操作: 将MongoDB安装目录下的 bin 文件夹路径添加到系统的 PATH 环境变量中。配置后，在任意目录下都能直接运行命令。

5. 启动 MongoDB (启动 MongoDB)

• 目的: 运行MongoDB数据库服务，使其开始监听端口，等待数据读写请求。
• 命令: 通常执行 mongod 或 mongod --dbpath <你创建的文件夹路径>。启动成功后，MongoDB会默认占用 27017 端口。

6. 下载 Leanote (下载 Leanote)

• 目的: 从Leanote官方或GitHub获取服务端程序包（通常是压缩包，如 leanote-linux-amd64.v2.6.1.tar.gz）。
• 关键点: 下载后需要解压，放在一个固定的目录下（如 /opt/leanote 或 C:\leanote）。

7. 编辑 Leanote 配置文件 (编辑 Leanote 配置文件)

• 目的: 让Leanote知道自己应该连接哪个数据库（MongoDB）、监听哪个端口（默认是9000）、以及配置其他如邮箱、OAuth等设置。
• 关键文件: 通常是 conf/app.conf。
• 关键修改项:
  • db.host、db.port、db.db_name：指向你刚启动的MongoDB服务。
  • app.secret：建议修改为一个随机字符串，用于会话加密。
  • http.port：默认是 9000。

8. 初始化数据库 (初始化数据库)

• 目的: 将Leanote官方提供的默认数据（包括管理员账号、默认笔记、示例数据等）导入到MongoDB中。
• 操作: 通常使用 mongorestore 命令，将Leanote目录下 mongodb_backup/leanote_install_data 文件夹中的数据恢复到MongoDB。

9. 启动 Leanote 服务 (启动 Leanote 服务)

• 目的: 运行Leanote的Web服务程序。
• 命令: 进入Leanote的 bin 目录，执行 ./run.sh (Linux/mac) 或 run.bat (Windows)。启动后，Leanote会监听你配置的端口（如9000）。

10. 通过 ip 访问笔记本 (通过 ip 访问笔记本)

• 目的: 验证本地部署是否成功。
• 操作: 在浏览器输入 http://<你的服务器公网IP>:9000。如果看到Leanote的登录页面，说明服务运行正常。
• 默认管理员账号: admin，密码：abc123（建议立即修改）。

11. 域名注册 (域名注册)

• 目的: 购买一个你自己的域名（如 yourname.com），以便后续使用个性化网址访问笔记。
• 平台: 可以在阿里云、腾讯云、GoDaddy等域名注册商处购买。

12. 域名解析 (域名解析)

• 目的: 将你购买的域名（如 note.yourname.com）指向你服务器的公网IP地址。
• 操作: 在域名注册商的管理后台，添加一条 A记录，将域名指向你的服务器IP。例如：note 指到 123.123.123.123。

13. 通过域名访问笔记本 (通过域名访问笔记本)

• 目的: 最终配置完成后，用域名代替IP地址进行访问。
• 操作: 在浏览器输入 http://note.yourname.com:9000。如果配置了反向代理（如Nginx），甚至可以去掉端口号，直接访问 http://note.yourname.com。

14. 大功告成 (大功告成)

• 总结: 经过以上步骤，你已经成功搭建了一个属于自己的、可公网访问的私有云笔记系统。
• 后续建议:
  • 配置反向代理（Nginx）: 实现端口转发、HTTPS加密（使用Let's Encrypt免费证书）、提高安全性。
  • 配置开机自启: 设置MongoDB和Leanote随系统自动启动，避免重启后服务失效。
  • 定期备份: 定期备份MongoDB数据库，防止数据丢失。

五、 搭建完成后，你能做什么？

当你跟着实验任务把 Leanote 搭建好之后，你的数字生活可能会发生这些小变化：

• 把每天的工作复盘、学习心得写进 Markdown 笔记，代码高亮让笔记逼格满满；
• 和家人朋友创建一个共享笔记本，用来规划旅行攻略（多人协作）；
• 把某篇深度教程一键发布成博客，秀一把技术肌肉；
• 再也不用担心笔记软件突然停服，因为服务和数据都在你手里。

五、 结语

如果你想拥有一款集笔记、协作、博客于一体的全能工具，又苦于没有合适的入门途径，强烈推荐去腾讯云开发者社区搜索 《搭建个人云笔记本》 这个实验。跟着 14 个任务走，1 小时拥有专属 Leanote，开启高效记录的新生活！

本文根据腾讯云开发者社区相关实验简介整理，旨在为小白同学提供上手指引。祝大家搭建顺利，笔记满满！

（欢迎在评论区交流你的 Leanote 搭建体验，或者分享你的私人云笔记玩法～）