主题
工具链安装
工具链与中间件是两套独立配置与脚本:工具链装的是构建工具(gcc/JDK/Maven/Node/Go/Rust/certbot), 入口在网页「环境自检」页的工具链面板与 /api/v1/system/toolchains/*;CLI 无专用子命令。
组件与关键参数
| key | 组件 | 关键参数(默认值) |
|---|---|---|
cc | C 工具链(gcc/g++/make) | CC_EXTRA_PACKAGES(空) |
java | OpenJDK | JAVA_VERSION(17,apt);JDK_URL(压缩包地址,优先于 apt);JAVA_DIR(/usr/local/jdk) |
maven | Maven | MAVEN_URL(压缩包优先);MAVEN_DIR(/usr/local/maven) |
nvm | Node 版本管理 | NVM_VERSION(v0.40.1);NVM_GIT_URL;NVM_DIR |
node | Node.js(经 nvm) | NODE_VERSION(--lts);NVM_NODEJS_ORG_MIRROR(下载镜像) |
pnpm | pnpm | PNPM_VERSION(latest) |
go | Go | GO_VERSION(1.24.2);GO_URL;GO_DIR(/usr/local/go) |
rust | Rust(rustup) | RUST_TOOLCHAIN(stable);RUSTUP_HOME/CARGO_HOME(/usr/local/…);RUSTUP_DIST_SERVER(镜像) |
certbot | HTTPS 证书工具 | CERTBOT_NGINX_PLUGIN(1);CERTBOT_EXTRA_PACKAGES |
参数以面板/GET /system/toolchains 返回为准;压缩包 URL 方式适合内网/镜像源场景(apt 不可达或需要指定小版本)。
安装流程
- 「环境自检」页查看工具探测结果(缺哪些)。
- 工具链面板选组件、填参数(镜像/目录/版本)。
- 触发安装:以普通 Run 执行,有日志可跟随、可取消。
- 安装后重新自检确认探测通过;在项目脚本里验证版本(
java -version、mvn -v)。
约束同中间件:仅 admin、实装仅 Linux。
登录 Shell 的 PATH 坑
Unix 命令默认走 bash -lc(登录 Shell):读取 /etc/profile 与 /etc/profile.d/*,不读 ~/.bashrc。 工具链安装脚本会把 PATH 写入 profile.d;若手工装工具只改了 ~/.bashrc,项目脚本里仍然「command not found」。
排查:
bash
deploy run <key> -f # 看报错命令
# 脚本里临时诊断:
echo "$PATH"; command -v mvn || true修复:把 export 写进 /etc/profile.d/<tool>.sh,或在命令级 shellOverride 指定自带环境的解释器。
多 JDK 共存
库与应用的 JDK 要求可能不同(如库 JDK 8、应用 JDK 25)。用 JDK_URL+JAVA_DIR 装到独立目录, 在各自项目脚本里显式 export JAVA_HOME=<dir> 与 PATH 前置,不要依赖全局默认 java。 Maven 同理:同一本地仓库(~/.m2)跨项目共享,settings 与镜像配置保持一致。
certbot 注意
安装 certbot 不会自动签发证书:DNS 指向、验证端点可达、域名与站点配置就绪后手动或脚本签发。 HTTPS 反代配置见 systemd 部署与反向代理。
延伸阅读
- 环境自检与中间件面板:网页操作流。
- 中间件、工具链与系统接口:toolchains 契约。
- 故障排查:「找不到构建工具」条目。