基于Joplin和Joplin Server搭建私有云笔记在现实操教程

简介

Joplin 是一个开源的笔记工具，拥有 Windows/macOS/Linux/iOS/Android/Terminal 版本的客户端。

我们知道，多端同步功能是笔记工具最重要的功能。只有实现了多端同步，我们才能在工作电脑和手机之间无缝切换笔记体验。Joplin 在同步上做得不错，支持 Dropbox、OneDrive 和 AWS s3（当然国内都没法用），支持 WebDAV 协议，也支持自家的 Joplin Server。

本文介绍如何在自己的服务器上搭建 Joplin Server，并配置好 Joplin Desktop 的同步功能。

官方主页：https://joplinapp.org/

特色

• 免费开源
• 桌面、移动和终端应用程序。
• 用于 Firefox 和 Chrome 的Web Clipper 。
• 端到端加密 (E2EE)。
• 注意历史记录（修订）。
• 与各种服务同步，包括 Nextcloud、Dropbox、WebDAV 和 OneDrive。
• 首先离线，因此即使没有互联网连接，设备上的全部数据也始终可用。
• 导入 Enex 文件（Evernote 导出格式）和 Markdown 文件。
• 导出 JEX 文件（Joplin 导出格式）和原始文件。
• 支持笔记、待办事项、标签和笔记本。
• 按多个标准对笔记进行排序 – 标题、更新时间等。
• 支持移动和桌面应用程序中的警报（通知）。
• Markdown 笔记，在桌面和移动应用程序中使用图像和格式呈现。支持数学符号和复选框等额外功能。
• 可选择 Markdown 和富文本 (WYSIWYG) 编辑器。
• 文件附件支持 – 显示图像，链接其他文件并可在相关应用程序中打开。
• PDF、视频和音频文件的内联显示。
• 转到任何功能。
• 搜索功能。
• 地理位置支持。
• 支持多种语言。
• 外部编辑器支持 – 在 Joplin 中一键在您最喜欢的外部编辑器中打开笔记。
• 通过插件和数据 API 实现的可扩展功能。
• 自定义 CSS 支持自定义呈现的降价和整体用户界面。
• 可定制的布局允许切换、移动和调整各种元素的大小。
• 键盘快捷键是可编辑的，并允许将大多数 Joplin 命令与导出/导入功能绑定

预览

安装

安装Joplin

官方安装文档：https://joplinapp.org/help/#installation

在 Windows 上，您也可以使用便携式版本。便携式应用程序允许在诸如 USB 密钥的便携式设备上安装软件。只需将文件 JoplinPortable.exe 复制到该 USB 密钥上的任何目录中即可；然后，应用程序将在可执行文件旁边创建一个名为“JoplinProfile”的目录。

在 Linux 上，推荐的方法是使用以下安装脚本，因为它也会处理桌面图标：

wget -O - https://raw.githubusercontent.com/laurent22/joplin/dev/Joplin_install_and_update.sh | bash

apk安装：点我下载

windows安装：点我下载

安卓谷歌商店：点我直达

苹果 app store ：点我直达

安装 Joplin Server

提前安装好Docker，然后创建 Joplin Server 配置文件

cd /home/app
mkdir joplin
cd joplin
vim .env

复制一下内容进去保存，https://your-sample-url 替换为需要绑定的域名

APP_BASE_URL=https://your-sample-url/
APP_PORT=22300

Joplin Server 推荐使用 PostgreSQL 数据库，但是一般小配置的服务器在额外装个数据库会运行补流程，所以上面的配置就是直接默认启用 SQLite 数据库，由于采用了 SQLite 数据库，而 Docker 默认每次运行都会使用隔离的资源，这回导致之前的同步内容丢失，我们需要考虑数据持久化的问题，因此需要创建一个 Docker Volume：

# 创建名为 joplin 的 volume
# docker volume create joplin
joplin

然后我们使用下面的命令查看 volume 是否创建成功，可以看到，volumns 文件夹位于 /var/lib/docker 中：

root:~# docker volume inspect joplin
[
    {
        "CreatedAt": "2022-05-15T12:41:50+08:00",
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/joplin/_data",
        "Name": "joplin",
        "Options": {},
        "Scope": "local"
    }
]

下面的命令在后台运行 Joplin Server，名称为 joplin_server，绑定端口为 22300，并把容器的 /home/joplin 绑定到 joplin 这个 volume：

docker run -d --name joplin_server -v joplin:/home/joplin --env-file /home/app/joplin/.env -p 22300:22300 joplin/server:latest

使用下面的命令查看运行状态：

root:~# docker ps -a

CONTAINER ID   IMAGE                             COMMAND                  CREATED              STATUS          PORTS                                                                                  NAMES
dc328bdf6bb5   joplin/server:latest              "tini -- node dist/a…"   About a minute ago   Up 52 seconds   0.0.0.0:22300->22300/tcp, :::22300->22300/tcp                                          joplin_server

重启容器：

docker container restart joplin_server

配置 Nginx 反代，建议使用宝塔服务器或者是 Nginx Proxy Manager 进行操作，或者直接修改配置文件：

server {
        server_tokens off;
        root /srv/www/html;
        index index.html index.htm;
        server_name your-domain
        client_max_body_size 100m;

        location / { try_files $uri $uri/ @joplin; }
        location @joplin {
                proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                proxy_set_header X-Forwarded-Proto $scheme;
                proxy_set_header Host $http_host;
                proxy_redirect off;
                proxy_pass http://localhost:22300;
        }
}

然后访问域名，使用默认的账户名和密码登录，然后修改账号和密码即可：

默认用户名：admin@localhost 
默认密码：admin 

安装 Joplin 应用程序后，先配置语言为中文界面，首先打开Joplin，可以看到顶栏上有个tool菜单 点击后弹出菜单里面有个Option选项，点击它，弹出配置菜单，选择中文：

打开，然后打开同步部分。在这个界面中，选择“ Joplin Server ”作为同步目标，然后输入URL 和你的用户名和密码，然后在检查一下配置，如果显示“成功，同步配置看起来没有问题”就可以了。

设置完成后，Joplin Server 允许您同步设备、发布笔记或与其他 Joplin Server 用户在笔记本上协作。

拓展

插件库：https://github.com/joplin/plugins/blob/master/README.md#plugins

此存储库包含以下插件：