Leanote 源码版详细安装教程 Mac and Linux - wiselike/leanote-of-unofficial GitHub Wiki

本教程适合 Mac 及 linux 用户的源码版安装。

leanote 开发版(源码)适合开发人员,或需要快速更新功能的朋友。

  • Mac, Linux 用户的二进制版安装,参见这里

安装步骤:

  1. 安装Golang
  2. 获取RevelLeanote的源码。
  3. 安装Mongodb
  4. 导入初始数据。
  5. 使用Revel运行Leanote

1. 安装 golang

golang.org 官网下载最新版的golang, Leanote至少需要golang 1.15。如果被墙, 可以在 http://golangtc.com/download 下载。

假设将文件下载到 /home/user1 下, 解压文件:

$> cd /home/user1
$> tar -xzvf go1.15.linux-amd64.tar.gz

/home/user1 下新建一个目录gopackage, 这里面会放go的包和编译后的文件:

$> mkdir /home/user1/gopackage

配置环境变量, 编辑/etc/profile文件:

$> sudo vim /etc/profile

此处使用了vim文字编辑器,你可以使用自己喜欢的其他编辑器。在 /etc/profile 中添加以下几行:

export GOROOT=/home/user1/go
export GOPATH=/home/user1/gopackage
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

保存修改后,在终端运行以下命令使环境变量生效:

$> source /etc/profile

查看go是否安装成功:

$> go version

若出现类似以下信息证明安装成功

go version go1.15 linux/amd64

2. 获取RevelLeanote 的源码

请下载 leante.zip。解压后,将文件夹复制到 /home/user1/

使用如下命令生成revel二进制命令, 稍后运行Leanote需要用到:

$> go get -u github.com/revel/cmd/revel
$> revel version # 看是否是1.0.0 如果低于1.0.0 则无法运行Leanote

下载完成后,Leanote的源码在/home/user1/leanote下。

3. 安装Mongodb

3.1 安装Mongodb

Mongodb 官网 下载相应系统的最新版安装包,或者从以下链接下载旧版本:

下载到 /home/user1下, 直接解压即可:

$> cd /home/user1
$> tar -xzvf mongodb-linux-x86_64-3.0.1.tgz/

为了快速使用mongodb命令, 可以配置环境变量。编辑 ~/.profile/etc/profile 文件, 将mongodb/bin路径加入即可:

$> sudo vim /etc/profile

此处实例使用了vim文本编辑器,你可以使用自己熟悉的编辑器。

/etc/profile中添加以下行,注意把用户名(user1)和相应的文件目录名(mongodb-linux-x86_64-3.0.1)替换成自己系统中的名称:

export PATH=$PATH:/home/user1/mongodb-linux-x86_64-3.0.1/bin

保存修改后,在终端运行以下命令使环境变量生效:

$> source /etc/profile

3.2 测试Mongodb安装

先在/home/user1下新建一个目录data存放Mongodb数据:

mkdir /home/user1/data

用以下命令启动mongod:

mongod --dbpath /home/user1/data

这时mongod已经启动,重新打开一个终端, 键入mongo进入交互程序:

$> mongo
> show dbs
...数据库列表

Mongodb安装到此为止, 下面为Mongodb导入Leanote初始数据。


4. 导入初始数据

leanote 初始数据在/home/user1/leanote/mongodb_backup/leanote_install_data中。

打开终端, 输入以下命令导入数据。

$> mongorestore -h localhost -d leanote --dir /home/user1/leanote/mongodb_backup/leanote_install_data

现在在mongodb中已经新建了leanote数据库, 可用命令查看下Leanote有多少张"表":

$> mongo
> show dbs # 查看数据库
leanote	0.203125GB
local	0.078125GB
> use leanote # 切换到leanote
switched to db leanote
> show collections # 查看表
files
has_share_notes
note_content_histories
note_contents
....

初始数据的users表中已有2个用户:

user1 username: admin, password: abc123 (管理员, 只有该用户才有权管理后台, 请及时修改密码)
user2 username: [email protected], password: [email protected] (仅供体验使用)

5. 配置Leanote

Leanote的配置存储在文件 conf/app.conf 中。

请务必修改app.secret一项, 在若干个随机位置处,将字符修改成一个其他的值, 否则会有安全隐患!

其它的配置可暂时保持不变, 若需要配置数据库信息, 请参照 Leanote问题汇总


6. 运行Leanote

注意: 在此之前请确保Mongodb已在运行!

新开一个窗口, 运行:

$> cd /home/user1/leanote
$> revel run -a .

恭喜你, 打开浏览器输入: http://localhost:9000 体验Leanote吧!


注意!!!!!!!!!!!!!!

按照本教程启动Mongodb是没有权限控制的, 如果你的Leanote服务器暴露在外网, 任何人都可以访问你的Mongodb并修改, 所以这是极其危险的!!!!!!!!!!! 请务必为Mongodb添加用户名和密码并以auth启动, 方法请见: 为mongodb数据库添加用户

leanote 安装/配置问题汇总

如果运行有问题或想要进一步配置Leanote, 请参照 Leanote问题汇总

⚠️ **GitHub.com Fallback** ⚠️