1. Leanote私有化笔记工具概述
Leanote是一款开源的私有化笔记工具，主打Markdown语法支持和知识管理功能。作为一款自托管的笔记解决方案，它完美解决了对数据隐私有高要求用户的痛点。我在团队知识库搭建过程中深度使用了Leanote，其清晰的Markdown渲染效果和灵活的权限管理给我留下了深刻印象。
与主流云笔记相比，Leanote最大的特点是支持完全私有化部署。所有笔记数据都存储在自己的服务器上，避免了敏感信息外泄的风险。同时它提供了：
- 完整的Markdown编辑体验（支持GFM标准）
- 笔记分类与标签系统
- 团队协作功能
- 历史版本管理
- 多端同步能力
最新版Leanote基于Golang开发，后端使用MongoDB存储数据，这使得它在处理大量笔记时依然保持流畅的性能表现。接下来我将详细介绍从下载到配置的完整流程。
2. 环境准备与依赖安装
2.1 系统要求检查
在开始安装前，请确保系统满足以下条件：
- Windows 7及以上版本（本文以Win10为例）
- 至少2GB可用内存
- 5GB以上磁盘空间
- 管理员权限账户
提示：虽然官方文档提到32位系统，但当前主流环境建议使用64位系统。所有下载链接我会相应更新为64位版本。
2.2 必要组件下载
需要预先安装的组件及下载地址：
| 组件 | 版本 | 下载地址 |
|---|---|---|
| Golang | 1.20+ | 官网下载 |
| MongoDB | 6.0+ | 社区版下载 |
| Leanote源码 | 最新版 | GitHub仓库 |
实测发现，直接使用官方提供的旧版组件链接经常出现404错误。上述地址均为当前（2023年）可用的最新版本下载渠道。
3. 详细安装步骤
3.1 Golang环境配置
运行下载的go安装包（如go1.20.4.windows-amd64.msi）
使用默认设置完成安装（建议保持C:\Go路径）
验证安装：打开CMD执行：
go version应显示类似
go version go1.20.4 windows/amd64的版本信息配置环境变量：
- 新建系统变量
GOPATH，值设为C:\Users\你的用户名\go - 在Path中添加
C:\Go\bin
- 新建系统变量
3.2 MongoDB安装与配置
- 运行MongoDB安装程序
- 选择"Complete"安装类型
- 取消勾选"Install MongoDB Compass"（非必须组件）
- 创建数据目录：
md C:\data\db - 启动MongoDB服务：
保持此CMD窗口运行（最小化即可）mongod --dbpath C:\data\db
常见问题：若提示"mongod不是命令"，需将MongoDB的bin目录（如C:\Program Files\MongoDB\Server\6.0\bin）添加到系统Path变量
3.3 Leanote源码部署
- 解压下载的leanote-all-master.zip
- 将解压后的src文件夹复制到GOPATH下的src目录：
C:\Users\你的用户名\go\src\github.com\leanote - 导入初始数据：
mongorestore -h localhost -d leanote --dir C:\Users\你的用户名\go\src\github.com\leanote\leanote\mongodb_backup\leanote_install_data
4. 配置与启动
4.1 关键配置文件修改
编辑leanote/conf/app.conf：
app.secret=your_random_string # 建议改为32位随机字符串 http.port=9000 # 避免与常用端口冲突 site.url=http://localhost:90004.2 首次启动
- 安装Revel框架：
go install github.com/revel/cmd/revel@latest - 启动Leanote：
revel run github.com/leanote/leanote - 访问
http://localhost:9000使用默认账号登录：- 管理员：admin/abc123
- 体验账号：[email protected]/[email protected]
5. 安全加固与优化
5.1 数据库权限配置
- 创建管理员用户：
use leanote db.createUser({ user: "leanoteAdmin", pwd: "StrongPassword123!", roles: ["readWrite"] }) - 修改app.conf中的数据库配置：
db.username=leanoteAdmin db.password=StrongPassword123!
5.2 生产环境建议
- 使用Nginx反向代理
- 配置HTTPS证书
- 设置定期数据备份
- 启用防火墙规则限制访问IP
6. 使用技巧与高级功能
6.1 Markdown增强技巧
Leanote支持以下扩展语法：
- LaTeX数学公式
- 任务列表
- 表格增强
6.2 插件开发
通过Golang可以开发自定义插件，典型场景：
- 第三方存储对接
- 自定义导出格式
- 自动化脚本集成
我在实际使用中开发了几个实用插件：
- 本地图片自动上传到图床
- 定时备份到WebDAV
- 与Jenkins的CI/CD集成
7. 故障排查指南
7.1 常见问题解决
| 问题现象 | 解决方案 |
|---|---|
| 启动时报"auth fails" | 检查app.conf中的数据库账号密码是否与创建的一致 |
| 访问缓慢 | 增加MongoDB的wiredTiger缓存大小 |
| 上传附件失败 | 检查storage目录权限，确保可写 |
| Markdown渲染异常 | 清除浏览器缓存或尝试其他渲染引擎 |
7.2 日志查看
关键日志文件位置：
- Leanote运行日志：控制台输出或revel日志
- MongoDB日志：默认在C:\data\db\mongod.log
8. 后续维护建议
版本升级步骤：
git pull origin master go get -u github.com/leanote/leanote revel run github.com/leanote/leanote数据备份方案：
mongodump -h localhost -d leanote -o C:\backup\leanote_$(date +%Y%m%d)性能监控指标：
- MongoDB内存使用率
- 笔记操作响应时间
- 并发连接数
经过三个月的生产环境使用，这套私有化笔记系统稳定支撑了我们团队2000+篇技术文档的管理需求。相比商业方案，自主掌控数据带来的安全感是无法替代的。
