tk2232/parse-init

parse-init Docker镜像

该镜像为Parse Server的初始化容器，用于快速配置Parse Server的各项环境变量，简化部署流程。

镜像概述

Parse Server是开源的后端服务框架，适用于移动应用和Web应用的后端构建。本镜像作为其初始化容器，通过环境变量配置数据库连接、密钥、缓存、实时查询等核心参数，帮助用户快速启动Parse Server服务。

核心功能

• 支持MongoDB数据库连接（完整URI、主机+端口+用户密码等多种配置方式）
• 管理Parse Server密钥（Master Key、Client Key等）
• 配置Redis缓存及实时查询（Live Query）的Redis连接
• 支持GraphQL接口与Playground挂载配置
• 自定义文件上传大小、日志保留数量等参数
• 允许添加额外环境变量扩展功能

使用场景

• 开发环境快速搭建Parse Server，进行后端开发与测试
• 生产环境根据需求配置自定义参数，部署稳定的Parse Server服务
• 需要集成Redis缓存或实时查询功能的Parse Server项目

配置说明

以下是主要环境变量的配置说明：

SERVER_URL

默认值：0.0.0.0
Parse Server监听地址

PORT

默认值：1337
Parse Server监听端口

MASTER_KEY

必填项
Parse Server主密钥，用于执行高级操作

CLIENT_KEY

可选项
客户端密钥

MONGODB_FULL_URI

三选一（与MONGODB_HOST、MONGODB_SERVICE）
MongoDB完整连接URI，示例：mongodb://user:password@url:port/?options/db

MONGODB_HOST

三选一
MongoDB主机地址，示例：mongodb0.example.com

MONGODB_SERVICE

三选一
MongoDB服务名称（适用于Kubernetes等容器编排环境）

MONGODB_USER

MongoDB用户名

MONGODB_PASSWORD

MongoDB密码

MONGODB_PORT

默认值：27017
MongoDB端口

MONGODB_DATABASE

MongoDB数据库名称

MONGODB_OPTIONS

MongoDB连接选项，示例：/?authSource=admin

APP_ID

必填项
Parse应用ID

APP_NAME

Parse应用名称

MOUNT_PATH

默认值：/parse
Parse Server挂载路径

CLOUD_CODE_PATH

默认值：./cloud/main.js
云代码路径，设为空可禁用云代码

REDIS_CACHE_PASSWORD

可选项
Redis缓存密码

REDIS_CACHE_OPTIONS

Redis缓存连接选项，参考https://www.npmjs.com/package/redis#rediscreateclient%EF%BC%8C%E5%AF%86%E7%A0%81%E9%9C%80%E9%80%9A%E8%BF%87%60REDIS_CACHE_PASSWORD%60%E8%AE%BE%E7%BD%AE%EF%BC%8C%E7%A4%BA%E4%BE%8B%EF%BC%9A%60%7B%22url": "example.com","db": "test-db", "option2": "value"}`

MAX_UPLOAD_SIZE

默认值：10mb
最大文件上传大小，示例：20mb

LIVE_QUERY_CLASSNAMES

可选项
实时查询类名列表（无空格），示例：apple,orange,pear

LIVE_QUERY_REDIS_URL

可选项
实时查询Redis连接URL或服务名称，示例：redis://parse-redis-service

LIVE_QUERY_REDIS_PASSWORD

可选项
实时查询Redis密码

LIVE_QUERY_REDIS_OPTIONS

可选项
实时查询Redis连接选项，参考https://www.npmjs.com/package/redis#rediscreateclient%EF%BC%8C%E5%AF%86%E7%A0%81%E5%92%8CURL%E9%9C%80%E5%88%86%E5%88%AB%E9%80%9A%E8%BF%87%60LIVE_QUERY_REDIS_PASSWORD%60%E5%92%8C%60LIVE_QUERY_REDIS_URL%60%E8%AE%BE%E7%BD%AE%EF%BC%8C%E7%A4%BA%E4%BE%8B%EF%BC%9A%60%7B%22db": "test-db", "option2": "value"}`

ACCOUNT_LOCKOUT

可选项
账号锁定配置，默认：{"duration":5,"threshold":3}，示例：{"duration":2,"threshold":6}（duration为锁定时长，threshold为失败尝试次数）

PUBLIC_SERVER_URL

可选项
文件访问公共URL（需包含挂载路径），参考https://docs.parseplatform.org/parse-server/guide/

MOUNT_GRAPHQL

默认值：false
是否挂载GraphQL接口

GRAPHQL_PATH

默认值：/graphql
GraphQL接口路径

MOUNT_PLAYGROUND

默认值：false
是否挂载GraphQL Playground（生产环境不建议使用，推荐Parse Dashboard内置版本）

PLAYGROUND_PATH

默认值：/playground
GraphQL Playground路径

MAX_LOG_FILES

默认值：1000
最大保留日志文件数（可加'd'指定天数）

VERBOSE

默认值：false
是否开启详细日志

EXTRA_ENV_VARS

可选项
额外环境变量（JSON字符串），参考https://github.com/parse-community/parse-server/blob/master/src/Options/index.js%EF%BC%8C%E7%A4%BA%E4%BE%8B%EF%BC%9A%60%7B%22jsonLogs": true}`

Docker部署示例

shell
docker run \
-e MASTER_KEY="masterKey" \
-e MONGODB_HOST="localhost" \
-e APP_ID="appId" \
-e APP_NAME="appName" \
-e REDIS_CACHE_PASSWORD="redisCachepw" \
-e REDIS_CACHE_OPTIONS='{"url": "redis://redis-service"}' \
-e LIVE_QUERY_CLASSNAMES='apple,orange,pear,banana,raspberry,peach' \
-e LIVE_QUERY_REDIS_PASSWORD="liveQueryRedisPW" \
-e LIVE_QUERY_REDIS_URL="redis://redis-url" \
-e MONGODB_URI="example.mongo.com" \
tk2232/parse-init