混合云部署需先完成企业实名认证、api权限开通及网络策略放行；下载校验安装包；配置.net或linux运行环境；写入ak/sk凭证并设置模型路由；最后启动服务并验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
确认混合云部署前提条件
要在本地服务器与百度智能云文心千帆平台间建立安全、可控的混合云调用链路，必须先完成企业级账号实名认证、API权限开通及网络策略放行。缺少任一环节都将导致后续安装失败或服务不可用。
登录百度智能云控制台→进入「组织管理」→完成企业实名认证（需营业执照扫描件+法人身份证）→在「访问控制RAM」中为部署账号授予QwenComateFullAccess和WenxinWorkshopInvokeFullAccess两个系统策略。
【必须关闭本地防火墙的出站规则限制，否则SDK无法连接文心千帆API网关】
下载并校验文心快码混合云安装包
访问百度智能云「文心快码（Comate）」产品页 → 点击「混合云部署」标签 → 下载 comate-hybrid-v3.2.1-win-amd64.zip（Windows）或 comate-hybrid-v3.2.1-linux-x86_64.tar.gz（Linux）。
下载完成后立即校验完整性：Windows用户打开PowerShell，执行 Get-FileHash -Algorithm SHA256 comate-hybrid-v3.2.1-win-amd64.zip；Linux用户执行 sha256sum comate-hybrid-v3.2.1-linux-x86_64.tar.gz。比对结果须与官网公布的SHA256值完全一致，否则丢弃重下。
配置本地运行环境
方法一：Windows系统（推荐）
安装 .NET Runtime 8.0（非SDK）→ 安装 Visual C++ 2019 可再发行组件包（x64）→ 解压安装包至非系统盘路径（如 D:\comate-hybrid）→ 进入 config\ 目录，用记事本打开 appsettings.json，修改 "CloudEndpoint" 为 "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/comate/hybrid"。
方法二：Linux系统（CentOS 7+/Ubuntu 22.04+）
执行 sudo apt update && sudo apt install -y libunwind8 libicu72（Ubuntu）或 sudo yum install -y libunwind libicu（CentOS）→ 创建专用用户 sudo useradd -m -s /bin/bash comate→ 切换用户后解压至 /opt/comate-hybrid→ 修改 config/appsettings.json 中 "LocalMode" 值为 true。
初始化混合云密钥与模型路由
第一步：获取AK/SK凭证
回到百度智能云控制台 → 进入「AccessKey管理」→ 创建新AK/SK → 将生成的 AccessKeyId 和 SecretKey 复制保存到安全位置（该操作不可逆，丢失需重新创建）。
第二步：写入密钥配置
在安装包根目录下新建文本文件 credentials（无扩展名），写入以下内容：
[default]ak = 【你的AccessKeyId】sk = 【你的SecretKey】region = bj
第三步：绑定模型路由策略
编辑 config/model-routing.json，将默认 "fallback_model" 改为 "ernie-4.5t-pro"，并在 "rules" 数组中添加一条策略：{"pattern": ".*java.*", "model": "ernie-x1t-java"}，用于自动识别Java代码请求并路由至专用小模型。
启动服务并验证连通性
Windows：以管理员身份运行 start-service.bat；Linux：执行 sudo ./start-service.sh。
服务启动后等待约12秒，检查日志目录 logs\startup.log（Windows）或 logs/startup.log（Linux）中是否出现 Hybrid gateway initialized successfully 和 Connected to Wenxin Qianfan API: OK 两行关键信息。
最后，在本地终端执行 curl -X POST "http://localhost:8080/v1/chat/completions" -H "Content-Type: application/json" -d '{"messages":[{"role":"user","content":"测试"}]}'，返回含 "choices" 字段的JSON即表示混合云部署已就绪。
