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

🛠️ 核心工具角色说明

🌐

Cloudflare

全球CDN与网络代理服务商

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

▲

Vercel

前端部署与边缘计算平台

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

🐙

GitHub

代码托管与协作平台

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

🤖

Google AI Studio

AI模型开发与测试平台

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

📋 四阶段部署流程

🗺️

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

域名购买与DNS配置

核心目标

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

购买域名

在阿里云、腾讯云或GoDaddy等平台购买域名（如：your-domain.top）

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

注册并添加域名到Cloudflare

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

获取交接暗号（Nameservers）

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

例如：jocelyn.ns.cloudflare.com
kirk.ns.cloudflare.com

修改DNS服务器

回到域名购买平台（如阿里云控制台）：

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

等待生效并完成交接

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

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

🚇

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

搭建免翻墙API代理

核心目标

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

创建Worker应用

在Cloudflare控制台：

左侧菜单点击 "Workers & Pages"
点击 "Create application" → "Create Worker"
起个名字（如：gemini-proxy）
点击 Deploy 部署

植入代理代码

点击 "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 保存代码

挂载专用子域名

在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代理。

导入代码

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

配置环境变量（核心步骤）

在部署前（或在项目的Settings中），填写两个核心参数：

🔑

API Key

变量名通常为 GEMINI_API_KEY

从Google AI Studio申请的密钥

🔗

接口地址

变量名通常为 GOOGLE_URL 或 BASE_URL

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

示例配置

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

部署上线

点击 Deploy，等待几十秒

🎆 如果看到烟花特效和绿色的 Ready，说明网站已成功上线！

🏷️

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

配置Vercel自定义域名

核心目标

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

在Vercel宣告域名

进入Vercel项目的 Settings → Domains：

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

在Cloudflare登记放行

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

点击 "Add record"
Type: CNAME
Name: 填入前缀（如：app）
Target: cname.vercel-dns.com

⚠️ 极易踩坑点： Proxy status 必须点击橙色云朵图标使其变成灰色 (DNS only)。因为Vercel自带全球加速，开启Cloudflare代理会导致冲突减速！

终极点亮

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

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

🎉 至此，全栈部署完成！

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

💎

附加价值

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

🏢

企业AI项目

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

🚀

快速验证

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

🌟

技术积累

掌握一站式部署能力

这套SOP的核心价值

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

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

🎯 核心架构概览

地皮 (域名)

地下管道 (Cloudflare代理)

施工队 (GitHub)

展厅 (Vercel)

🛠️ 核心工具角色说明

Cloudflare

Vercel

GitHub

Google AI Studio

📋 四阶段部署流程

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

核心目标

购买域名

注册并添加域名到Cloudflare

获取交接暗号（Nameservers）

修改DNS服务器

等待生效并完成交接

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

核心目标

创建Worker应用

植入代理代码

挂载专用子域名

🧪 测试验收

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

核心目标

导入代码

配置环境变量（核心步骤）

API Key

接口地址

示例配置

部署上线

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

核心目标

在Vercel宣告域名

在Cloudflare登记放行

终极点亮

🎉 至此，全栈部署完成！

附加价值

企业AI项目

快速验证

技术积累

这套SOP的核心价值