欢迎使用Markdown编辑器

背景

最近身边越来越多人开始用AI辅助编程，Cursor、Copilot、Claude这些工具确实能提升不少效率。但很多人卡在第一步——环境配置。

上周朋友找我帮忙，他买了个云服务器想搭一套API中转服务，自己调用方便又省钱。折腾了两天没搞定，让我帮看看。

遇到的问题

1. 国内服务器拉不到Docker镜像（懂的都懂）
2. Docker Compose版本不对，yaml语法报错
3. Nginx反代配置有坑，setup页面404
4. 数据库连接超时，原来是没做持久化

我的解决方案

后来我干脆写了个一键部署脚本，把这些坑全自动处理了：

• 自动检测系统环境（CentOS/Ubuntu/Debian）
• 自动配置国内Docker镜像源（多源fallback）
• 自动处理防火墙和SELinux
• Docker Compose一把拉起所有服务
• 部署完自动生成卸载脚本和重启脚本

整个过程5分钟左右，基本不需要手动干预。

技术栈

架构简图

用户请求 → Nginx(443) → Go服务(3000) → 上游API
                              ↓
                     PostgreSQL + Redis

踩坑记录

坑1：CentOS 7 的Docker源问题

官方源被墙，阿里云镜像源也时好时坏。最终方案是在daemon.json里配多个mirror，按优先级fallback。

坑2：Nginx location匹配

/setup 和 /setup/ 是两个不同的路由，漏配一个就404。

坑3：容器数据丢失

docker-compose里一定要挂载volume，不然重启数据全没。

后续

帮完朋友之后，他同事也找过来了，后来陆续帮了十几个人部署。发现这个需求还挺普遍的——很多人想用AI工具但不会配环境。

如果你也有类似需求，或者对这套部署方案感兴趣，可以私信交流。我把文档和脚本都整理好了，有Linux和Windows两个版本。

个人主页有联系方式，技术交流欢迎私信。