acaranta/docker-joplin Docker 镜像 - 轩辕镜像

Joplin Docker容器（带noVNC HTTP访问）

镜像概述和主要用途

本Docker容器提供Joplin笔记应用的运行环境，支持通过noVNC HTTP协议访问，可放置在反向代理后方使用。基于jlesage/docker-baseimage-gui基础镜像构建，旨在简化Joplin的部署和远程访问流程。Joplin是一款开源笔记应用，支持多平台同步和 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端口流量