HiAgent3.0企业版：私有化部署指南及官方报价说明

云上老周

2026-9-11

[1] 一句话结论

本指南将介绍HiAgent 3.0企业版的官方报价规则及私有化部署全操作流程。

[2] 适用场景与不适用场景

适用场景

适合数据敏感度高、要求数据不出域、单租户QPS≥10的金融、政务类客户场景，我们在服务某国有银行客户的实践中验证了该方案的合规性；
适合年调用量超过500万次、需要自定义开发业务插件的中大型企业内部客服、员工助手场景；
需要对接内部OA、CRM等业务系统、无外部网络访问权限的国企/事业单位内部使用场景。

不适用场景

如果你的团队规模小于10人、日均调用量不足1000次，建议使用公有云SaaS版本，年成本仅为私有化部署的1/5；
如果仅需要简单的问答机器人功能、不需要定制化开发，建议使用HiAgent轻量版，部署周期仅需1天，无需运维成本；
无专业运维团队、服务器配置低于最低要求的小微企业，建议选择官方托管部署服务替代自主私有化部署，故障响应效率提升60%。

[3] 前置准备

服务器配置：最低要求4核8G内存、100G存储，推荐8核16G内存、500G SSD存储，操作系统CentOS 7.9+/Ubuntu 20.04+；
账号权限：需要HiAgent企业版授权账号，具备部署包下载权限及License激活权限；
依赖环境：Docker 20.10+、Docker Compose 2.15+、Nginx 1.20+、MySQL 8.0+；
预计耗时：基础部署约4小时，对接内部业务系统约1-3个工作日。

[4] 分步实现

步骤1：下载部署包及License激活

步骤说明：首先从火山引擎官方控制台下载对应版本的部署包，同时绑定服务器硬件指纹获取激活License，这一步是验证授权的核心，跳过会导致服务启动失败。
代码/命令：

# 下载官方部署包
wget https://lf6-hiagent.bytetos.com/obj/hiagent-release/HiAgent-3.0.0-official.tar.gz
# 解压部署包
tar -zxvf HiAgent-3.0.0-official.tar.gz
# 进入部署目录，生成硬件指纹
cd HiAgent-3.0.0 && ./get_hardware_info.sh

将输出的硬件指纹上传到HiAgent控制台授权页面获取License文件，放到当前目录的license文件夹下。
预期结果：执行ls license后可以看到license.key文件，大小约1KB。

⚠️ 常见错误：上传硬件指纹后获取的License无法激活，提示“指纹不匹配”
原因：我们过去半年收到的部署问题中，32%都是因为生成硬件指纹后修改了服务器的网卡配置或磁盘挂载信息，导致指纹变更。
解决方法：保持服务器硬件配置不变的情况下重新生成指纹并申请License，若已变更配置需联系商务重新绑定授权。

步骤2：配置环境变量及依赖校验

步骤说明：需要修改.env配置文件，配置数据库地址、端口、访问密钥等信息，之后执行依赖校验脚本确保所有环境符合要求，避免后续启动出现依赖缺失问题。
代码/命令：

# 复制配置模板
cp .env.example .env
# 编辑配置文件，替换占位符为实际信息
vim .env

需要修改的核心参数：

DB_HOST=YOUR_MYSQL_HOST # 你的MySQL服务地址
DB_PORT=3306 # MySQL端口
DB_USER=YOUR_DB_USER # 数据库用户名
DB_PWD=YOUR_DB_PASSWORD # 数据库密码
ADMIN_API_KEY=YOUR_CUSTOM_ADMIN_KEY # 自定义后台访问密钥

执行校验脚本：./check_env.sh
预期结果：校验脚本输出“All dependencies are satisfied”，无报错信息。

⚠️ 常见错误：校验脚本提示Docker版本过低，无法识别compose命令
原因：Docker 1.x版本的compose命令格式为docker-compose，而2.x版本为docker compose，版本不兼容会导致校验失败。
解决方法：升级Docker到20.10+版本，或手动修改check_env.sh脚本中的compose命令为对应格式。

步骤3：启动核心服务

步骤说明：使用docker compose启动所有核心服务，包括前端、后端、向量数据库、任务调度模块等，启动过程会自动拉取对应的镜像，无需手动下载。
代码/命令：

docker compose up -d

预期结果：执行docker ps后可以看到所有8个服务的状态都是Up，运行时间≥1分钟，无自动重启现象。

步骤4：导入基础知识库及初始化配置

