简介

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

此存储库包含以下插件:

主页 下载 姓名版本描述作者
🏠⬇️ABC 乐谱插件1.0.2将 ABC 文本符号转换为乐谱洛朗·科齐奇
🏠⬇️警告降价扩展1.1.0启用 markdownIt admonition 插件,启用格式化注释马西米利亚诺·马塞雷利
🏠⬇️议程3.7.1joplin 的议程/日历/日程安排面板,显示所有未完成的待办事项和截止日期。节拍链接
🏠⬇️雅典娜1.8.0将文件从导入文件夹导入到 joplin 笔记本中作为注释 mit 元数据(注释注释中的 PDF 文本,无 OCR)马卡内奥
🏠⬇️随员1.1.1您的附件更新程序。大规模替换 Joplin 附件(资源),例如调整大小的图像文件、当前音乐播放列表以及您需要在 Joplin 中一次性或定期更新的任何其他附件。马努·欧文
🏠⬇️自动报警1.0.7-rc10报警日期/时间的自然语言输入ZPH
🏠⬇️在侧边栏中自动显示活动笔记1.0.1在侧边栏中自动显示活动笔记埃亚尔
⬇️自动标记1.0.3-rc7将所有 octothorpe 前缀词转换为标签ZPH
🏠⬇️自动链接器1.0.4将图标添加到工具栏。单击时,它会创建一个指向注释的链接,其标题与所选文本匹配。S73ph4n
🏠⬇️自动化笔记1.0.2在当前注释中查找 javascript 块(块必须以 ‘ javascript' and end with '‘ 开头)并将其作为函数运行。S73ph4n
🏠⬇️需要注意的自动反向链接3.0.3以自动方式创建打开笔记的反向链接ambrt,cyingfan
🏠⬇️后台1.0.0直接从手机扫描和导入文件阿斯里恩特
🏠⬇️更好的 Markdown 查看器2.0.4在编辑器和 MD 查看器之间保持光标同步ylc395
🏠⬇️圣经报价2.0.0在文本编辑器中直接引用圣经但丁·G·巴博萨
⬇️中文提供0.5.0使用本地存储的 BibTeX 文件将引用集成到 Joplin阿卜杜拉·艾哈迈德
🏠⬇️批量笔记创建者1.0.0批量创建笔记艾哈迈德·阿尔廷迪斯
🏠⬇️字节域-svg1.1.0添加对用于描述网络协议、内存布局和任何其他二进制结构的 bytefield-svg 图的支持。马克0l92
🏠⬇️代码部分1.0.4从代码源插入一段代码于尔根·哈贝尔特
🏠⬇️CodeMirror 行号2.0.0为 CodeMirror 编辑器启用行号Shantanu Goel
🏠⬇️合并笔记1.0.1合并一个或多个音符杰克格鲁伯
🏠⬇️完整链接1.0.1这个插件在工具栏上添加了一个图标。单击时,它将所选文本完成为注释标题(在降价链接中)。S73ph4n
🏠⬇️解决冲突1.2.3一个使解决冲突的过程更容易的插件。艾哈迈德·阿尔瓦西菲
🏠⬇️带类的容器1.0.0用于创建具有自定义类的块级容器的插件孝氏龙
🏠⬇️将文本转换为新注释1.5.1将突出显示的文本转换为同一文件夹中的新文本安布特
🏠⬇️复制锚链接1.1.0该插件在注释标题旁边添加了几个图标,您可以单击这些图标来复制特定标题的降价链接。孝氏龙
🏠⬇️将链接复制到活动笔记1.0.1在编辑器的右键菜单中添加条目以获取活动笔记的链接一种
🏠⬇️创建并转到#tags 和@notebooks1.3.7通过链接或文本转到标签、笔记本或笔记一种
🏠⬇️CSV 导入1.0.1导入 Csv 文件或将剪贴板中的 Csv 文本粘贴为表格于尔根·哈贝尔特
🏠⬇️日回顾1.0.1这个插件在工具栏上添加了一个图标。单击时,它会查看当天创建/更新/完成的笔记和待办事项。S73ph4n
⬇️依赖图1.0.0将笔记的直接和间接依赖关系可视化为图形。文森特·尼斯
🏠⬇️禁用 PDF1.0.0禁用 Joplin 中的 PDF 预览(和导出)以获得更好的性能JJ-8
🏠⬇️绘图.io2.0.0乔普林的 Draw.io(又名 Diagram.net)集成马克0l92
🏠⬇️电子邮件说明1.2.2以电子邮件形式发送备注埃利亚斯文森特
🏠⬇️嵌入搜索2.0.0在注释内嵌入由搜索指定的链接列表安布特
⬇️嵌入式标签1.0.0嵌入标签戴夫·爱德华兹
🏠⬇️表情符号1.0.3表情符号选择器。回溯
🏠⬇️活动日历0.1.1一个简单的活动日历佛朗哥·斯佩齐亚利
🏠⬇️导出到 SSG1.0.3将笔记集合导出到静态站点生成器项目。aman-d-1-n-only
🏠⬇️收藏夹1.3.0在额外的面板视图中将任何笔记本、笔记、待办事项、标记或搜索保存为收藏,以便快速访问。奔吉300
🏠⬇️在代码镜像编辑器中折叠2.0.1允许折叠编辑器中显示的部分降价文本安布特
🏠⬇️获取笔记本 ID1.0.1复制/显示笔记本的 ID。对于开发人员。普通用户不需要这个。赫尔穆特 KC Tessarek
🏠⬇️GitHub 主题0.3.0Joplin 主题与 GitHub 的颜色马克0l92
🏠⬇️图形1.1.0笔记作为节点。探索您的 Joplin 知识图谱。安托万·杰拉尔丁
🏠⬇️亮点匹配0.1.0标记与突出显示的选择匹配的单词达拉萨
🏠⬇️历史面板1.0.1乔普林笔记浏览历史alondmnt
🏠⬇️家庭笔记1.0.4每次 joplin 启动时打开一个选择的笔记的插件。它就像浏览器上的主页。阿达什·辛格(lki)
🏠⬇️热文件夹1.0.1监视区域设置文件夹并将文件作为新注释导入。杰克格鲁伯
🏠⬇️内联标签1.2.1内联标签插件罗马穆辛
🏠⬇️内联 TODO1.3.1随处写 TODO并在一处查看。迦勒约翰
🏠⬇️插入日期1.0.1添加一个按钮以将当前日期(没有时间)插入到编辑器中。赫德索通
🏠⬇️吉拉问题2.3.0使用他们的 api 检索 Atlassian Jira 问题信息,以便从您的 Joplin 笔记中跟踪它们的状态。马克0l92
🏠⬇️乔普林 Anki 同步1.0.0Joplin 和 Anki 之间的双向同步陈丽君
🏠⬇️乔普林 DDDot0.1.3最近的笔记、快捷方式、便签本和….在一个侧边栏中。刘本
🏠⬇️乔普林笔记附件重命名1.2.0Joplin 插件重命名笔记附件,马卡内奥
🏠⬇️Joplin 用户链接插件1.2.0用于自定义链接的 Joplin 插件,例如jump://?query=blabla.科洛格勒
🏠⬇️乔普林-hackmd1.0.1在 HackMD 上快速分享笔记沙巴兹
🏠⬇️JSheets1.1.3JSheets – 用于在 Joplin 中编写类似 excel 的电子表格蒂博·扬·拜尔
🏠⬇️看板1.0.7适用于所有任务的灵活看板插件巴林特马扎尔
🏠⬇️生活日历1.2.1乔普林的一周生活插件孝氏龙
🏠⬇️链接图用户界面1.5.0可视化乔普林笔记之间的联系。特雷莫
🏠⬇️macOS 主题1.3.3Joplin 的原生外观 macOS 主题。也适用于非 macOS 设备。安德烈·吉尔达
🏠⬇️制作所有链接1.0.3在当前笔记中搜索其他笔记的提及,然后建立相应的链接。只需单击工具栏中的新图标。S73ph4n
🏠⬇️Markdown 表计算1.0.5用于自动计算降价表公式的插件。奥斯卡·斯维达
🏠⬇️降价表:着色1.1.4为 markdown 表语法添加颜色并帮助区分不同的列孝氏龙
🏠⬇️降价表:可排序1.2.2即时对呈现的表格进行排序并将其应用于降价源文本。可以识别数字、货币、日期的简单情况并进行相应的排序。孝氏龙
🏠⬇️数学模式0.5.3使用内联数学将您的笔记变成功能强大的计算器。迦勒约翰
🏠⬇️菜单项、快捷方式、工具栏图标1.1.0不属于 Joplin 核心的其他菜单项、快捷方式和工具栏图标赫尔穆特 KC Tessarek
🏠⬇️梅蒂斯0.1.5基于 Todo.txt 规范的 Joplin 简单任务管理器插件孝氏龙
🏠⬇️NLR1.0.2将joplin在记笔记的同时,变成了一个网文小说阅读器,一个joplin的中文网络文学下载器和阅读器插件。风趣
🏠⬇️笔记链接系统0.8.0Joplin 的完整链接系统。推荐人(又名反向链接)、快速链接、复制锚点、悬停预览、网址图标和更多功能ylc395
🏠⬇️笔记列表和侧边栏切换按钮1.0.3添加按钮以切换笔记列表和侧边栏洛朗·科齐奇
🏠⬇️笔记概览1.5.5根据定义的搜索和指定的字段创建注释概览。杰克格鲁伯
🏠⬇️笔记统计1.0.4获取笔记统计信息的插件阿扎玛少年
🏠⬇️笔记标签1.4.0允许在选项卡中一次打​​开多个笔记并将它们固定。奔吉300
🏠⬇️注意变量1.0.0一个用于创建可以通过所有注释访问的变量的插件。但丁·G·巴博萨
🏠⬇️Notes Station 导入1.0.5此插件从 QNAP Notes Station 导入笔记于尔根·哈贝尔特
🏠⬇️光学字符识别0.3.2Joplin 笔记中的图像、视频、pdf 文档的离线 OCR 自动/手动ylc395
🏠⬇️大纲1.3.1joplin 的大纲 (TOC) 侧边栏插件。
🏠⬇️页面发布者1.7.0从您选择的 Joplin 笔记生成静态博客网站,并发布到 Github Pages,只需点击几下鼠标。支持本地预览ylc395
⬇️特殊黏贴1.1.2用于将特殊文本粘贴到 Joplin 的插件编码器
🏠⬇️持久编辑器布局2.2.0使用自定义标签分别保存每个注释的编辑器布局(编辑器/拆分视图/查看器/富文本)。奔吉300
🏠⬇️植物UML21.9.0在 Joplin 笔记中渲染 PlantUML 图。马克0l92
🏠⬇️快速跳转1.2.0使用键盘快捷键切换到指定的笔记孝氏龙
🏠⬇️快速 HTML 标签0.2.0创建快速 HTML 标签。马丁·科雷利奇
🏠⬇️快速链接1.2.3创建指向其他笔记的链接罗马穆辛
🏠⬇️快速移动1.1.0快速将笔记移动到其他笔记本的命令集合。奔吉300
🏠⬇️随机笔记1.0.3从您的保管库中打开一个随机笔记阿扎玛少年
🏠⬇️删除图像0.0.2允许从选定的笔记中删除图像马克2002
🏠⬇️重复待办事项0.10.3一个强大而全面的待办事项重复/重复插件节拍链接
🏠⬇️资源搜索插件0.1.1在附加资源中搜索罗马穆辛
🏠⬇️丰富的降价0.9.0帮助您永远放弃 Markdown 查看器。迦勒约翰
🏠⬇️Rubi 和 Furigana1.1.0将适当的 <ruby> 和 <rt> 标签插入格式化文本以显示假名的命令。孝氏龙
🏠⬇️语义相似的注释0.2.1向用户显示哪些笔记在语义上与他们正在查看的笔记相似马克格林
🏠⬇️将片段发送到不同的笔记1.0.0将文本片段从任何笔记本发送到任何其他笔记安布特
🏠⬇️简单备份1.0.5用于创建手动和自动备份的插件。杰克格鲁伯
🏠⬇️斜线命令:日期时间等1.2.1通过键入以斜杠开头的命令来执行多个实用程序。孝氏龙
🏠⬇️剧透1.0.5创建带有标题和可扩展正文的内嵌剧透和剧透块。马丁·科雷利奇
🏠⬇️表格格式化插件1.2.1在 Markdown 编辑器中格式化光标下的表格罗马穆辛
🏠⬇️标记链接0.1.0自动在页脚插入标签链接刘本
🏠⬇️标记1.0.1用于扩展 Joplin 标记菜单的插件,其中包含复制所有标记和具有更多控制的标记对话框。(以前复制标签)。杰克格鲁伯
🏠⬇️标签生成器1.0.0Joplin 插件,可用于从笔记中提取关键字并将它们分配为笔记的标签强制唤醒
🏠⬇️模板2.2.1该插件允许您在 Joplin 中创建和使用模板。尼山特·米塔尔
🏠⬇️文本着色1.2.0轻松将颜色应用于文本。萨德米斯
🏠⬇️转向图1.6.0将 markdown 表转换为 d3js 图表塞缪尔·加涅潘
🏠⬇️胜利者1.0.0Victor 可用于清除所有数据 – 笔记、笔记本、附件、标签等。方便重新开始。洛朗·科齐奇
🏠⬇️白色主题1.2.3乔普林的白色主题节拍链接