CodeBuddyLinux部署怎么操作详细指南-人工智能-PHP中文网

codebuddy在linux上分cli本地安装和企业私有化部署两种场景：前者需node.js v18.20+及全局安装cli工具，扫码登录后即可使用；后者要求docker环境、离线包部署、私有模型导入及ldap/saml认证配置，全程离线运行。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

codebuddylinux部署怎么操作详细指南

CodeBuddy 在 Linux 上的部署分两种主流场景：CLI 工具本地安装（面向运维/开发者日常使用） 和 企业级私有化服务部署（面向内网环境、需独立运行）。两者目标不同，操作路径也完全不同，不能混用。

Linux 上安装 CodeBuddy CLI（推荐大多数用户）

这是最常用、最轻量的方式，适合在任意 Linux 服务器或开发机上快速启用自然语言驱动的系统管理与脚本编写能力。

确保系统已安装 Node.js v18.20+
运行 node -v 检查版本。若不满足，建议用 NodeSource 安装 LTS 版本：
```
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
```

全局安装 CLI 工具（四种包管理器任选其一）：

npm install -g @tencent-ai/codebuddy-code
# 或 pnpm add -g @tencent-ai/codebuddy-code
# 或 yarn global add @tencent-ai/codebuddy-code
# 或 bun install -g @tencent-ai/codebuddy-code

首次运行并微信扫码登录（国内版）：
```
codebuddy
```
终端会弹出二维码，用微信扫描完成身份认证。

验证是否就绪：

codebuddy --version  # 查看版本
codebuddy ask "列出当前内存使用率最高的5个进程"  # 测试诊断能力

小技巧：

One API key for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。

下载
- 用 -p 参数直接执行单条指令，适合写进 cron 或 shell 脚本；
- 支持管道输入，例如 journalctl -n 100 | codebuddy -p "分析最近报错原因"；
- 加 -y 可跳过确认，实现全自动脚本调用。

Linux 内网私有化部署（企业级，全离线）

适用于金融、政务、央企等对数据不出网有强要求的场景，需自建服务实例，不依赖任何公网连接。

准备基础环境：
- 服务器：4核 CPU / 16GB 内存 / ≥50GB 系统盘 / ≥200GB 数据盘；
- 软件：Docker 24.0+、Docker Compose V2；
- 网络：禁用 systemd-resolved，配置内网 DNS（如 10.10.10.10）。
获取离线安装包：
从腾讯云内部交付平台下载 codebuddy-onprem-v2.8.3-offline.tar.gz，校验 SHA256 值为：
a7f9e3d2c1b8a4f5e6d7c9b0a1f2e3d4c5b6a7f8e9d0c1b2a3f4e5d6c7b8a9f0

解压并授权：

tar -xzf codebuddy-onprem-v2.8.3-offline.tar.gz -C /opt/codebuddy/onprem/
chmod +x /opt/codebuddy/onprem/bin/*.sh

导入私有模型：
将获授权的模型文件（如 tc-code-enterprise-202604.qwen3-int4.gguf）放入 /opt/codebuddy/models/，
并修改 /opt/codebuddy/config/model_config.json 中的 model_path 字段指向该路径。
配置认证与网络：
- 编辑 /opt/codebuddy/config/auth_config.yaml，关闭微信和 GitHub 登录：
```
enable_wechat_login: false
enable_github_oauth: false
```
- 启用 LDAP 或 SAML 接入企业统一身份源；
- 所有服务强制走 TLS 1.3，前端入口地址设为 https://codebuddy.internal.corp:8443
启动服务：
```
cd /opt/codebuddy/onprem
./bin/start.sh
```
成功后可通过内网浏览器访问控制台，所有 AI 能力均在本地推理完成。