Harbor安装指南

小蓝 • 2024-12-27 12:57 • 编程

一、Harbor安装教程

Harbor是一个企业级Docker Registry服务器，用于存储和分发Docker镜像。在安装Harbor之前，需要确保安装有Docker和Docker Compose。

sudo apt-get update
sudo apt-get install docker.io
sudo apt-get install docker-compose

接下来，可以通过以下步骤来安装Harbor。

1. 下载Harbor的在线安装包。

wget https://github.com/goharbor/harbor/releases/download/v1.10.5/harbor-online-installer-v1.10.5.tgz

2. 解压缩文件并进入目录。

tar zxvf harbor-online-installer-v1.10.5.tgz
cd harbor

3. 编辑harbor.yml文件并设置必要的参数。

vim harbor.yml

4. 执行安装命令。

sudo ./install.sh --with-notary --with-clair

5. 执行完成后，Harbor已经安装并启动了。

二、Harbor安装时指定密码

在安装Harbor时，可以使用–with-password选项来设置密码。如下所示：

sudo ./install.sh --with-password

然后，系统会提示您设置密码。如果未指定该选项，则系统将默认设置随机密码。

三、Harbor安装使用

完成Harbor的安装后，可以使用以下命令启动和停止服务。

启动服务：

sudo docker-compose up -d

停止服务：

sudo docker-compose down

四、Harbor安装端口被占用

在安装Harbor时，可能会出现端口被占用的情况。在这种情况下，可以编辑harbor.yml文件并设置新端口。

ports:
  - 80:80
  - 443:443
改为：
ports:
  - 8080:80
  - 8443:443

五、Harbor安装包

可以从Harbor的官方网站上下载安装包，并从其中选择适合您的版本，也可以使用在线安装程序进行安装。

下载地址：https://github.com/goharbor/harbor/releases

六、Harbor安装显示harbor.yml找不到

如果在安装Harbor时出现harbor.yml文件未找到的情况，则可能是当前用户没有足够的权限。在这种情况下，可以使用以下命令将文件复制到HOME目录下：

cp harbor.yml ~/

七、Harbor安装与配置

在配置Harbor之前，需要修改Harbor配置文件。首先，在harbor.yml文件中，设置hostname，端口和密码。还可以为Harbor配置网络代理或使用第三方域名。

# 打开https时需要的证书.crt文件路径
https_cert: /your/cert/path

# 打开https时需要的私钥.key文件路径
https_key: /your/private/key/path

# 配置主机名
hostname: reg.mydomain.com

# 配置端口
http_port: 80
https_port: 443

# 对外公开的端口，设置为0.0.0.0时对所有IP开放
harbor_admin_password: Harbor12345

完成Harbor的配置后，请执行以下命令来重启服务：

sudo docker-compose down -v
sudo docker-compose up -d

八、Harbor安装失败

如果Harbor安装失败，可以通过以下步骤来查找和解决问题。

1. 检查日志文件harbor-setup.log：

cat harbor-setup.log

2. 查找错误信息并解决问题。

3. 删除Harbor并重新安装。

sudo docker-compose down -v
sudo rm -rf /data
sudo rm -rf harbor.tar.gz
sudo rm -rf /etc/docker/certs.d/registry.mydomain.com

# 重新安装
sudo ./install.sh

九、Harbor安装 error 1514

在进行Harbor的安装和配置时，可能会遇到错误1514。这个问题通常是由于Docker存储驱动程序的问题引起的。

为了解决这个问题，请编辑docker配置文件并重启Docker服务。

sudo vim /etc/docker/daemon.json

# 将storage-driver设置为vfs
{
  "storage-driver": "vfs"
}

# 重启Docker服务
sudo systemctl restart docker

十、Harbor安装直接使用第三方证书

使用第三方证书可以增强Harbor的安全性。您可以通过以下命令将证书安装到Harbor系统中：

1. 将证书复制到/etc/docker/certs.d/registry.mydomain.com目录中：

sudo mkdir -p /etc/docker/certs.d/registry.mydomain.com
sudo cp ca.crt /etc/docker/certs.d/registry.mydomain.com/

2. 重新加载Docker证书：

sudo systemctl daemon-reload
sudo systemctl restart docker

3. 在harbor.yml文件中配置证书路径：

https_cert: /etc/docker/certs.d/registry.mydomain.com/ca.crt
https_key: /etc/docker/certs.d/registry.mydomain.com/ca.key

4. 重启Harbor服务

sudo docker-compose down -v
sudo docker-compose up -d

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/295695.html