自己的 markdown 笔记一定要握在自己手里，本文记录私有笔记服务器工具 joplin 的部署过程。
简介
Joplin是一款开源的笔记本应用，它的以下优点让我最终选择了它，
- 多平台支持 桌面端支持Windows，Mac；移动端支持安卓、IOS，所以不论是电脑还是手机都能够使用这款笔记来记录。
- 多设备同步 Joplin可以在各个设备上通过WebDAV、Dropbox、OneDrive、Joplin Server等方式进行存储同步笔记，可以实现自主选择数据存储方式。
- Markdown语法支持 支持Markdown使我在Joplin和Note staiton之间最终选择了Joplin，Markdown作为一种轻量级的标记语言，易写易读高效，能在写作排版上大大提高效率。
- 待办事项和笔记统一管理 Joplin除了支持创建笔记之外，还可以创建待办事项，所以可以把自己的待办清单和笔记整理在一起，并且它还支持待办事项和笔记的转换，可以先设置待办，作为未完成笔记的一个提醒，在完成写作之后再转为笔记。
- 端对端加密（E2EE） Joplin支持端对端加密（E2EE）来保证笔记数据的安全，确保除了用户自己之外没有人可以访问它们，所以也可以在原有的笔记存储基础上放心的在公有云上额外再备份自己的笔记。
Server 部署流程
官方文档有介绍 server 配置流程，但是不清不楚
总体来说还是 Docker 部署最舒服，咱们记录流程
准备工作
- 安装好 Docker
- 安装好 Docker-compose
生成 docker 容器
- 创建 docker-compose.yml 文件
# This is a sample docker-compose file that can be used to run Joplin Server
# along with a PostgreSQL server.
#
# Update the following fields in the stanza below:
#
# POSTGRES_USER
# POSTGRES_PASSWORD
# APP_BASE_URL
#
# APP_BASE_URL: This is the base public URL where the service will be running.
# - If Joplin Server needs to be accessible over the internet, configure APP_BASE_URL as follows: https://example.com/joplin.
# - If Joplin Server does not need to be accessible over the internet, set the the APP_BASE_URL to your server's hostname.
# For Example: http://[hostname]:22300. The base URL can include the port.
# APP_PORT: The local port on which the Docker container will listen.
# - This would typically be mapped to port to 443 (TLS) with a reverse proxy.
# - If Joplin Server does not need to be accessible over the internet, the port can be mapped to 22300.
version: '3'
services:
db:
image: postgres:16
volumes:
- ./data/postgres:/var/lib/postgresql/data
ports:
- "5432:5432"
restart: unless-stopped
environment:
- POSTGRES_PASSWORD=balabala
- POSTGRES_USER=balabala
- POSTGRES_DB=balabala
app:
image: joplin/server:latest
volumes:
- /etc/localtime:/etc/localtime:ro
# This directory has to be created manually, owned by user 1001 with chmod 700
- /home/vvd/programs/joplin/files:/mnt/files
ports:
- "22300:22300"
restart: unless-stopped
depends_on:
- db
environment:
- APP_PORT=22300
- APP_BASE_URL=http://domain:port
- DB_CLIENT=pg
- POSTGRES_PASSWORD=balabala
- POSTGRES_DATABASE=balabala
- POSTGRES_USER=balabala
- POSTGRES_PORT=5432
- POSTGRES_HOST=db
- STORAGE_DRIVER=Type=Filesystem; Path=/mnt/files
其中 APP_BASE_URL 为 joplin 可接受的访问链接，该url 需要填入 协议、域名和端口，初始为了方便建议 http 协议测试，之后升级 https
建议将内部存放核心文件映射出来，方便管理
代码语言：text复制volumes:
- /etc/localtime:/etc/localtime:ro
# This directory has to be created manually, owned by user 1001 with chmod 700
- /home/vvd/programs/joplin/files:/mnt/files
修改文件件权限
需要将/mnt/files 映射的本地 /home/vvd/programs/joplin/files 文件夹所有者修改为 1001
代码语言：text复制https://discourse.joplinapp.org/t/self-hosted-server-setup-storage-in-filesytem/25939
sudo chown 1001 /home/vvd/programs/joplin/files
- 构建 container
docker-compose up
- 正常运行服务
Starting joplin_db_1 ... done
Recreating joplin_app_1 ... done
Attaching to joplin_db_1, joplin_app_1
db_1 |
db_1 | PostgreSQL Database directory appears to contain a database; Skipping initialization
db_1 |
db_1 | 2023-12-13 14:11:26.652 UTC [1] LOG: starting PostgreSQL 16.1 (Debian 16.1-1.pgdg120 1) on x86_64-pc-linux-gnu, compiled by gcc (Debian 12.2.0-14) 12.2.0, 64-bit
db_1 | 2023-12-13 14:11:26.653 UTC [1] LOG: listening on IPv4 address "0.0.0.0", port 5432
db_1 | 2023-12-13 14:11:26.653 UTC [1] LOG: listening on IPv6 address "::", port 5432
db_1 | 2023-12-13 14:11:27.166 UTC [1] LOG: listening on Unix socket "/var/run/postgresql/.s.PGSQL.5432"
db_1 | 2023-12-13 14:11:27.259 UTC [28] LOG: database system was shut down at 2023-12-13 14:10:45 UTC
db_1 | 2023-12-13 14:11:27.557 UTC [1] LOG: database system is ready to accept connections
app_1 | yarn run v1.22.19
app_1 | $ pm2 kill && pm2 start --no-daemon --exp-backoff-restart-delay=1000 dist/app.js
app_1 |
app_1 | -------------
app_1 |
app_1 | __/\\\\\\____/\\____________/\\____/\\\\_____
app_1 | _/\/////////\_/\\\________/\\\__/\///////\___
app_1 | _/\_______/\_/\//\____/\//\_///______//\__
app_1 | _/\\\\\\/__/\\///\/\/_/\___________/\/___
app_1 | _/\/////////____/\__///\/___/\________/\//_____
app_1 | _/\_____________/\____///_____/\_____/\//________
app_1 | _/\_____________/\_____________/\___/\/___________
app_1 | _/\_____________/\_____________/\__/\\\\\\\_
app_1 | _///______________///______________///__///////////////__
app_1 |
app_1 |
app_1 | Runtime Edition
app_1 |
app_1 | PM2 is a Production Process Manager for Node.js applications
app_1 | with a built-in Load Balancer.
app_1 |
app_1 | Start and Daemonize any application:
app_1 | $ pm2 start app.js
app_1 |
app_1 | Load Balance 4 instances of api.js:
app_1 | $ pm2 start api.js -i 4
app_1 |
app_1 | Monitor in production:
app_1 | $ pm2 monitor
app_1 |
app_1 | Make pm2 auto-boot at server restart:
app_1 | $ pm2 startup
app_1 |
app_1 | To go further checkout:
app_1 | http://pm2.io/
app_1 |
app_1 |
app_1 | -------------
app_1 |
app_1 | [PM2] Spawning PM2 daemon with pm2_home=/home/joplin/.pm2
app_1 | [PM2] PM2 Successfully daemonized
app_1 | [PM2][WARN] No process found
app_1 | [PM2] [v] All Applications Stopped
app_1 | [PM2] [v] PM2 Daemon Stopped
app_1 | pm2 launched in no-daemon mode (you can add DEBUG="*" env variable to get more messages)
app_1 | 2023-12-13T14:11:33: PM2 log: Launching in no daemon mode
app_1 | 2023-12-13T14:11:33: PM2 log: [PM2] Starting /home/joplin/packages/server/dist/app.js in fork_mode (1 instance)
app_1 | 2023-12-13T14:11:33: PM2 log: App [app:0] starting in -fork mode-
app_1 | 2023-12-13T14:11:33: PM2 log: App [app:0] online
app_1 | 2023-12-13T14:11:33: PM2 log: [PM2] Done.
app_1 | 2023-12-13T14:11:33: PM2 log: ┌────┬────────┬─────────────┬─────────┬─────────┬──────────┬────────┬──────┬───────────┬──────────┬──────────┬──────────┬──────────┐
app_1 | │ id │ name │ namespace │ version │ mode │ pid │ uptime │ ↺ │ status │ cpu │ mem │ user │ watching │
app_1 | ├────┼────────┼─────────────┼─────────┼─────────┼──────────┼────────┼──────┼───────────┼──────────┼──────────┼──────────┼──────────┤
app_1 | │ 0 │ app │ default │ 2.13.3 │ fork │ 62 │ 0s │ 0 │ online │ 0% │ 40.3mb │ joplin │ disabled │
app_1 | └────┴────────┴─────────────┴─────────┴─────────┴──────────┴────────┴──────┴───────────┴──────────┴──────────┴──────────┴──────────┘
app_1 | 2023-12-13T14:11:33: PM2 log: [--no-daemon] Continue to stream logs
app_1 | 2023-12-13T14:11:33: PM2 log: [--no-daemon] Exit on target PM2 exit pid=51
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Starting server v2.13.3 (prod) on port 22300 and PID 62...
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Checking for time drift using NTP server: pool.ntp.org:123
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: NTP time offset: -24ms
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Running in Docker: true
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Public base URL: http://uipv4.zywvvd.com:22300
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: API base URL: http://uipv4.zywvvd.com:22300
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: User content base URL: http://uipv4.zywvvd.com:22300
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Log dir: /home/joplin/packages/server/logs
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: DB Config: {
app_1 | 14:11:43 0|app | client: 'pg',
app_1 | 14:11:43 0|app | name: 'joplin',
app_1 | 14:11:43 0|app | slowQueryLogEnabled: false,
app_1 | 14:11:43 0|app | slowQueryLogMinDuration: 1000,
app_1 | 14:11:43 0|app | autoMigration: true,
app_1 | 14:11:43 0|app | user: 'joplin',
app_1 | 14:11:43 0|app | password: '********',
app_1 | 14:11:43 0|app | port: 5432,
app_1 | 14:11:43 0|app | host: 'db'
app_1 | 14:11:43 0|app | }
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Mailer Config: {
app_1 | 14:11:43 0|app | enabled: false,
app_1 | 14:11:43 0|app | host: '',
app_1 | 14:11:43 0|app | port: 465,
app_1 | 14:11:43 0|app | security: 'tls',
app_1 | 14:11:43 0|app | authUser: '',
app_1 | 14:11:43 0|app | authPassword: '********',
app_1 | 14:11:43 0|app | noReplyName: '',
app_1 | 14:11:43 0|app | noReplyEmail: ''
app_1 | 14:11:43 0|app | }
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Content driver: { type: 2, path: '/mnt/files' }
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Content driver (fallback): null
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Trying to connect to database...
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Connection check: {
app_1 | 14:11:43 0|app | latestMigration: { name: '20230804154410_can_receive_folder.js', done: true },
app_1 | 14:11:43 0|app | isCreated: true,
app_1 | 14:11:43 0|app | error: null
app_1 | 14:11:43 0|app | }
app_1 | 14:11:43 0|app | 2023-12-13 14:11:43: App: Auto-migrating database...
app_1 | 14:11:44 0|app | 2023-12-13 14:11:44: App: Latest migration: { name: '20230804154410_can_receive_folder.js', done: true }
app_1 | 14:11:44 0|app | 2023-12-13 14:11:44: EmailService: Service will be disabled because mailer config is not set or is explicitly disabled
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: App: Performing main storage check...
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: App: Item was written, read back and deleted without any error.
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: App: Starting services...
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #1 (Delete expired tokens): 0 */6 * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #2 (Update total sizes): 0 * * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #3 (Process oversized accounts): 30 */2 * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #6 (Delete expired sessions): 0 */6 * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #7 (Compress old changes): 0 0 */2 * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #8 (Process user deletions): 10 * * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #10 (Process orphaned items): 15 * * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #11 (Process shared items): PT10S
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: TaskService: Scheduling #12 (Process emails): * * * * *
app_1 | 14:11:49 0|app | 2023-12-13 14:11:49: App: Call this for testing: `curl http://uipv4.zywvvd.com:22300/api/ping`
app_1 | 14:11:59 0|app | 2023-12-13 14:11:59: TaskService: Running #11 (Process shared items) (scheduled)...
app_1 | 14:11:59 0|app | 2023-12-13 14:11:59: TaskService: Completed #11 (Process shared items) in 105ms
app_1 | 14:12:00 0|app | 2023-12-13 14:12:00: TaskService: Running #12 (Process emails) (scheduled)...
app_1 | 14:12:00 0|app | 2023-12-13 14:12:00: TaskService: Completed #12 (Process emails) in 50ms
app_1 | 14:12:09 0|app | 2023-12-13 14:12:09: TaskService: Running #11 (Process shared items) (scheduled)...
app_1 | 14:12:09 0|app | 2023-12-13 14:12:09: TaskService: Completed #11 (Process shared items) in 75ms
app_1 | 14:12:19 0|app | 2023-12-13 14:12:19: TaskService: Running #11 (Process shared items) (scheduled)...
app_1 | 14:12:19 0|app | 2023-12-13 14:12:19: TaskService: Completed #11 (Process shared items) in 84ms
app_1 | 14:12:29 0|app | 2023-12-13 14:12:29: TaskService: Running #11 (Process shared items) (scheduled)...
测试 joplin
访问 http://domain:port/api/ping 也就是你的 joplin 访问链接加上 /api/ping 作为测试
如果一切正常会返回：
代码语言：text复制{"status":"ok","message":"Joplin Server is running"}
同时服务器后端输出日志
代码语言：text复制app_1 | 14:15:28 0|app | 2023-12-13 14:15:28: App: GET /api/ping (200) (10ms)
说明一切正常
此时访问 http://domain:port/login 可以看到初始登录界面
说明服务器配置目前一切顺利。
https 协议
Docker container 端口设置为默认的 22300
该容器会自动将 22300 映射到本机的 22300 端口
配置 Nginx 反向代理，配置 ssl 证书
代码语言：text复制server {
listen 11040 ssl;
listen [::]:11040 ssl;
# server_name localhost;
ssl_certificate /ssl/uipv4.zywvvd.com.crt;
ssl_certificate_key /ssl/uipv4.zywvvd.com.key;
location / {
proxy_set_header X-FORWARDED-FOR $remote_addr;
proxy_set_header X-FORWARDED-PROTO $scheme;
proxy_set_header Host $http_host;
proxy_pass http://192.168.5.5:22300;
}
}
将本地的 http 协议转发到 https 协议的 11040 端口上
再通过路由器的端口转发将本机的 11040 端口映射到广域网端口
将路由器公网IP映射到自己的域名上，就可以公网 https 访问自己的 joplin 啦
参考资料
- https://github.com/laurent22/joplin/issues/6553
- https://github.com/laurent22/joplin/blob/dev/packages/server/README.md
- https://raw.githubusercontent.com/laurent22/joplin/dev/docker-compose.server.yml
- https://github.com/laurent22/joplin/tree/dev/packages/server
- https://discourse.joplinapp.org/t/self-hosted-server-setup-storage-in-filesytem/25939
- https://joplinapp.org/help/dev/spec/architecture
- https://zhuanlan.zhihu.com/p/264931210?utm_id=0
- https://post.smzdm.com/p/all3dmoe/
文章链接： https://cloud.tencent.com/developer/article/2371116
