云服务器部署思源笔记教程

思源笔记是一款国产开源的双链笔记软件，具有良好的功能和使用体验。对于有云服务部署经验的人来说，它的一个重要的有点在于可以进行私有云部署，从而实现在任何平台上通过浏览器访问笔记，不仅作为学习笔记，也可以作为便签、备忘录等。以下就是部署云服务的方法：

1 云服务部署平台的准备

要进行云服务部署，首先需要一个网络可访问的部署设备。当然可以在局域网内部署，然后通过端口转发从公网访问，但是这里我们只讨论通过云服务器部署这种更简单的方式。

要用云服务部署，当然要先准备一个云服务器。这里我选择的阿里云的2核2G云服务器，完全可以流畅使用。除此之外，还可以选择预装Docker的轻量服务器（思源笔记使用Docker部署），这里官方和开发者的教程都十分多，我们就不在这里细说了。

云服务器系统建议使用Ubuntu或Debian。

添加安全组规则

这里我们只谈一点，就是设置云服务器的安全组规则。由于隐私问题，这里多数使用文字描述，敬请谅解。

以阿里云为例，在控制台中找到“安全组”-“安全组列表”，在“安全组ID”一列下点击进入。

找到“访问规则”下的“入方向”选项卡，点击“手动添加”


按图中设置，开放6806端口。不用管那个提示：


然后把这个保存起来就好。如果没起作用，重启机器即可。

2 获取思源的Docker镜像

思源笔记使用Docker部署，Docker就贴在官网的下载界面，链接：https://hub.docker.com/r/b3log/siyuan，记住这个镜像名称`b3log/siyuan`

由于一些政策原因，Docker的访问非常麻烦，因此十分不推荐直接拉取镜像，而是使用下载工具下载镜像再上传到服务器上。

这里推荐一个下载工具：https://registry.lfree.org/

当我们获得了思源的Docker镜像，就可以进行下一步了

3 容器化部署Docker

3.1 Docker的安装

现在我们先在云服务器上安装Docker。SSH到服务器以输入命令。

先更新系统：

sudo apt update && sudo apt upgrade -y

然后安装Docker：

sudo apt install docker.io

启动Docker：

sudo systemctl start docker

检查Docker状态：

sudo systemctl status docker

检查Docker版本：

sudo docker info

以上的命令都没问题即可，下面这个大概率要有问题，但是不重要。

拉取并运行Hello World镜像：

docker run hello-world

3.2 部署思源笔记

现在要把思源笔记部署上去。先把镜像传上去，用什么都行，我用的是SFTP。

cd到保存镜像的目录，我这里是~/downloads

把镜像导入到docker中，我这里已经将文件的名字改成siyuan.tar了，所以命令是：

docker load -i siyuan.tar

在家目录下面创建一个工作空间文件夹：

mkdir ~/siyuan

这个地方是用来存放笔记文件的。

然后启动容器。这里网上大多数给的命令都不对，原因是缺少一个授权码的设定，考虑可能是后面版本更新才加上的。我第一次部署用的是v3.1.28，这时候已经有这个授权码的要求了。实际上授权码就是登录密码，这个密码不设是无法登录的。

启动命令如下：

sudo docker run -d  \
	-v /home/jupiter/siyuan/workspace:/siyuan/workspace  \
    -p 6806:6806   \
    b3log/siyuan \
    --workspace=/siyuan/workspace \
    --accessAuthCode=<设置一个明文授权码>

最后一行直接换成你要设的密码就行，不用加什么引号之类的，直接写。

然后设置容器自动启动：

sudo systemctl enable docker
sudo docker update --restart unless-stopped <容器id>

4 登录访问

先获取IP地址，对于阿里云来说，这个地址一般就在控制台的第一个选项卡里，当然，要选公网那个。要用命令获取，输入：

ip addr

如果提示缺少软件包，直接安装即可。

然后排除掉192、127、0开头的IP，剩下那个就是

拿这个IP到浏览器里，输入IP地址:6806，也就是加上刚才设置的端口，输入密码即可访问