elestio/parse-server

Parse 镜像文档 (由 Elestio 验证与打包)

镜像概述与主要用途

https://github.com/parse-community/parse-server 是一个开源后端框架，可部署在任何能运行 Node.js 的基础设施上。Parse Server 与 Express Web 应用框架配合使用，既可集成到现有 Web 应用中，也可独立运行。

本镜像由 Elestio 验证并打包，确保与官方源代码更新同步，提供稳定可靠的部署方案。

如果您需要自动化备份、带 SSL 终止的反向代理、防火墙、自动化操作系统与软件更新，以及专业团队保障服务安全与可用，可在 elest.io 上部署 完全托管的 Parse。

https://github.com/elestio-examples/parse/raw/main/deploy-on-elestio.png]([***]

核心功能与特性

Parse 核心功能

• 开源后端框架，支持 Node.js 环境部署
• 与 Express 框架深度集成，灵活扩展
• 提供数据存储、用户认证、推送通知等后端基础能力
• 支持实时查询（Live Query）功能

Elestio 镜像优势

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

使用场景与适用范围

• 开发需要灵活后端支持的 Web 或移动应用
• 现有应用需要快速集成后端服务（如数据存储、用户管理）
• 希望避免从零构建后端基础设施的开发团队
• 需要自托管后端以满足数据隐私或合规要求的场景

详细使用方法与配置说明

环境准备

确保本地已安装：

• Git
• Docker 与 Docker Compose
• 适当的文件系统权限（用于创建数据目录）

通过 Git 克隆部署

1. 克隆代码仓库

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

2. 配置环境变量

复制测试环境的 .env 文件到项目根目录：

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

编辑 .env 文件，设置自定义值（关键参数说明见下文）：

bash
vi .env

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

bash
mkdir -p ./data 
chown -R 1001:1001 ./data  # 确保容器进程有权限访问

4. 启动服务

bash
docker-compose up -d

服务启动后，可通过 http://您的域名:4040 访问 Parse Dashboard。

Docker Compose 配置详解

以下是完整的 docker-compose.yml 配置示例，包含三个核心服务：MongoDB 数据库、Parse Server 和 Parse Dashboard。

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

    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}  # 应用唯一标识
            - 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 使用主密钥访问（生产环境需限制）

    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}  # 与 Parse Server 的应用 ID 一致
            - PARSE_DASHBOARD_MASTER_KEY=${MASTER_KEY}  # 与 Parse Server 的主密钥一致
            - PARSE_DASHBOARD_APP_NAME=MyApp  # 应用名称（显示在 Dashboard 中）
            - PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1  # 允许 HTTP 访问（生产环境建议关闭并配置 HTTPS）
            - PARSE_DASHBOARD_USER_ID=${ADMIN_EMAIL}  # Dashboard 登录用户名
            - PARSE_DASHBOARD_USER_PASSWORD=${ADMIN_PASSWORD}  # Dashboard 登录密码

关键环境变量说明（.env 文件）

维护与管理

日志查看

Parse 容器日志输出到标准输出，可通过以下命令查看：

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

停止服务栈：

bash
docker-compose down

数据备份与恢复

备份数据

1. 停止服务栈确保数据一致性：

   bash
   docker-compose down
   

2. 进入 docker-compose.yml 所在目录，创建包含所有数据的压缩包：

   bash
   zip -r parse_backup_$(date +%Y%m%d).zip .  # 包含数据目录、配置文件等
   

恢复数据

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

   bash
   unzip parse_backup_20240101.zip -d /path/to/original/folder
   

2. 启动服务栈：

   bash
   cd /path/to/original/folder
   docker-compose up -d
   

相关链接

• https://github.com/parse-community/parse-server
• Parse 官方文档
• https://github.com/elestio-examples/parse# Parse 镜像文档 (由 Elestio 验证与打包)

镜像概述与主要用途

https://github.com/parse-community/parse-server 是一个开源后端框架，可部署在任何能运行 Node.js 的基础设施上。Parse Server 与 Express Web 应用框架配合使用，既可集成到现有 Web 应用中，也可独立运行。

本镜像由 Elestio 验证并打包，确保与官方源代码更新同步，提供稳定可靠的部署方案。

如果您需要自动化备份、带 SSL 终止的反向代理、防火墙、自动化操作系统与软件更新，以及专业团队保障服务安全与可用，可在 elest.io 上部署 完全托管的 Parse。

https://github.com/elestio-examples/parse/raw/main/deploy-on-elestio.png]([***]

核心功能与特性

Parse 核心功能

• 开源后端框架，支持 Node.js 环境部署
• 与 Express 框架深度集成，灵活扩展
• 提供数据存储、用户认证、推送通知等后端基础能力
• 支持实时查询（Live Query）功能

Elestio 镜像优势

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

使用场景与适用范围

• 开发需要灵活后端支持的 Web 或移动应用
• 现有应用需要快速集成后端服务（如数据存储、用户管理）
• 希望避免从零构建后端基础设施的开发团队
• 需要自托管后端以满足数据隐私或合规要求的场景

详细使用方法与配置说明

环境准备

确保本地已安装：

• Git
• Docker 与 Docker Compose
• 适当的文件系统权限（用于创建数据目录）

通过 Git 克隆部署

1. 克隆代码仓库

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

2. 配置环境变量

复制测试环境的 .env 文件到项目根目录：

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

编辑 .env 文件，设置自定义值（关键参数说明见下文）：

bash
vi .env

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

bash
mkdir -p ./data 
chown -R 1001:1001 ./data  # 确保容器进程有权限访问

4. 启动服务

bash
docker-compose up -d

服务启动后，可通过 http://您的域名:4040 访问 Parse Dashboard。

Docker Compose 配置详解

以下是完整的 docker-compose.yml 配置示例，包含三个核心服务：MongoDB 数据库、Parse Server 和 Parse Dashboard。

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

    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}  # 应用唯一标识
            - 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 使用主密钥访问（生产环境需限制）

    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}  # 与 Parse Server 的应用 ID 一致
            - PARSE_DASHBOARD_MASTER_KEY=${MASTER_KEY}  # 与 Parse Server 的主密钥一致
            - PARSE_DASHBOARD_APP_NAME=MyApp  # 应用名称（显示在 Dashboard 中）
            - PARSE_DASHBOARD_ALLOW_INSECURE_HTTP=1  # 允许 HTTP 访问（生产环境建议关闭并配置 HTTPS）
            - PARSE_DASHBOARD_USER_ID=${ADMIN_EMAIL}  # Dashboard 登录用户名
            - PARSE_DASHBOARD_USER_PASSWORD=${ADMIN_PASSWORD}  # Dashboard 登录密码

关键环境变量说明（.env 文件）

维护与管理

日志查看

Parse 容器日志输出到标准输出，可通过以下命令查看：

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

停止服务栈：

bash
docker-compose down

数据备份与恢复

备份数据

1. 停止服务栈确保数据一致性：

   bash
   docker-compose down
   

2. 进入 docker-compose.yml 所在目录，创建包含所有数据的压缩包：

   bash
   zip -r parse_backup_$(date +%Y%m%d).zip .  # 包含数据目录、配置文件等
   

恢复数据

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

   bash
   unzip parse_backup_20240101.zip -d /path/to/original/folder
   

2. 启动服务栈：

   bash
   cd /path/to/original/folder
   docker-compose up -d
   

相关链接

• https://github.com/parse-community/parse-server
• Parse 官方文档
• [Elestio/parse