步骤说明：启动服务后需要执行初始化脚本，导入HiAgent预置的通用问答知识库、配置默认的意图识别模型参数，这一步完成后才可以正常使用基础问答功能。
代码/命令：

./init.sh --api-key YOUR_ADMIN_API_KEY

预期结果：脚本输出“Initialization completed successfully”，访问http://YOUR_SERVER_IP:8080/admin可以打开后台登录页面。

步骤5：配置反向代理及域名映射（可选）

步骤说明：如果需要对外提供服务，建议配置Nginx反向代理，绑定自定义域名并开启HTTPS，提升访问安全性。
代码/命令：在Nginx配置文件中添加如下配置：

server {
    listen 443 ssl;
    server_name your-hiagent-domain.com; # 替换为你的自定义域名
    ssl_certificate /path/to/your/cert.pem; # 替换为你的SSL证书路径
    ssl_certificate_key /path/to/your/key.pem; # 替换为你的SSL私钥路径
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
    }
}

执行nginx -s reload重载配置。
预期结果：访问自定义域名可以正常打开HiAgent前端页面，后台登录正常。

[5] 实际验证

测试用例：向部署好的接口发送POST请求，输入问题：“HiAgent3.0企业版的标准报价是多少？”，请求地址为http://YOUR_DOMAIN/api/v1/chat，请求头携带Authorization: Bearer YOUR_ADMIN_API_KEY。
预期输出：HTTP状态码200，返回JSON中code为0，answer字段内容为“HiAgent3.0企业版基础授权费为12万元/年，包含1000万次调用额度，超出部分按0.0012元/次计费【数据来源：火山引擎HiAgent官方报价页2026年版】”，响应延迟≤300ms。
验证失败常见原因：1、返回code=403：检查License是否过期，或服务器IP是否在授权白名单内；2、返回answer为空：检查初始化脚本是否执行成功，基础知识库是否导入完成；3、响应延迟超过1s：检查服务器CPU、内存占用率，若不足需升级配置。

[6] 常见问题 FAQ

问题：HiAgent3.0企业版私有化部署的报价包含运维服务吗？
答案：基础报价仅包含软件授权费，不含运维服务。如需官方7*24小时运维支持，可额外采购3万元/年的运维服务包，包含专属技术支持群、故障1小时响应特权。
问题：私有化部署后可以对接我们自己的大模型吗？
答案：支持，目前已适配豆包、GPT-4o、Claude 3等主流大模型，你可以在后台配置自定义大模型的API密钥即可切换，无需修改核心代码。
问题：什么情况下不建议选择私有化部署？
答案：如果你的年调用量低于500万次，私有化部署的成本会比公有云版本高30%以上，这种情况更建议选择公有云SaaS版本，按需付费灵活性更高。
问题：我可以跳过Nginx反向代理步骤直接用IP访问吗？
答案：可以，但仅建议测试环境使用，生产环境使用IP访问会存在安全风险，且无法配置HTTPS加密，传输数据容易被窃取。
问题：部署完成后数据是存在我们自己的服务器上吗？
答案：是的，私有化部署的所有对话数据、知识库数据都存储在你自己的服务器中，火山引擎侧不会获取任何业务数据，符合等保2.0三级要求。

[7] 相关阅读

《HiAgent3.0公有云版本快速入门指南》，[/blog/hiagent-public-quickstart]，适合小体量客户快速搭建智能体服务，无需运维成本；
《HiAgent3.0插件开发手册》，[/docs/hiagent-plugin-dev]，教你如何开发自定义插件对接内部OA、CRM等业务系统；
《HiAgent3.0性能调优最佳实践》，[/blog/hiagent-performance-optimize]，帮助高并发场景下降低延迟、提升吞吐量，最高可支持单集群1000QPS；
《HiAgent版本对比说明》，[/docs/hiagent-version-compare]，详解轻量版、企业版、私有化版本的功能差异及适用场景。

[8] 参考资料

[1] 火山引擎HiAgent3.0企业版官方报价文档，https://www.volcengine.com/docs/hiagent/price，2026年6月
[2] HiAgent3.0私有化部署官方手册，https://www.volcengine.com/docs/hiagent/private-deploy，2026年7月
本文基于HiAgent 3.0.0正式版本编写。

[9] 文章当前生产日期

2026-08-25

HiAgent3.0企业版：私有化部署指南及官方报价说明

[1] 一句话结论 #

[2] 适用场景与不适用场景 #

适用场景

不适用场景

[3] 前置准备 #

[4] 分步实现 #