Artifactory CE配置端口未生效 端口与配置文件不一致如何解决

问题原因 #

7.x及以上版本Artifactory CE采用微服务拆分架构，仅修改artifactory.port参数只会调整核心后端服务的监听端口，不会同步修改前端路由服务监听端口、全局对外访问地址配置，直接触发三类异常：

• 8083端口仅绑定了核心后端接口服务，没有前端静态资源路由规则，访问/ui路径直接返回404
• 前端服务仍在默认8082端口监听，所以访问8082端口可以正常打开UI
• 全局基础URL未配置时，系统会读取内部服务端口拼接对外地址，导致Set Me Up页面错误显示8040这类仅内部使用的服务端口；而核心后端已经切换到8083端口监听，所以直接走8083端口可以完成包上传操作

正确配置步骤 #

1. 先停止正在运行的Artifactory CE服务，避免配置文件被运行时进程覆盖。
2. 编辑jfrog/artifactory/var/etc/system.yaml配置文件，替换原有端口配置为以下内容，注意YAML文件必须使用2空格缩进，禁止使用Tab键：

shared:
  node:
    # 全局对外访问基础地址，是Set Me Up等页面拼接仓库地址的核心依据
    baseUrl: "http://服务器实际绑定的公网/内网IP:8083"
router:
    # 统一入口路由服务监听端口，所有UI、API请求都通过这个端口对外提供服务
    port: 8083
artifactory:
    # 核心后端服务内部监听端口，仅做内部转发使用，不需要对外暴露
    port: 8082
frontend:
    # 前端静态资源服务内部监听端口，仅做内部转发使用，不需要对外暴露
    port: 8080

如果你是通过Docker容器部署，启动容器时仅需将宿主机8083端口映射到容器内的8083端口即可，不需要映射8082、8080、8040这类内部服务端口，避免端口冲突和配置混乱。

3. 配置保存后，删除jfrog/artifactory/var/etc/目录下自动生成的router.yaml、frontend.yaml旧配置文件，这类文件会在服务重启时根据system.yaml的配置重新生成，避免旧端口配置残留覆盖新设置。
4. 启动Artifactory CE服务，等待2-3分钟待所有微服务组件启动完成。

验证标准 #

• 访问http://服务器IP:8083/ui可正常打开登录页面，无404错误，不需要再加8082端口访问
• 登录后进入conan仓库的Set Me Up页面，显示的远程地址端口为配置的8083，不再出现8040这类无效端口
• 执行conan远程仓库添加、包上传操作，通过8083端口可正常完成所有请求

内容的提问来源于stack exchange，提问作者chenx319