Docker 伺服

在服务器上伺服思源最简单的方案是通过 Docker 部署，镜像名称是 b3log/siyuan，目前没有版本标签，只有最新版。

文件结构

整体程序位于 /opt/siyuan/ 下，基本上就是 Electron 安装包 resources 文件夹下的结构：

appearance：图标、主题、多语言
guide：帮助文档
stage：界面和静态资源
kernel：内核程序

启动入口

构建 Docker 镜像时设置了入口：ENTRYPOINT [ "/opt/siyuan/kernel" ]，使用 docker run b3log/siyuan 并带参即可启动：

--workspace 指定工作空间文件夹路径，在宿主机上通过 -v 挂载到容器中
--resident 指定为 true 常驻内存

更多的参数可参考这里。下面是一条启动命令示例：docker run -v workspace_dir_host:workspace_dir_container -p 6806:6806 b3log/siyuan --resident=true --workspace=workspace_dir_container

workspace_dir_host：宿主机上的工作空间文件夹路径
workspace_dir_container：容器内工作空间文件夹路径，和后面 --workspace 指定成一样的

为了简化，建议将 workspace 文件夹路径在宿主机和容器上配置为一致的，比如将 workspace_dir_host 和 workspace_dir_container 都配置为 /siyuan/workspace，对应的启动命令示例：docker run -v /siyuan/workspace:/siyuan/workspace -p 6806:6806 b3log/siyuan --resident=true --workspace=/siyuan/workspace/

内核 API

打开文件夹

POST /notebook/mount，参数：

url：固定传入 http://127.0.0.1:6806/siyuan/，即 box.url
path：内核数据文件夹下的某个文件夹路径，即 box.path

关闭文件夹

POST /notebook/unmount，参数：

url：固定传入 http://127.0.0.1:6806/siyuan/，即 box.url