文档首页> 常见问题> 如何在Linux云服务器上安装Harbor？

如何在Linux云服务器上安装Harbor？

发布时间：2025-05-12 04:27       

在Linux云服务器上安装Harbor私有仓库的完整指南

随着容器技术的普及，Docker镜像管理变得至关重要。Harbor作为企业级私有镜像仓库解决方案，因其强大的功能和易用性备受青睐。本文将详细介绍如何在Linux云服务器上安装和配置Harbor私有仓库。

一、准备工作

1. 系统要求

  • Linux服务器（推荐Ubuntu 18.04+或CentOS 7+）
  • 至少4GB内存
  • 100GB可用磁盘空间
  • Docker 17.06.0-ce+
  • Docker Compose 1.18.0+

2. 安装必要软件

# 安装Docker
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

# 安装Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

二、下载和安装Harbor

1. 下载Harbor安装包

wget https://github.com/goharbor/harbor/releases/download/v2.4.0/harbor-offline-installer-v2.4.0.tgz
tar xvf harbor-offline-installer-v2.4.0.tgz
cd harbor

2. 配置Harbor

修改harbor.yml配置文件：

hostname: your.domain.com  # 修改为你的域名或IP
http:
  port: 80
https:
  port: 443
  certificate: /your/certificate/path
  private_key: /your/private/key/path
harbor_admin_password: Harbor12345  # 修改管理员密码

3. 运行安装脚本

sudo ./install.sh

三、Harbor基本配置

1. 访问Harbor Web界面

在浏览器中访问http://your-server-ip

2. 创建新项目

  1. 使用admin账户登录
  2. 点击"新建项目"
  3. 输入项目名称并设置访问级别

3. 配置Docker客户端

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "insecure-registries" : ["your-server-ip"]
}
EOF
sudo systemctl restart docker

四、高级配置选项

1. 配置HTTPS访问

使用Let's Encrypt证书或上传已有证书

2. 配置LDAP/AD集成

在harbor.yml中配置LDAP设置

3. 配置外部数据库

默认使用PostgreSQL容器，可配置外部数据库

五、日常维护

1. 备份和恢复

# 备份
docker-compose down
tar czvf harbor-data-backup.tar.gz /data

# 恢复
tar xzvf harbor-data-backup.tar.gz -C /
docker-compose up -d

2. 升级Harbor

参考官方升级文档

3. 监控和日志

配置Prometheus和Grafana监控

通过本文的指导，您应该已经成功在Linux云服务器上安装并配置了Harbor私有仓库。Harbor提供了强大的企业级功能，包括RBAC、镜像复制、漏洞扫描等，是构建容器化基础设施的重要组件。

随着业务增长，您可以考虑配置高可用方案，或集成CI/CD流水线，进一步提升容器化工作流的效率。