elestio/parse-dashboard

Parse - 由 Elestio 验证和打包的 Docker 镜像

镜像概述和主要用途

https://github.com/parse-community/parse-server 是一个开源后端框架，可部署在任何能运行 Node.js 的基础设施上。Parse Server 与 Express Web 应用框架兼容，既可集成到现有 Web 应用中，也可独立运行。作为后端服务，它提供了数据存储、用户认证、实时查询等核心功能，简化移动应用和 Web 应用的后端开发流程。

!https://github.com/elestio-examples/parse/raw/main/parse.png

核心功能和特性

Parse 核心功能

• 多平台兼容：支持 iOS、Android、Web 等多端应用接入
• 数据存储：基于 MongoDB 的灵活数据存储方案
• 用户认证：内置用户注册、登录和权限管理
• 实时查询：支持 Live Query 功能，实现数据实时同步
• REST API：自动生成 RESTful API，减少手动接口开发

Elestio 镜像优势

• 同步更新：与官方源码保持同步，通过自动化流程快速发布新版本
• 及时修复：提供最新的 bug 修复和功能更新
• 质量控制：经过 Elestio 团队的质量检测，确保符合高标准

使用场景和适用范围

• 中小型应用后端：快速搭建无需从零开发的后端服务
• 现有 Web 应用集成：作为 Express 中间件集成到现有 Node.js 应用
• 开发与测试环境：提供一致的后端环境，简化团队协作
• 生产环境部署：配合 Elestio 托管服务可获得自动化备份、SSL 终止、防火墙等企业级特性

详细使用方法和配置说明

环境准备

• 安装 Git、Docker 和 Docker Compose
• 确保服务器开放 1337（Parse Server）和 4040（Parse Dashboard）端口

部署步骤

1. 克隆代码仓库

bash
git clone https://github.com/elestio-examples/parse.git
cd parse

2. 配置环境变量

复制示例环境变量文件并修改为自定义值：

bash
cp ./tests/.env ./.env

编辑 .env 文件，关键配置项说明：

• PARSE_SERVER_APPLICATION_ID：应用唯一标识（必填，建议使用 UUID）
• MASTER_KEY：主密钥（必填，用于管理员操作）
• ADMIN_EMAIL：Parse Dashboard 登录***
• ADMIN_PASSWORD：Parse Dashboard 登录密码
• SOFTWARE_VERSION_TAG：镜像版本标签（如 latest）

3. 创建数据目录并设置权限

bash
mkdir -p ./data 
chown -R 1001:1001 ./data  # 确保容器进程可读写数据目录

4. 启动服务

bash
docker-compose up -d

服务启动后，可通过以下地址访问：

• Parse Dashboard：http://你的域名:4040（使用 .env 中配置的管理员账号登录）
• Parse Server API：http://你的域名:1337/parse

Docker Compose 配置示例

以下是完整的 docker-compose.yml 配置：

yaml
version: "3.3"
services:
  mongo:
    image: mongo
    restart: always
    volumes:
      - ./data:/data/db  # MongoDB 数据持久化

  parse:
    image: elestio/parse:${SOFTWARE_VERSION_TAG}
    restart: always
    ports:
      - 172.17.0.1:1337:1337  # Parse Server 端口映射
    links:
      - mongo  # 连接 MongoDB 服务
    environment:
      - PARSE_SERVER_APPLICATION_ID=${PARSE_SERVER_APPLICATION_ID}  # 应用 ID
      - PARSE_SERVER_MASTER_KEY=${MASTER_KEY}  # 主密钥
      - PARSE_SERVER_DATABASE_URI=mongodb://mongo:27017/dev  # MongoDB 连接地址
      - PARSE_SERVER_START_LIVE_QUERY_SERVER=1  # 启用实时查询
      - PARSE_SERVER_LIVE_QUERY={"classNames":["people","monitor"]}  # 实时查询监控的集合
      - PARSE_SERVER_MASTER_KEY_IPS=0.0.0.0/0  # 允许所有 IP 使用主密钥（生产环境建议限制 IP）

  dashboard:
    image: parseplatform/parse-dashboard:${SOFTWARE_VERSION_TAG}
    restart: always
    ports:
      - "172.17.0.1:4040:4040"  # Dashboard 端口映射
    environment:
      - PARSE_DASHBOARD_SERVER_URL=${BASE_URL}:1337/parse  # Parse Server 地址
      - PARSE_DASHBOARD_APP_ID=${PARSE_SERVER_APPLICATION_ID}  # 应用 ID（需与 Parse Server 一致）
      - PARSE_DASHBOARD_MASTER_KEY=${MASTER_KEY}  # 主密钥（需与 Parse Server 一致）
      - PARSE_DASHBOARD_APP_NAME=MyApp  # 应用名称（自定义）
      - PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1  # 允许 HTTP 访问（生产环境建议关闭并配置 HTTPS）
      - PARSE_DASHBOARD_USER_ID=${ADMIN_EMAIL}  # Dashboard 登录邮箱
      - PARSE_DASHBOARD_USER_PASSWORD=${ADMIN_PASSWORD}  # Dashboard 登录密码

维护与管理

日志管理

查看服务日志：

bash
docker-compose logs -f  # -f 参数实时跟踪日志输出

停止服务：

bash
docker-compose down

数据备份与恢复

备份数据

1. 停止服务：

   bash
   docker-compose down
   

2. 压缩数据目录（包含 MongoDB 数据和配置文件）：

   bash
   zip -r parse_backup_$(date +%Y%m%d).zip .
   

恢复数据

1. 将备份文件解压到原部署目录：

   bash
   unzip parse_backup_20240101.zip -d /path/to/parse/deployment
   

2. 启动服务：

   bash
   docker-compose up -d
   

相关链接

• https://github.com/parse-community/parse-server
• Parse 官方文档
• https://github.com/elestio-examples/parse
• Elestio 托管 Parse 服务（提供自动化备份、SSL 等企业级特性）