快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
生成Windows版SUPABASE本地部署图文教程，包含：1. Docker Desktop安装指引 2. 终端命令分步截图 3. 端口冲突解决方法 4. 基础API测试用例（curl命令）5. 可视化工具推荐。要求使用Markdown格式，配图说明关键步骤。- 点击'项目生成'按钮，等待项目生成完整后预览效果
小白也能懂：Windows电脑本地运行SUPABASE教程
最近想尝试用SUPABASE做个小项目，但完全没接触过Docker这类工具。摸索了两天后，终于成功在Win11上跑起来了，把踩坑经验整理成这份新手友好指南。
一、准备工作：安装Docker Desktop
官网下载安装包（注意选Windows版本），双击运行后勾选"Use WSL 2"选项。安装完成后需要重启电脑，这个步骤大概会占用3GB左右空间。
重启后打开Docker Desktop，右下角系统托盘出现鲸鱼图标说明启动成功。第一次启动可能会提示安装WSL内核更新包，按指引完成即可。
二、SUPABASE本地部署全流程
打开终端（推荐用Windows Terminal），先创建项目目录并进入：
mkdir supabase-local cd supabase-local获取官方docker-compose配置：
curl -L https://supabase.com/static/docker/docker-compose.yml -o docker-compose.yml启动容器（首次运行会自动下载约2GB镜像）：
docker-compose up -d
三、常见问题解决方案
端口冲突：如果3000/5432等端口被占，修改docker-compose.yml里的ports配置，比如把"3000:3000"改为"3001:3000"
内存不足：建议电脑至少有8GB内存，在Docker设置里将内存限制调到4GB以上
启动失败：运行
docker logs supabase-studio查看具体错误，最常见的是PostgreSQL初始化超时，多试几次即可
四、验证服务是否正常
- 浏览器访问 http://localhost:3000 应该能看到登录页
- 用curl测试API（先在管理界面创建API密钥）：
curl -X POST 'http://localhost:54321/rest/v1/' \ -H "apikey: YOUR_KEY" \ -H "Content-Type: application/json"
五、配套工具推荐
- TablePlus：比pgAdmin更轻量的数据库GUI工具
- Insomnia：测试API接口超方便
- DBeaver：功能全面的开源数据库管理工具
整个过程其实比想象中简单，主要耗时在镜像下载。如果不想折腾本地环境，也可以试试InsCode(快马)平台的在线开发环境，自带预配置的SUPABASE模板，点几下就能开始写业务代码，特别适合快速验证想法。
实际体验发现这种云开发平台确实省心，不用配环境就能直接调试API，部署成功率比本地高很多。遇到问题还能随时在社区提问，对新手特别友好。
快速体验
- 打开 InsCode(快马)平台 https://www.inscode.net
- 输入框内输入如下内容：
生成Windows版SUPABASE本地部署图文教程，包含：1. Docker Desktop安装指引 2. 终端命令分步截图 3. 端口冲突解决方法 4. 基础API测试用例（curl命令）5. 可视化工具推荐。要求使用Markdown格式，配图说明关键步骤。- 点击'项目生成'按钮，等待项目生成完整后预览效果
