本地RDS直连真实数据库MiniStack拉起真实Postgres/MySQL容器的完整指南【免费下载链接】ministackMinistack: Free, open-source local AWS emulator - 60 services, Terraform compatible, real databases. Free forever. MIT licensed.项目地址: https://gitcode.com/gh_mirrors/mi/ministackMiniStack 是一款免费开源的本地 AWS 模拟器MIT 协议在单一端口 4566 上模拟 60 项 AWS 云服务且兼容 boto3、AWS CLI 和 Terraform。它的 RDS 服务最大的亮点是真——调用CreateDBInstance时MiniStack 会通过 Docker 拉起真实的 Postgres / MySQL 容器并返回可直接用psql、mysql客户端或 ORM 直连的host:port端点数据落盘、事务、TLS、权限全部真实可用。本文带你快速完成本地 RDS 直连配置。为什么本地测试需要真实数据库纯内存模拟的数据库只能验证 API 调用链路一旦涉及连接字符串、驱动行为SSL 模式、预编译语句权限模型GRANT、默认数据库、超级用户真实 SQL 兼容性方言、事务隔离级别就会穿帮。MiniStack 选择用容器承载真实数据库进程实现见 ministack/services/rds.py让本地测试与云上行为最大程度一致且零成本、零账号、零 API Key。三步快速开始安装 MiniStack 并挂载 Docker 真实数据库能力依赖宿主机 Docker所以安装时必须把 Docker socket 挂进去# 1. 安装PyPI 最简方式 pip install ministack # 2. 用 Docker 运行并挂载 Docker socketpip 运行时则确保本机 Docker 可用 docker run -p 4566:4566 \ -v /var/run/docker.sock:/var/run/docker.sock \ ministackorg/ministack # 3. 验证健康检查 curl http://localhost:4566/_ministack/health 也可以pip install ministack后直接执行ministack启动需本机有 Docker 守护进程。从源码构建可参考仓库根目录的 docker-compose.yml 与 Dockerfile。调用 CreateDBInstance 拉起真实容器用任意 AWS SDK 调用 RDS APIMiniStack 会完成选镜像 → 分配端口 → 启动容器 → 返回端点全流程import boto3, psycopg2 rds boto3.client(rds, endpoint_urlhttp://localhost:4566, aws_access_key_idtest, aws_secret_access_keytest, region_nameus-east-1) resp rds.create_db_instance( DBInstanceIdentifiermydb, DBInstanceClassdb.t3.micro, Enginepostgres, MasterUsernameadmin, MasterUserPasswordpassword, DBNameappdb, AllocatedStorage20, ) ep resp[DBInstance][Endpoint] conn psycopg2.connect(hostep[Address], portep[Port], useradmin, passwordpassword, dbnameappdb) print(conn) # 真实连接成功几个关键行为源码实现行为说明镜像映射postgres/aurora-postgresql→postgres:大版本-alpinemysql/mariadb/aurora-mysql→ 官方mysql镜像见_docker_image_for_engine端口分配宿主机端口从RDS_BASE_PORT默认15432起自动顺延见_next_port状态流转镜像首次拉取时创建请求立即返回creating后台完成启动后转available与真实 AWS 体验一致容器治理容器带ministackrds标签删除实例或/_ministack/reset时由容器回收器清理ministack/core/container_reaper.py直连数据库psql 与 mysql 客户端配置 拿到端点后就是标准数据库操作# PostgreSQL psql postgresql://admin:passwordlocalhost:15432/appdb # MySQL mysql -h localhost -P 15433 -u admin -p appdb两个和云上一样的细节TLS 默认开启Postgres 实例由 MiniStack 自签的 RDS 风格 CAAmazon RDS region Root CA RSA2048 G1签发服务器证书sslmodeverify-full可正常校验MySQL 镜像自动生成证书、默认sslON证书逻辑见 ministack/services/rds.py。RDS Data API 直达真实容器ExecuteStatement等操作会把 SQL 路由到同一个数据库容器执行ministack/services/rds_data.pyAurora 场景下可免驱动直发 SQL。Aurora 集群、持久化与 IAM 认证Aurora 集群共享计算CreateDBCluster后各成员实例共用一个集群级数据库容器读写端点与只读端点均真实可达开启MINISTACK_RDS_PG_CLUSTER_REPLICATION1后Aurora PostgreSQL 集群的第二及以后成员会获得独立的pg_basebackup热备只读容器rds.py。数据持久化默认使用 256MB tmpfs重启清空模拟云上轻量本地测试设置RDS_PERSIST1改用 Docker 命名卷数据跨重启保留配合PERSIST_STATE1可恢复完整 RDS 元数据ministack/core/persistence.py。IAM 数据库认证支持 RDS IAM 认证令牌校验配套 MySQL IAM 认证插件contrib/mysql-iam-plugin/aws_auth_plugin.cc测试覆盖见 tests/test_rds_iam.py。常用环境变量速查变量默认值用途RDS_BASE_PORT15432RDS 容器宿主机起始端口RDS_PERSIST01 用命名卷持久化数据库数据RDS_TMPFS_SIZE256mtmpfs 模式下的数据区大小MINISTACK_RDS_PUBLIC_ENDPOINT01 面向容器外客户端返回宿主机发布端口DOCKER_NETWORK未设置让 Lambda 等容器按服务名访问数据库MINISTACK_IMAGE_PREFIX未设置私有镜像仓库前缀CI 离线环境必备完整配置表见 README.md 的 Configuration 章节。常见问题排查 连接被拒绝确认已挂载 Docker socket且端点状态为availableDescribeDBInstances查看镜像首次拉取需要一点时间。端口冲突启动时会自动跳过被占用的端口并记录日志无需手动干预。数据丢了默认 tmpfs 设计即用完即弃需要数据留存请设置RDS_PERSIST1。想跑测试验证RDS 行为测试集中在 tests/test_rds.py、tests/test_rds_data.py可直接作为使用示例参考。小结MiniStack 用真实容器 AWS 兼容 API的组合让本地 RDS 开发从能调通进化到能直连一条CreateDBInstance即可获得可psql/mysql连接的真实数据库配合 Data API、Aurora 集群与 IAM 认证本地环境即可完整覆盖大多数数据库相关测试场景。所有能力免费、开源、永久可用欢迎从 README.md 开始上手完整功能。【免费下载链接】ministackMinistack: Free, open-source local AWS emulator - 60 services, Terraform compatible, real databases. Free forever. MIT licensed.项目地址: https://gitcode.com/gh_mirrors/mi/ministack创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考