部署文心快码企业标准版,实际上并没有想象中那么繁琐,但有几个关键环节容易出错——系统环境配置、License绑定、安装路径格式等。若稍有疏忽,后续可能会出现反复报错的情况。下面将整个流程逐一拆解,确保每一步都清晰易懂,避免绕弯路。

你需要在Windows Server或CentOS服务器上完成本地化安装并激活许可证,之后开发团队便可以稳定调用代码补全、智能诊断以及私有知识库增强功能。整个部署过程涵盖五个阶段:环境准备、安装包获取、静默部署、许可证导入以及服务验证。
确认系统环境与权限准备
文心快码企业标准版仅支持Windows Server 2019/2022或CentOS 7.6及以上版本(内核≥3.10),macOS和Ubuntu桌面版暂不支持。请使用管理员身份登录服务器,并务必关闭SELinux(CentOS)或Windows Defender实时防护(Windows),否则安装包校验环节会直接卡死。
打开终端或PowerShell,执行 【hostnamectl --static】(Linux)或 【hostname】(Windows),确认主机名不包含中文、空格或特殊字符。该主机名是后续License绑定的唯一标识,一旦写入便无法更改,因此提前检查能省去后续诸多麻烦。
磁盘空间方面,需预留至少12GB可用空间。安装目录 /opt/wenxin-code(Linux)或 C:\Program Files\WenxinCode(Windows)必须为NTFS或ext4格式——FAT32会导致服务启动失败,这一点容易被忽视,尤其是在部分默认分区格式的云服务器上。
下载企业专用安装包
登录百度文心企业服务平台(https://entwenxin.baidu.com),使用企业管理员账号进入「产品交付」,找到「文心快码企业标准版」→ 点击「下载中心」。
方法一:直接下载 点击对应操作系统的「离线安装包(含内置JDK17)」,文件名如 wenxin-code-enterprise-v2.8.3-win-x64-offline.zip 或 wenxin-code-enterprise-v2.8.3-centos-x86_64-offline.tar.gz。下载后请校验SHA256值,与页面公示的逐一对照,确保文件未被篡改。
方法二:通过交付密钥下载
若企业签署了保密协议,页面会显示「交付密钥」字段。复制密钥后,在命令行执行:
curl -H "X-Delivery-Key: 【你的交付密钥】" https://dl.entwenxin.baidu.com/installer/latest > installer.sh(Linux)
或
Invoke-WebRequest -Headers @{"X-Delivery-Key"="【你的交付密钥】"} -Uri https://dl.entwenxin.baidu.com/installer/latest -OutFile installer.ps1(Windows)
注意:交付密钥仅限单次使用,有效期72小时,且绑定首次请求的IP地址。一旦超时或更换IP,密钥即失效,需重新生成。
执行静默安装与服务注册
第一步:解压并进入安装目录 Windows:右键解压zip包 → 进入 wenxin-code-enterprise-v2.8.3-win-x64-offline 文件夹 → 双击 install.bat; Linux:tar -xzf wenxin-code-enterprise-v2.8.3-centos-x86_64-offline.tar.gz → cd wenxin-code-enterprise-v2.8.3-centos-x86_64-offline → sudo ./install.sh
第二步:接受许可并指定安装路径 安装脚本会提示“Accept EULA? (y/N)”——此处必须输入 【y】,否则直接退出。然后输入绝对路径,例如 /opt/wenxin-code 或 C:\WenxinCode,注意路径末尾不要加斜杠,否则配置文件解析时会报错。
第三步:等待自动注册系统服务 Windows下会自动注册为 WenxinCode-Enterprise 服务,启动类型设为「自动(延迟启动)」;CentOS下生成 /etc/systemd/system/wenxin-code.service 并执行 systemctl daemon-reload → systemctl enable wenxin-code。此过程大约耗时90秒,期间不要关闭终端——耐心等待完成,若中断可能导致服务注册不完整。
导入 License 文件完成激活
登录企业管理员账号,在「产品交付」页面找到当前订单 → 点击「生成License」→ 选择已安装的服务器主机名 → 下载生成的 license.lic 文件。
将该文件复制到安装目录下的 conf/ 子目录(Windows:C:\WenxinCode\conf;Linux:/opt/wenxin-code/conf/),直接覆盖同名文件即可。
重启服务:Windows执行 net stop WenxinCode-Enterprise && net start WenxinCode-Enterprise;Linux执行 sudo systemctl restart wenxin-code。5秒后访问 http://localhost:8080/health,若返回JSON中 "status":"active",则表示激活成功,所有功能即可正常使用。
