axboy/leanote

蚂蚁笔记 Docker 镜像

镜像概述和主要用途

本镜像用于快速部署蚂蚁笔记(Leanote)服务，提供多种版本满足不同需求。内置数据库版基于mongo:3.2构建，数据已初始化完毕，可直接使用；无数据库版需自行配置外部MongoDB；精简版仅包含核心程序，适合客户端用户使用。

核心功能和特性

• 多版本选择：完整功能（内置数据库）、完整功能（无数据库）、精简版（仅程序）
• 数据持久化：支持配置文件、上传文件、数据库数据等目录映射
• 灵活配置：可自定义数据库连接、时区等参数
• 快速部署：内置数据库版无需额外配置，开箱即用

版本选择

数据库配置（nodb版使用）

初始化数据库

参考https://github.com/leanote/leanote/wiki/Leanote-%E4%BA%8C%E8%BF%9B%E5%88%B6%E7%89%88%E8%AF%A6%E7%BB%86%E5%AE%89%E8%A3%85%E6%95%99%E7%A8%8B----Mac-and-Linux#3-%E5%AF%BC%E5%85%A5%E5%88%9D%E5%A7%8B%E6%95%B0%E6%8D%AE%E5%AE%8C%E6%88%90%E6%95%B0%E6%8D%AE%E5%BA%93%E5%88%9D%E5%A7%8B%E5%8C%96%E3%80%82

配置文件修改

导入数据库后，修改配置文件app.conf中的数据库连接信息：

conf
# MongoDB配置
db.host=192.168.1.20  # MongoDB主机地址
db.port=27017         # MongoDB端口
db.dbname=leanote     # 数据库名称（必填）
db.username=          # 数据库用户名（如无则留空）
db.password=          # 数据库密码（如无则留空）
# 或使用MongoDB连接URL（适用于复杂配置）
# db.url=mongodb://myuser:mypass@localhost:40001,otherhost:40001/mydb
# db.urlEnv=${MONGODB_URL}  # 从环境变量获取连接URL

数据目录简介

为方便配置修改和数据迁移，建议映射以下目录：

/data/db                # 内置MongoDB数据目录（仅full版有）
/data/leanote/conf      # 蚂蚁笔记配置文件目录
/data/leanote/files     # 笔记内上传的图片、文件存放目录
/data/leanote/public/upload     # 用户头像上传路径

使用方法

运行容器（full版示例）

bash
docker run -d --name leanote \
    -v `pwd`/db:/data/db \
    -v `pwd`/conf:/data/leanote/conf \
    -v `pwd`/files:/data/leanote/files \
    -v `pwd`/upload:/data/leanote/public/upload \
    -p 9000:9000 \
    docker.xuanyuan.run/axboy/leanote

备份数据

方案一：文件备份

直接备份映射的目录文件（推荐）。优点：包含所有数据（数据库+上传文件）；缺点：数据库版本大更新时可能不兼容（如mongo:3.2到3.4）。

方案二：管理后台备份

使用管理员账号登录管理后台进行备份。缺点：lite版不支持。

方案三：MongoDB命令备份

使用mongodump工具备份数据库。需注意：仅备份数据库，不包含上传文件。

修改时区

默认时区为北京时间，如需修改，可在容器内执行：

bash
ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
echo "Asia/Shanghai" > /etc/timezone

常见问题

2.6版启动后无法访问

2.6版默认绑定localhost，需修改配置文件app.conf：

conf
http.addr=0.0.0.0  # 监听所有IP地址

修改后重启容器。

初始用户

• 管理员用户：用户名admin，密码abc123（建议登录后立即修改密码）
• 演示用户：用户名demo@leanote.com，密码demo@leanote.com（仅供体验）

MongoDB升级

从基于MongoDB 3.2的旧版本（如2.6.1）升级到新版本（MongoDB 4.2.7）时，直接映射数据目录会导致启动失败，需按以下步骤操作：

1. 使用管理员账号登录旧版本，通过管理后台备份数据库并下载备份文件
2. 启动新版本容器：

   bash
   docker run -d --name new_leanote -p 9000:9000 docker.xuanyuan.run/axboy/leanote
   

3. 拷贝备份文件到新容器：

   bash
   docker cp ~/download/backup_leanote_1602120903 new_leanote:/
   

4. 进入容器恢复数据：

   bash
   docker exec -it new_leanote bash
   mongorestore -h localhost -d leanote --dir /backup_leanote_1602120903/ --drop
   

补充

自定义数据库配置可参考布宝的慕课手记。