ghostserverd/rclonemount

docker-rclonemount-ghost 镜像文档

镜像概述

docker-rclonemount-ghost 是一个将 rclone 云存储挂载功能与 Ghost 博客平台深度集成的 Docker 镜像。该镜像允许用户通过 rclone 将各类云存储服务（如 Google Drive、Amazon S3、OneDrive 等）挂载为本地文件系统路径，并供 Ghost 博客平台直接访问，实现博客媒体文件（图片、附件等）的云存储管理，同时保留 Ghost 原生的博客发布与管理功能。

核心功能与特性

1. 云存储无缝集成

• 支持 rclone 兼容的所有云存储服务（超过 40 种，包括主流对象存储与文件存储服务）
• 云存储路径直接挂载至 Ghost 可访问的目录，无需手动上传/同步文件

2. Ghost 原生功能保留

• 基于官方 Ghost 镜像构建，完整支持 Ghost 的博客发布、主题管理、用户权限控制等核心功能
• 兼容 Ghost 的数据持久化机制，配置与内容可通过卷或云存储持久化

3. 灵活的挂载配置

• 支持自定义挂载路径、文件权限、缓存策略等 rclone 挂载参数
• 支持只读/读写模式切换，满足不同场景下的文件访问需求

4. 数据可靠性保障

• 云存储数据与 Ghost 应用数据分离管理，降低本地存储依赖
• 支持 rclone 的数据校验与错误恢复机制，提升文件访问稳定性

使用场景与适用范围

适用场景

• 媒体密集型博客：博客包含大量图片、视频等媒体文件，需利用云存储扩展存储空间
• 跨设备协作：团队成员需通过云存储共同管理博客素材，实现内容协同编辑
• 轻量化部署：在资源受限环境（如树莓派、小型服务器）中部署 Ghost，通过云存储节省本地磁盘空间
• 灾备需求：希望博客媒体文件自动备份至云存储，提升数据安全性

目标用户

• 个人博客作者
• 内容创作团队
• 小型自媒体运营者
• 需要低成本扩展存储的 Ghost 用户

使用方法与配置说明

前提条件

• 已安装 Docker 与 Docker Compose
• 已通过 rclone 配置文件（rclone.conf）定义云存储远程（可通过 rclone config 命令生成）

基本使用（Docker Run）

bash
docker run -d \
  --name ghost-rclonemount \
  -p 2368:2368 \
  -v /path/to/rclone.conf:/etc/rclone/rclone.conf:ro \
  -e RCLONE_REMOTE="myremote:ghost-data" \  # rclone 远程存储路径（格式：远程名称:路径）
  -e RCLONE_MOUNT_PATH="/var/lib/ghost/content/images" \  # 挂载至 Ghost 的路径（通常为媒体文件目录）
  -e GHOST_URL="https://your-blog-domain.com" \  # Ghost 博客访问 URL
  -e database__client="sqlite3" \  # 数据库配置（默认 SQLite，也可配置 MySQL/PostgreSQL）
  -e database__connection__filename="/var/lib/ghost/content/data/ghost.db" \
  your-registry/docker-rclonemount-ghost:latest

Docker Compose 配置示例

yaml
version: '3'

services:
  ghost-rclonemount:
    image: your-registry/docker-rclonemount-ghost:latest
    container_name: ghost-rclonemount
    restart: always
    ports:
      - "2368:2368"
    volumes:
      - ./rclone.conf:/etc/rclone/rclone.conf:ro  # 挂载本地 rclone 配置文件
      - ghost-data:/var/lib/ghost/content/data  # Ghost 核心数据（非媒体文件）
    environment:
      - RCLONE_REMOTE="my-s3-remote:blog-media"  # 云存储远程路径
      - RCLONE_MOUNT_PATH="/var/lib/ghost/content/images"  # Ghost 媒体文件存储路径
      - RCLONE_MOUNT_OPTIONS="--allow-other --vfs-cache-mode writes"  # rclone 挂载参数（允许其他用户访问、启用写缓存）
      - GHOST_URL="https://blog.example.com"
      - NODE_ENV="production"
      - database__client="mysql"  # 示例：使用 MySQL 数据库
      - database__connection__host="mysql-host"
      - database__connection__user="ghost-user"
      - database__connection__password="ghost-pass"
      - database__connection__database="ghost-db"

volumes:
  ghost-data:  # 本地卷存储 Ghost 配置与非媒体数据

关键配置参数说明

1. rclone 挂载配置

2. Ghost 核心配置

数据持久化说明

• 云存储数据：通过 RCLONE_REMOTE 指定的路径存储，由 rclone 负责与云存储同步
• Ghost 配置与数据库：建议通过 Docker 卷（如示例中的 ghost-data 卷）或云存储子路径持久化，避免容器重建后数据丢失

常见问题解决

• 挂载失败：检查 rclone.conf 是否正确挂载、RCLONE_REMOTE 是否在配置文件中存在、云存储服务是否可访问
• 文件访问缓慢：调整 RCLONE_MOUNT_OPTIONS，启用本地缓存（如 --vfs-cache-mode full）
• 权限问题：确保 RCLONE_MOUNT_OPTIONS 包含 --allow-other，允许 Ghost 进程访问挂载路径

支持的云存储服务

该镜像支持 rclone 兼容的所有云存储服务，包括但不限于：

• 对象存储：Amazon S3、Google Cloud Storage、Azure Blob Storage
• 文件存储：Google Drive、OneDrive、Dropbox、Box
• 分布式存储：MinIO、Ceph、Swift
• 本地存储：FTP、SFTP、WebDAV

完整列表可参考 rclone 官方文档。