安裝 Joplin Server(Docker)

想找一個可以多個裝置離線編輯, 同步到自己的 Server 筆記工具.. 最近剛好看到 Joplin 似乎很符合這個需求.
Joplin 已經提供主流用戶端平台的程式, 可直接到 https://joplinapp.org/download/ 下載安裝

安裝自己 Joplin Server 程序

安裝環境 : 在 Alpine Linux 3 底下安裝 docker + docker-compose

編輯 docker-compose.yml

version: '3'

services:
    db:
        image: postgres:16
        volumes:
            - ./data/postgres:/var/lib/postgresql/data
        ports:
            - "5432:5432"
        restart: unless-stopped
        environment:
            - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
            - POSTGRES_USER=${POSTGRES_USER}
            - POSTGRES_DB=${POSTGRES_DATABASE}
    app:
        image: joplin/server:latest
        depends_on:
            - db
        ports:
            - "22300:22300"
        restart: unless-stopped
        environment:
            - APP_PORT=22300
            - APP_BASE_URL=${APP_BASE_URL}
            - DB_CLIENT=pg
            - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
            - POSTGRES_DATABASE=${POSTGRES_DATABASE}
            - POSTGRES_USER=${POSTGRES_USER}
            - POSTGRES_PORT=${POSTGRES_PORT}
            - POSTGRES_HOST=db

依照實際資訊編輯 .env 參數定義檔 Exp.

POSTGRES_USER=jpuser
POSTGRES_PASSWORD=myPassw0rd
POSTGRES_DATABASE=joplindb
POSTGRES_PORT=5432
APP_BASE_URL=http://192.168.11.234:22300

啟動服務
```
docker compose up -d
```
連上 APP_BASE_URL 網址 Exp. http://192.168.11.234:22300

輸入預設帳號密碼登入 admin@localhost / admin
新增自己的帳號、刪除或修改 admin@localhost 密碼

用戶端設定

Windows 上的 Joplin 設定同步

常見問題

Q1: docker compose logs app 出現 Error: The device time drift is 21208ms (Max allowed: 2000ms) 錯誤訊息
- A1: 這表示主機時間和網路標準時間已經產生落差超過 2000ms , 可以確認主機同步標準時間或是透過增加 MAX_TIME_DRIFT 環境變數來解決 Exp.MAX_TIME_DRIFT=0 表示不用理會主機時間差異(這可能會造成多 Client 同步資料出現覆蓋的異常狀況)
- A2: 可以參考 Alpine 設定網路同步系統時間(chronyc) 安裝網路校時工具解決

Q2: 經過幾次自動升版後 docker compose logs 出現以下訊息

db-1        | 2025-08-21 04:00:00.029 UTC [37] WARNING:  database "joplindb" has a collation version mismatch
db-1        | 2025-08-21 04:00:00.029 UTC [37] DETAIL:  The database was created using collation version 2.36, but the operating system provides version 2.41.
db-1        | 2025-08-21 04:00:00.029 UTC [37] HINT:  Rebuild all objects in this database that use the default collation and run ALTER DATABASE joplindb REFRESH COLLATION VERSION, or build PostgreSQL with the right library version.

A: 可以進入 db 容器內進行修復

docker compose exec -it db psql -U jpuser -d joplindb

輸入

ALTER DATABASE joplindb REFRESH COLLATION VERSION;

這樣就可以解決

參考網址

note, docker