清晰易懂的Jfrog Artifactory 安装与核心使用教程

Tee xm

于 2025-04-08 08:20:08 发布

阅读量1.1k

点赞数 42

文章标签：学习 linux windows

本文链接：https://blog.csdn.net/weixin_43236925/article/details/147057127

版权

JFrog Artifactory 是企业级二进制仓库管理工具，支持 Maven、Docker、npm 等 30+ 包格式。本教程将手把手教你完成 安装、配置、核心操作，并指出企业级部署的避坑要点，助你快速搭建私有仓库！

一、安装 JFrog Artifactory（全平台指南）

1. Linux 系统安装（Ubuntu/CentOS）

# 添加 JFrog 仓库（以 Ubuntu 为例）
echo "deb https://releases.jfrog.io/artifactory/artifactory-debs bionic main" | sudo tee -a /etc/apt/sources.list.d/jfrog.list
curl -fsSL https://releases.jfrog.io/artifactory/api/gpg/key/public | sudo apt-key add -

# 安装 Artifactory
sudo apt update
sudo apt install jfrog-artifactory-oss  # OSS 社区版

# 启动服务
sudo systemctl start artifactory
sudo systemctl enable artifactory

2. Docker 快速部署（推荐）

# 创建数据目录并启动容器
mkdir -p ~/jfrog/artifactory
docker run -d \
  --name artifactory \
  -p 8081:8081 -p 8082:8082 \
  -v ~/jfrog/artifactory:/var/opt/jfrog/artifactory \
  docker.bintray.io/jfrog/artifactory-oss:latest

# 验证运行状态
docker logs artifactory | grep "Artifactory started"

3. Windows 系统安装

下载安装包：
https://jfrog.com/download-artifactory-oss/
解压 ZIP 文件 → 运行 bin\artifactory.bat
访问 http://localhost:8081

二、初始化配置（关键步骤！）

1. 访问控制台

浏览器打开 http://服务器IP:8081
首次登录使用默认账号：admin/password

2. 配置存储后端（生产必做）

Admin → Repositories → Local

修改默认仓库存储路径（避免使用系统盘）：

# 编辑 $JFROG_HOME/artifactory/var/etc/artifactory/storage.properties
binary.provider.type=filesystem
file.system.dir=/data/artifactory/storage

3. 创建仓库（以 Docker 为例）

Admin → Repositories → Local → New
选择仓库类型：Docker
配置参数：
- Repository Key：docker-local
- Docker API Version：V2

三、必学核心操作

1. 上传/下载 Docker 镜像

# 登录仓库
docker login 服务器IP:8082 -u admin -p password

# 打标签并推送
docker pull nginx:latest
docker tag nginx:latest 服务器IP:8082/docker-local/nginx:latest
docker push 服务器IP:8082/docker-local/nginx:latest

# 拉取镜像
docker pull 服务器IP:8082/docker-local/nginx:latest

2. 配置 Maven 镜像源

Admin → Repositories → Remote → New
- 仓库类型：Maven
- URL：https://repo.maven.apache.org/maven2

修改 Maven settings.xml：

<mirror>
  <id>jfrog-mirror</id>
  <name>JFrog Mirror</name>
  <url>http://服务器IP:8081/artifactory/maven-remote</url>
  <mirrorOf>*</mirrorOf>
</mirror>

3. API 自动化操作

# 查询仓库中的 Docker 镜像
curl -u admin:password http://服务器IP:8081/artifactory/api/docker/docker-local/v2/_catalog

# 删除旧版本（保留最近 5 个）
curl -u admin:password -X POST http://服务器IP:8081/artifactory/api/retention/docker-local?retain=5

四、新手必看：避坑指南

1. 未配置反向代理

风险：直接暴露 8081/8082 端口存在安全隐患

解决：使用 Nginx 配置 HTTPS 并隐藏端口：

server {
  listen 443 ssl;
  server_name artifactory.yourdomain.com;
  ssl_certificate /path/to/cert.pem;
  ssl_certificate_key /path/to/key.pem;
  location / {
    proxy_pass http://localhost:8081;
  }
}

2. 权限管理混乱

风险：默认所有用户可读写仓库
解决：
1. Admin → Security → Users 创建新用户（如 dev-user）
2. Admin → Security → Permissions 创建权限模板：
  - 仓库范围：docker-local
  - 操作权限：Read（下载）、Write（上传）

3. 存储空间耗尽

现象：上传失败，日志提示 “No space left”
解决：
1. 定期清理旧版本：
  Admin → Advanced → Storage Summary → Cleanup
2. 配置自动清理策略：
  Admin → Repositories → Local → Edit → Cleanup Policy

4. 忘记备份

风险：服务器故障导致元数据丢失
解决：
1. 使用 Export System 功能：
  Admin → Import & Export → Export System
2. 定时备份 $JFROG_HOME/artifactory 目录到云存储

五、企业级最佳实践

1. 高可用架构

部署多节点 Artifactory 集群
共享存储使用 NFS 或云存储（如 AWS S3）

2. 与 CI/CD 集成

Jenkins Pipeline 示例：

pipeline {
    agent any
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
                sh 'curl -u admin:password -T target/*.jar "http://服务器IP:8081/artifactory/libs-release-local/"'
            }
        }
    }
}

3. 监控与日志

集成 Prometheus + Grafana 监控 JVM 和存储指标

日志聚合：

# 查看实时日志
tail -f $JFROG_HOME/artifactory/var/log/artifactory.log

六、总结

通过本教程，你已经掌握：
✅ 多平台安装 JFrog Artifactory
✅ 核心仓库管理操作（Docker/Maven 集成）
✅ 企业级安全与维护策略
✅ CI/CD 流水线集成方法

下一步学习路线：

探索 Xray 安全扫描检查依赖漏洞
学习 Artifactory REST API 实现全自动化管理
搭建多数据中心同步架构提升容灾能力

立即动手实践，构建你的企业级二进制仓库！ 🚀