neilalcoseba/pgadmin4

neilalcoseba/pgadmin4镜像说明

镜像概述

本镜像为针对树莓派（ARM架构）优化的非官方pgAdmin4分发版，版本为5.7，基于Alpine Linux 3.12.7系统以适配树莓派硬件特性。注意：pgAdmin4 v6.x版本无法在树莓派32位架构上运行。

核心功能

• 提供PostgreSQL数据库的图形化管理界面
• 支持数据库连接配置、SQL查询执行、用户权限管理等核心操作
• 适配树莓派ARM架构，运行轻量高效

使用场景

• 树莓派本地部署PostgreSQL后的可视化管理
• 小型开发/测试环境中的数据库运维
• 嵌入式设备上的PostgreSQL实例监控

配置说明

环境变量

• PGADMIN_DEFAULT_EMAIL：默认管理员***（必填）
• PGADMIN_DEFAULT_PASSWORD：默认管理员密码（必填）
• PGADMIN_DISABLE_POSTFIX：禁用Postfix邮件服务（可选）
• PGADMIN_CONFIG_ENHANCED_COOKIE_PROTECTION：增强Cookie保护（可选）

卷挂载

• /var/lib/pgadmin：持久化pgAdmin配置与数据

部署示例

Docker Run

bash
docker run -p 8080:80 \
    -e 'PGADMIN_DEFAULT_EMAIL=<你的邮箱>' \
    -e 'PGADMIN_DEFAULT_PASSWORD=<你的密码>' \
    -v <本地挂载路径>:/var/lib/pgadmin \
    -d neilalcoseba/pgadmin4:5.7

Docker Compose

yaml
version: "3.3"
   
services:
  pgadmin4:
    image: neilalcoseba/pgadmin4:5.7
    container_name: pgadmin4
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - <本地挂载路径>:/var/lib/pgadmin
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    environment:
      - PGADMIN_DISABLE_POSTFIX=True
      - PGADMIN_CONFIG_ENHANCED_COOKIE_PROTECTION=True
      - PGADMIN_DEFAULT_EMAIL=<你的邮箱>
      - PGADMIN_DEFAULT_PASSWORD=<你的密码>

Kubernetes配置

yaml
apiVersion: v1
kind: Pod
metadata:
    name: pgadmin4
    labels:
       app: pgadmin4
       tier: dev
spec:
    containers:
    - image: neilalcoseba/pgadmin4:5.7
      name: pgadmin4
      volumeMounts:
      - name: data
        mountPath: /var/lib/pgadmin
      env:
      - name: PGADMIN_DISABLE_POSTFIX
        value: 'true'
      - name: PGADMIN_DEFAULT_EMAIL
        value: <你的登录邮箱>
      - name: PGADMIN_DEFAULT_PASSWORD
        value: <你的密码>
      ports:
      - containerPort: 80
        protocol: TCP
    volumes:
    - name: data
      hostPath:
         path: <本地路径>
         type: Directory

---
apiVersion: v1
kind: Service
metadata:
  name: pgadmin4
spec:
  selector:
    app: pgadmin4
  ports:
    - protocol: TCP
      port: 80
      targetPort: 80

---
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: pgadmin4
  annotations:
    kubernetes.io/ingress.class: "traefik"
spec:
  rules:
  - http:
      paths:
      - path: /
        pathType: Exact
        backend:
          service:
             name: pgadmin4
             port:
                number: 80

常见问题解决

错误：Failed to create the directory /var/lib/pgadmin/sessions: [Errno 13] Permission denied
解决方案：检查挂载目录的读写权限，执行以下命令：

bash
cd /path/to/mount/directory
sudo chmod a+rw . -R

参考链接

• https://www.pgadmin.org/docs/pgadmin4/latest/container_deployment.html
• https://github.com/postgres/pgadmin4.git