timothyjmiller/prisma-studio

Prisma Studio (Docker版)

镜像概述和主要用途

这是一个用于通过Web浏览器访问Prisma Studio的Docker镜像，基于Alpine Linux构建，包含NodeJS LTS和@prisma/cli模块。该镜像可自动 introspect PostgreSQL数据库并生成schema.prisma文件，提供可视化界面管理数据库，适用于团队共享多环境数据库访问和企业级多环境部署。

核心功能和特性

安全特性

• 基于Alpine Linux基础镜像，轻量且安全
• 开源可审计，支持公开审查
• 定期更新，减少安全漏洞
• 零额外依赖，最小化***面
• Docker运行时环境，隔离性强

架构支持

• 当前支持AMD64架构（受@prisma/cli限制）
• ARM64架构将在Prisma官方支持后提供（相关GitHub Issue：https://github.com/prisma/prisma/issues/861%EF%BC%89

核心功能

• 自动生成Prisma schema文件（schema.prisma）
• 通过Web浏览器访问Prisma Studio界面
• 支持多环境数据库隔离部署
• 可通过Traefik实现全局访问

使用场景和适用范围

• 团队协作：共享多个数据库环境访问权限
• 多环境管理：开发、测试、生产环境数据库分离
• 企业级部署：需要安全隔离和全局访问的场景
• 快速数据库可视化：无需本地安装Prisma Studio，通过Docker快速部署

详细使用方法和配置说明

部署步骤

使用提供的docker-compose.yml文件作为部署基础：

yaml
version: '3.7'
services:
  prisma-studio:
    container_name: prisma-studio
    image: timothyjmiller/prisma-studio:latest
    restart: unless-stopped
    env_file:
     - .env
    ports:
      - ${PRISMA_STUDIO_PORT}:5555
  postgres:
    container_name: prisma-postgres
    image: postgres:alpine
    restart: always
    env_file:
     - .env
    ports:
      - ${POSTGRES_PORT}:5432
    volumes:
      - ${POSTGRES_PATH}/${PROJECT_NAME}/${POSTGRES_DATABASE}/:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 10s
      timeout: 5s
      retries: 5

环境变量配置

⚠️ 警告

确保为PostgreSQL数据库安全生成新密码以用于Prisma Studio。

1. 创建.env文件
2. 添加以下内容：

bash
PROJECT_NAME=demo-project
POSTGRES_DATABASE=development
POSTGRES_HOST=postgres
POSTGRES_USERNAME=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_PORT=5432
PRISMA_STUDIO_PORT=5555
POSTGRES_PATH=/postgres

根据主机端口可用性，可能需要修改PostgreSQL和Prisma Studio的端口号。

企业级部署

对于高级部署和/或咨询，可通过邮件或***联系作者。

创建三个.env配置文件：

1. development（开发环境）
2. testing（测试环境）
3. production（生产环境）

每个配置应包含独立的数据库名称（development、testing、production）、端口号以及唯一密码。安全存储PostgreSQL数据库凭证。

安全最佳实践

• 将不同的PostgreSQL环境部署在独立的Docker容器中
• 按环境共享数据库访问权限
• 通过Traefik部署以实现全局访问

统计信息

许可证

本模板采用GNU通用公共许可证第3版（GPLv3）授权。

作者

Timothy Miller

https://github.com/timothymiller

查看个人网站 💻