今天既是腊月二十九，也是除夕，是牛年的最后一天，辞别旧岁，迎来新年。在新的一年，愿您平安健康，家人常伴；财运滚滚，大吉大利！

什么是 Joplin ？

Joplin 是一个免费的开源笔记和待办事项应用程序，可以处理组织到笔记本中的大量笔记。笔记是可搜索的，可以直接从应用程序或从您自己的文本编辑器中复制、标记和修改，笔记采用 Markdown 格式，并支持所有应用程序的端到端加密 （E2EE）。

安装

Joplin 涉及到两个镜像，比较简单的安装方式是编排 docker-compose.yml 文件，然后用 docker-compose up -d 命令启动。

docker-compose.yml 文件可以在这里下载：https://raw.githubusercontent.com/laurent22/joplin/dev/docker-compose.server.yml

双容器还是可以用群晖的 Docker 管理器来安装，其安装步骤和 wekan 非常类似

镜像下载

在注册表中搜索 joplin ，选择第一个 joplin/server，版本选择 latest。

镜像比较大，要有耐心

另外因为 joplin 依赖 PostgreSQL 而不是 MySQL 做数据库，所以数据库也需要进行安装

joplin 也支持 SQLite，在数据量较大时，还是用 PostgreSQL 效率更高一些

在注册表中搜索 postgres ，选择第一个 postgres，版本选择 latest。

安装 PostgreSQL

容器名称这次没有用默认的，改为了 jp-postgres，因为这个名称后面会用到，当然你不改也可以，修改只是为了更容易识别

卷

在 docker 文件夹中，创建一个新文件夹，并将其命名为 joplin，再建一个子目录 postgres

文件夹	装载路径
docker/joplin/postgres	/var/lib/postgresql/data

端口

# 查看端口占用
netstat -tunlp | grep 端口号

默认端口被占用，所以改了个相邻、但是没被占用的

本地端口	容器端口
5435	5432

环境

可变	值
POSTGRES_DB	数据库名称
POSTGRES_USER	数据库用户
POSTGRES_PASSWORD	数据库密码

数据库的更新参数后面安装 joplin 还会用到

如果运行正常并且不报错的话，就可以进行 joplin 的安装了

安装 Joplin

接下来安装 Joplin，名字设为了 jp-server

端口

本地端口	容器端口
22300	22300

默认没有映射端口

需点 + 号自己增加

链接

点 + 号新增，容器名称中找到前面创建的 jp-postgres，别名简单点，就叫 db ，这是会在 环境变量 中用到

环境变量

可变	值
APP_PORT	应用程序端口，默认为 22300
APP_BASE_URL	应用程序地址，需要带上端口
DB_CLIENT	数据库类型，默认设为 pg
POSTGRES_HOST	数据库主机名，这里就是前面设置的别名
POSTGRES_PORT	数据库端口
POSTGRES_DATABASE	数据库名称
POSTGRES_USER	数据库用户名
POSTGRES_PASSWORD	数据库密码

• APP_BASE_URL：要填完整路径，如果你的域名没有备案，也需要带上端口，例如：http://joplin.laosu.ml:444
• POSTGRES_PORT：因为容器间访问是基于 bridge 的局域网，所以要填容器的内部端口 5432

运行

在浏览器中输入 http://群晖IP:22300 就能看到登录界面

用默认的账号密码登录

缺省的账号：admin@localhost，密码：admin

第一次登录，系统会提示默认管理员密码不安全，记得修改！

客户端

老苏在 https://github.com/laurent22/joplin/releases 下了个最新版的 windows 客户端。

设置很简单，同步目标选择我们刚刚安装好的 Joplin Server，完成设置之后，点 检查同步配置，如果显示 成功！ 就可以开始使用了

创建我们的第一篇 Markdown 笔记

网页插件

Web Clippe 支持 Joplin，需要的 authorization token 可以在客户端的 网页剪辑器 中找到

打开客户端的 网页剪辑器 ，按步骤操作

首先 启用网页剪辑服务

接着安装扩展，官方跳转的地址是 Joplin Web Clipper

老苏用的是 Web Clipper，这是第三方的，通用性更高一些，不仅仅只是支持 Joplin

填入 高级选项 中的 授权令牌 后，先执行 校验

校验成功后，会返回知识库和图床，添加 即可

小结

除了各平台客户端和网页插件外，甚至还有 Visual studio code 的插件，所以 Joplin 可玩性挺高的

参考文档

laurent22/joplin: Joplin - an open source note taking and to-do application with synchronization capabilities for Windows, macOS, Linux, Android and iOS. Forum: https://discourse.joplinapp.org/
地址：https://github.com/laurent22/joplin

Joplin
地址：https://joplinapp.org/

joplin/README.md at dev · laurent22/joplin
地址：https://github.com/laurent22/joplin/blob/dev/packages/server/README.md

Evernote 强力替代品：开源加密笔记本 Joplin - 小众软件
地址：https://www.appinn.com/joplin/