Jenkins 的 config.xml 文件位于 JENKINS_HOME 目录下，保存全局配置；需先停止服务、备份、校验 XML 后再修改，常见修改项包括禁用 CSRF、调整 Jenkins URL、配置 LDAP 和全局代理。
Jenkins 的
文件默认位于 Jenkins 主目录（
JENKINS_HOME
）下，路径是：
这个文件保存了 Jenkins 全局配置，比如系统设置、安全策略、代理配置、插件更新站点等。修改它需要谨慎，建议先备份再操作。
怎么找到 JENKINS_HOME 目录
常见位置如下（取决于安装方式）：
Linux/
mac
OS：通常是
（deb/rpm 包安装）或
（war 包启动时指定）
Windows：一般是
或
如果你用 Docker 启动，JENKINS_HOME 由
挂载路径决定，比如
，那 config.xml 就在
最稳妥的方式是登录 Jenkins 页面 → 点击右上角用户名 → “系统信息”，查找
hudson.home
这一项的值。
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
修改 config.xml 的正确步骤
不建议直接在 Jenkins 运行时编辑并保存 config.xml，容易导致配置错乱或服务异常。推荐流程：
停止 Jenkins 服务（如
或关闭 war 进程）
备份原文件：
用文本编辑器打开修改（注意 XML 格式规范，避免标签不闭合、特殊字符未转义）
检查语法是否合法（可用在线 XML 验证工具或命令行
）
启动 Jenkins，观察日志（
或系统日志）是否有解析错误
哪些配置常通过 config.xml 修改
有些设置在 Web 界面里不开放或无法生效，必须改 XML：
禁用 CSRF 保护（
，仅限测试环境）
调整 Jenkins URL（
）
启用 LDAP 绑定账号（
块）
设置全局代理（
节点）
自定义插件更新中心地址（修改
下的
和镜像 URL）
基本上就这些。改完别忘了重启 Jenkins，而且每次升级 Jenkins 版本前，最好确认 config.xml 是否被新版兼容 —— 某些旧字段可能已被弃用。
config.xml$JENKINS_HOME/config.xml/var/lib/jenkins~/jenkinsC:\Program Files\Jenkins%USERPROFILE%\.jenkins-v-v /my/jenkins:/var/jenkins_home/my/jenkins/config.xmlsystemctl stop jenkinscp config.xml config.xml.bakxmllint --noout config.xml$JENKINS_HOME/logs/false https://ci.example.com ...