acaranta/docker-joplin

Joplin Docker容器（带noVNC HTTP访问）

镜像概述和主要用途

本Docker容器提供Joplin笔记应用的运行环境，支持通过noVNC HTTP协议访问，可放置在反向代理后方使用。基于https://github.com/jlesage/docker-baseimage-gui%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96Joplin%E7%9A%84%E9%83%A8%E7%BD%B2%E5%92%8C%E8%BF%9C%E7%A8%8B%E8%AE%BF%E9%97%AE%E6%B5%81%E7%A8%8B%E3%80%82Joplin%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E7%AC%94%E8%AE%B0%E5%BA%94%E7%94%A8%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E5%B9%B3%E5%8F%B0%E5%90%8C%E6%AD%A5%E5%92%8C markdown 编辑，详情可查看官方网站。

核心功能和特性

• noVNC HTTP访问：通过HTTP协议即可访问Joplin界面，无需安装额外客户端
• 反向代理兼容：支持部署在反向代理后，增强网络架构灵活性
• 数据持久化：通过卷挂载实现配置和数据文件的持久化存储
• 权限控制：要求数据卷对UID/GID 1000/1000具备读写权限，确保容器内应用正常访问数据

使用场景

• 个人用户需要便捷部署Joplin并通过浏览器远程访问
• 团队环境中共享Joplin访问入口（需配合权限控制）
• 需要通过反向代理整合到现有Web服务架构中的场景

使用方法和配置说明

环境要求

• Docker Engine 1.13.0+
• Docker Compose（可选，推荐用于简化部署）

部署示例（Docker Compose）

yaml
version: '2'
services:
  joplin:
    image: acaranta/docker-joplin
    environment:
      - VNC_PASSWORD=<你的VNC密码>  # 设置VNC访问密码
    volumes:
      - <你的Docker卷路径>:/app/.config:rw  # 挂载配置/数据目录，需确保读写权限
    ports:
      - 5800:5800  # 映射noVNC HTTP访问端口

关键配置说明

环境变量

• VNC_PASSWORD：必填，设置访问noVNC界面的密码

卷配置

• 必须挂载/app/.config目录到宿主机卷或目录，用于持久化Joplin的配置和笔记数据
• 权限要求：挂载的卷必须对UID 1000和GID 1000具备读写权限（rw），否则容器可能无法正常读写数据

端口映射

• 默认使用5800端口提供noVNC HTTP访问，可通过宿主机端口映射调整（如宿主机端口:5800）

注意事项

• 首次启动时，需等待容器初始化完成，访问http://<宿主机IP>:5800即可打开noVNC界面，输入设置的VNC_PASSWORD后访问Joplin
• 若使用反向代理，需确保代理配置正确转发5800端口流量