AI智能体全栈部署实操指南

从零开始,免翻墙部署你的AI应用 | 可复制的完整工作流

🛠️ 核心工具角色说明

🌐

Cloudflare

全球CDN与网络代理服务商

角色:
• DNS管理器
• API代理服务器
• 网络加速与防护

Vercel

前端部署与边缘计算平台

角色:
• 代码构建与部署
• 全球CDN分发
• 持续集成/发布
🐙

GitHub

代码托管与协作平台

角色:
• 源代码仓库
• 版本控制
• 与Vercel自动同步
🤖

Google AI Studio

AI模型开发与测试平台

角色:
• AI模型测试
• API密钥生成
• 应用原型开发

📋 四阶段部署流程

🗺️

阶段一:拿下"地皮"与产权交接

域名购买与DNS配置

核心目标

购买专属域名并将DNS管理权交给Cloudflare,为后续全球加速和API代理打下基础。

1

购买域名

在阿里云、腾讯云或GoDaddy等平台购买域名(如:your-domain.top)

购买后域名默认由购买平台解析,接下来需要转移到Cloudflare
2

注册并添加域名到Cloudflare

访问 cloudflare.com 注册免费账号,点击 "Add a Site" 添加你的域名

3

获取交接暗号(Nameservers)

Cloudflare会扫描DNS记录后,分配两个专属名称服务器:

例如:jocelyn.ns.cloudflare.com
      kirk.ns.cloudflare.com
4

修改DNS服务器

回到域名购买平台(如阿里云控制台):

  • 找到"修改DNS/自定义DNS"入口
  • 删除原有的服务器地址
  • 填入Cloudflare给的两个Nameserver地址
  • 保存设置
5

等待生效并完成交接

在Cloudflare点击"I updated my nameservers",等待10-30分钟

✉️ 收到Cloudflare的"Status Active"邮件即代表域名正式接管成功!
🚇

阶段二:打通"地下管道"

搭建免翻墙API代理

核心目标

利用Cloudflare Workers创建API代理,绕过网络限制,让国内用户能直接访问Google/OpenAI等海外API。

1

创建Worker应用

在Cloudflare控制台:

  • 左侧菜单点击 "Workers & Pages"
  • 点击 "Create application" → "Create Worker"
  • 起个名字(如:gemini-proxy)
  • 点击 Deploy 部署
2

植入代理代码

点击 "Edit code",清空原有代码,粘贴以下核心代理逻辑:

export default { async fetch(request, env) { const url = new URL(request.url); // 将请求目标强行替换为Google官方API地址 url.host = 'generativelanguage.googleapis.com'; return fetch(new Request(url, request)); } };
如需使用OpenAI:'generativelanguage.googleapis.com' 替换为 'api.openai.com'

点击右上角 Deploy 保存代码

3

挂载专用子域名

在Worker详情页,点击 Settings → Domains & Routes:

  • 点击 "Add Custom Domain"
  • 输入二级域名(强烈建议加 api. 前缀,如:api.your-domain.top)
  • 等待1-2分钟,系统自动签发SSL证书

🧪 测试验收

在浏览器输入以下地址:

https://api.your-domain.top/v1beta/models

如果出现 403 或 PERMISSION_DENIED 的报错代码,恭喜你,管道已成功穿透防火墙!🎉

🏗️

阶段三:搭建"前端展厅"

Vercel部署与环境变量配置

核心目标

将GitHub上的代码通过Vercel自动部署,并配置环境变量连接你创建的API代理。

1

导入代码

登录 vercel.com,点击 "Add New..." → "Project":

  • 绑定你的GitHub账号
  • 选择或导入你Fork的开源项目代码
  • 或导入从Google AI Studio同步的代码仓库
2

配置环境变量(核心步骤)

在部署前(或在项目的Settings中),填写两个核心参数:

🔑

API Key

变量名通常为 GEMINI_API_KEY

从Google AI Studio申请的密钥

🔗

接口地址

变量名通常为 GOOGLE_URLBASE_URL

填入阶段二创建的代理地址

示例配置

变量名
GEMINI_API_KEY your_gemini_api_key_here
GOOGLE_URL https://api.your-domain.top
3

部署上线

点击 Deploy,等待几十秒

🎆 如果看到烟花特效和绿色的 Ready,说明网站已成功上线!
🏷️

阶段四:挂上"专属门牌"

配置Vercel自定义域名

核心目标

Vercel免费分配的.vercel.app域名在国内经常被墙或访问极慢,必须换成自己的域名。

1

在Vercel宣告域名

进入Vercel项目的 Settings → Domains:

  • 填入产品专属域名(如:app.your-domain.top)
  • 点击 Add 添加
  • 下方会报红错,提示需要添加CNAME记录
  • 记住目标地址:cname.vercel-dns.com
2

在Cloudflare登记放行

打开Cloudflare,进入主域名控制面板,点击 DNS → Records:

  • 点击 "Add record"
  • Type: CNAME
  • Name: 填入前缀(如:app)
  • Target: cname.vercel-dns.com
⚠️ 极易踩坑点: Proxy status 必须点击橙色云朵图标使其变成灰色 (DNS only)。因为Vercel自带全球加速,开启Cloudflare代理会导致冲突减速!
3

终极点亮

保存后回到Vercel页面,盯着刚才的红框

不出意外1分钟内就会变成绿色的 Valid Configuration

🎉 至此,全栈部署完成!

你可以关掉所有VPN,直接在国内网络下丝滑访问你的专属AI域名:
https://app.your-domain.top

💎

附加价值

这套工作流的其他应用场景
🏢

企业AI项目

可复用于任何商业化AI产品部署

🚀

快速验证

快速部署MVP,验证市场需求

🌟

技术积累

掌握一站式部署能力

这套SOP的核心价值

这套极具含金量的工作流不仅能跑通长租公寓资产管理类的AI工具,未来你要做任何商业化项目都可以直接复用,形成标准化的部署流程。