Skip to content

工具链安装 ​

工具链与中间件是两套独立配置与脚本:工具链装的是构建工具(gcc/JDK/Maven/Node/Go/Rust/certbot), 入口在网页「环境自检」页的工具链面板与 /api/v1/system/toolchains/*;CLI 无专用子命令。

组件与关键参数 ​

key组件关键参数(默认值)
ccC 工具链(gcc/g++/make)CC_EXTRA_PACKAGES(空)
javaOpenJDKJAVA_VERSION(17,apt);JDK_URL(压缩包地址,优先于 apt);JAVA_DIR(/usr/local/jdk)
mavenMavenMAVEN_URL(压缩包优先);MAVEN_DIR(/usr/local/maven)
nvmNode 版本管理NVM_VERSION(v0.40.1);NVM_GIT_URL;NVM_DIR
nodeNode.js(经 nvm)NODE_VERSION(--lts);NVM_NODEJS_ORG_MIRROR(下载镜像)
pnpmpnpmPNPM_VERSION(latest)
goGoGO_VERSION(1.24.2);GO_URL;GO_DIR(/usr/local/go)
rustRust(rustup)RUST_TOOLCHAIN(stable);RUSTUP_HOME/CARGO_HOME(/usr/local/…);RUSTUP_DIST_SERVER(镜像)
certbotHTTPS 证书工具CERTBOT_NGINX_PLUGIN(1);CERTBOT_EXTRA_PACKAGES

参数以面板/GET /system/toolchains 返回为准;压缩包 URL 方式适合内网/镜像源场景(apt 不可达或需要指定小版本)。

安装流程 ​

  1. 「环境自检」页查看工具探测结果(缺哪些)。
  2. 工具链面板选组件、填参数(镜像/目录/版本)。
  3. 触发安装:以普通 Run 执行,有日志可跟随、可取消。
  4. 安装后重新自检确认探测通过;在项目脚本里验证版本(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 部署与反向代理。

延伸阅读 ​