1. 为什么选择Joplin搭建私有云笔记每次打开那些商业云笔记软件看到弹出来的会员订阅广告就头疼。免费用户只能同步两个设备导出格式还各种限制更别提时不时出现的隐私担忧。作为一个技术从业者我一直在寻找能够完全掌控自己数据的解决方案。Joplin这款开源笔记工具完美解决了我的痛点。它支持全平台客户端Windows/macOS/Linux/Android/iOS采用Markdown作为默认编辑格式最重要的是支持自建同步服务器。当我发现可以用DockerPostgreSQL在NAS上搭建私有化的Joplin Server时立刻决定把用了五年的商业笔记迁移过来。实测三个月下来这套方案比商业云笔记更稳定可靠。所有数据都存储在自己的NAS上再也不用担心服务商突然停止运营。跨设备同步速度飞快在公司和家里的多台电脑、手机之间切换毫无障碍。最让我惊喜的是它的插件系统通过安装第三方插件可以实现PDF批注、思维导图等高级功能。2. 部署前的准备工作2.1 硬件设备选择我的主力设备是一台群晖DS920配置了8GB内存和两块4TB硬盘组成RAID1。这个配置运行Joplin Server绰绰有余实测同步服务内存占用长期保持在300MB以下。如果你用的是其他品牌的NAS如极空间、威联通等只要支持Docker都可以按照本教程操作。对于数据库的选择我强烈推荐PostgreSQL而不是SQLite。虽然官方文档说SQLite适合测试环境但在实际使用中发现PostgreSQL的并发性能更好。特别是当你在手机上快速切换笔记时PostgreSQL能保持更稳定的响应速度。2.2 软件环境配置首先确保你的NAS已经安装好Docker服务。以群晖为例在套件中心搜索Docker并安装。其他品牌NAS一般也都有对应的Docker管理应用比如极空间的极空间ZDR。接着需要准备PostgreSQL数据库。如果你已经有用其他服务创建的PostgreSQL实例可以直接复用。没有的话也不用担心我们会用Docker快速创建一个专用数据库。唯一要注意的是提前规划好存储路径建议放在NAS的固态硬盘缓存分区如果有的话以获得更好的IO性能。3. 使用Docker部署Joplin Server3.1 快速拉起PostgreSQL容器打开NAS的Docker管理界面在注册表中搜索postgres选择官方镜像。点击下载时记得选择具体版本我推荐使用13版本这个版本经过长期验证比较稳定。创建容器时关键要设置这几个环境变量POSTGRES_PASSWORD设置一个强密码POSTGRES_USER建议就用joplinPOSTGRES_DB数据库名也设为joplin端口映射保持默认的5432即可存储卷记得挂载到NAS的持久化目录。这是我的完整docker run命令docker run -d \ --name joplin-db \ -e POSTGRES_PASSWORD你的密码 \ -e POSTGRES_USERjoplin \ -e POSTGRES_DBjoplin \ -v /volume1/docker/joplin/postgres:/var/lib/postgresql/data \ -p 5432:5432 \ postgres:133.2 配置Joplin Server容器现在来部署主角Joplin Server。同样在Docker中搜索joplin/server获取官方镜像。创建容器时需要特别注意这些环境变量docker run -d \ --name joplin-server \ -e APP_PORT22300 \ -e APP_BASE_URLhttp://你的NAS内网IP:22300 \ -e DB_CLIENTpg \ -e POSTGRES_PASSWORD刚才设置的密码 \ -e POSTGRES_DATABASEjoplin \ -e POSTGRES_USERjoplin \ -e POSTGRES_PORT5432 \ -e POSTGRES_HOSTjoplin-db \ -p 22300:22300 \ --link joplin-db:db \ joplin/server:latest这里有个容易踩坑的地方APP_BASE_URL一定要设置正确。如果你后续要通过域名访问这里就要填域名如https://notes.yourdomain.com。我刚开始就因为这个配置错误导致客户端无法同步。4. 多终端配置指南4.1 桌面端配置技巧到Joplin官网下载对应系统的客户端安装后进入工具 选项 同步同步目标选择Joplin ServerURL填写http://NAS内网IP:22300用户名密码用默认的adminlocalhost/admin首次同步可能会比较慢因为要下载所有笔记数据。建议在WiFi环境下进行初始同步。我遇到的一个典型问题是防火墙拦截需要在路由器设置中放行22300端口。4.2 移动端优化方案安卓和iOS客户端在应用商店都能找到。配置方法与桌面端类似但有几点需要注意在移动网络环境下建议关闭自动同步开启仅在充电时同步可以省电iOS用户记得在设置中开启后台应用刷新实测发现移动端的图片同步有时会卡住。我的解决方案是在客户端设置里将图片大小限制调整为1024px这样既保证清晰度又不会因为单张图片过大导致同步失败。5. 高级功能与维护5.1 通过Nginx实现HTTPS访问直接用IP端口访问不够优雅我推荐用Nginx做反向代理。假设你已经有一个域名和SSL证书配置示例server { listen 443 ssl; server_name notes.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://localhost:22300; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }配置完成后别忘了把Joplin容器的APP_BASE_URL变量更新为https://notes.yourdomain.com然后重启容器。5.2 定期备份策略虽然PostgreSQL已经很可靠但数据无价。我设置了一个自动化备份方案每天凌晨3点用pg_dump导出数据库将备份文件同步到另一个NAS和云端保留最近7天的备份备份脚本示例#!/bin/bash docker exec joplin-db pg_dump -U joplin -d joplin /backup/joplin_$(date %Y%m%d).sql rclone copy /backup remote:backups/joplin find /backup -type f -mtime 7 -delete这套方案运行半年多来最让我满意的是完全掌控数据的安全感。有一次误删了重要笔记通过PostgreSQL的时间点恢复功能完美找回。现在所有工作文档、代码片段甚至密码库都放在自己的Joplin Server上再也不用受制于商业服务的各种限制。
基于Docker与PostgreSQL的Joplin私有云笔记搭建：跨终端同步全攻略
发布时间：2026/5/16 12:15:42
1. 为什么选择Joplin搭建私有云笔记每次打开那些商业云笔记软件看到弹出来的会员订阅广告就头疼。免费用户只能同步两个设备导出格式还各种限制更别提时不时出现的隐私担忧。作为一个技术从业者我一直在寻找能够完全掌控自己数据的解决方案。Joplin这款开源笔记工具完美解决了我的痛点。它支持全平台客户端Windows/macOS/Linux/Android/iOS采用Markdown作为默认编辑格式最重要的是支持自建同步服务器。当我发现可以用DockerPostgreSQL在NAS上搭建私有化的Joplin Server时立刻决定把用了五年的商业笔记迁移过来。实测三个月下来这套方案比商业云笔记更稳定可靠。所有数据都存储在自己的NAS上再也不用担心服务商突然停止运营。跨设备同步速度飞快在公司和家里的多台电脑、手机之间切换毫无障碍。最让我惊喜的是它的插件系统通过安装第三方插件可以实现PDF批注、思维导图等高级功能。2. 部署前的准备工作2.1 硬件设备选择我的主力设备是一台群晖DS920配置了8GB内存和两块4TB硬盘组成RAID1。这个配置运行Joplin Server绰绰有余实测同步服务内存占用长期保持在300MB以下。如果你用的是其他品牌的NAS如极空间、威联通等只要支持Docker都可以按照本教程操作。对于数据库的选择我强烈推荐PostgreSQL而不是SQLite。虽然官方文档说SQLite适合测试环境但在实际使用中发现PostgreSQL的并发性能更好。特别是当你在手机上快速切换笔记时PostgreSQL能保持更稳定的响应速度。2.2 软件环境配置首先确保你的NAS已经安装好Docker服务。以群晖为例在套件中心搜索Docker并安装。其他品牌NAS一般也都有对应的Docker管理应用比如极空间的极空间ZDR。接着需要准备PostgreSQL数据库。如果你已经有用其他服务创建的PostgreSQL实例可以直接复用。没有的话也不用担心我们会用Docker快速创建一个专用数据库。唯一要注意的是提前规划好存储路径建议放在NAS的固态硬盘缓存分区如果有的话以获得更好的IO性能。3. 使用Docker部署Joplin Server3.1 快速拉起PostgreSQL容器打开NAS的Docker管理界面在注册表中搜索postgres选择官方镜像。点击下载时记得选择具体版本我推荐使用13版本这个版本经过长期验证比较稳定。创建容器时关键要设置这几个环境变量POSTGRES_PASSWORD设置一个强密码POSTGRES_USER建议就用joplinPOSTGRES_DB数据库名也设为joplin端口映射保持默认的5432即可存储卷记得挂载到NAS的持久化目录。这是我的完整docker run命令docker run -d \ --name joplin-db \ -e POSTGRES_PASSWORD你的密码 \ -e POSTGRES_USERjoplin \ -e POSTGRES_DBjoplin \ -v /volume1/docker/joplin/postgres:/var/lib/postgresql/data \ -p 5432:5432 \ postgres:133.2 配置Joplin Server容器现在来部署主角Joplin Server。同样在Docker中搜索joplin/server获取官方镜像。创建容器时需要特别注意这些环境变量docker run -d \ --name joplin-server \ -e APP_PORT22300 \ -e APP_BASE_URLhttp://你的NAS内网IP:22300 \ -e DB_CLIENTpg \ -e POSTGRES_PASSWORD刚才设置的密码 \ -e POSTGRES_DATABASEjoplin \ -e POSTGRES_USERjoplin \ -e POSTGRES_PORT5432 \ -e POSTGRES_HOSTjoplin-db \ -p 22300:22300 \ --link joplin-db:db \ joplin/server:latest这里有个容易踩坑的地方APP_BASE_URL一定要设置正确。如果你后续要通过域名访问这里就要填域名如https://notes.yourdomain.com。我刚开始就因为这个配置错误导致客户端无法同步。4. 多终端配置指南4.1 桌面端配置技巧到Joplin官网下载对应系统的客户端安装后进入工具 选项 同步同步目标选择Joplin ServerURL填写http://NAS内网IP:22300用户名密码用默认的adminlocalhost/admin首次同步可能会比较慢因为要下载所有笔记数据。建议在WiFi环境下进行初始同步。我遇到的一个典型问题是防火墙拦截需要在路由器设置中放行22300端口。4.2 移动端优化方案安卓和iOS客户端在应用商店都能找到。配置方法与桌面端类似但有几点需要注意在移动网络环境下建议关闭自动同步开启仅在充电时同步可以省电iOS用户记得在设置中开启后台应用刷新实测发现移动端的图片同步有时会卡住。我的解决方案是在客户端设置里将图片大小限制调整为1024px这样既保证清晰度又不会因为单张图片过大导致同步失败。5. 高级功能与维护5.1 通过Nginx实现HTTPS访问直接用IP端口访问不够优雅我推荐用Nginx做反向代理。假设你已经有一个域名和SSL证书配置示例server { listen 443 ssl; server_name notes.yourdomain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location / { proxy_pass http://localhost:22300; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }配置完成后别忘了把Joplin容器的APP_BASE_URL变量更新为https://notes.yourdomain.com然后重启容器。5.2 定期备份策略虽然PostgreSQL已经很可靠但数据无价。我设置了一个自动化备份方案每天凌晨3点用pg_dump导出数据库将备份文件同步到另一个NAS和云端保留最近7天的备份备份脚本示例#!/bin/bash docker exec joplin-db pg_dump -U joplin -d joplin /backup/joplin_$(date %Y%m%d).sql rclone copy /backup remote:backups/joplin find /backup -type f -mtime 7 -delete这套方案运行半年多来最让我满意的是完全掌控数据的安全感。有一次误删了重要笔记通过PostgreSQL的时间点恢复功能完美找回。现在所有工作文档、代码片段甚至密码库都放在自己的Joplin Server上再也不用受制于商业服务的各种限制。
