Docker-Harbor(Docker 镜像服务器)

[Harbor](https://goharbor.io/) 是一个开源可信的云原生注册表项目，用于存储、签名和扫描内容。Harbor 通过添加用户通常需要的功能（例如安全性、身份和管理）来扩展开源 Docker Distribution。拥有更接近构建和运行环境的注册表可以提高图像传输效率。Harbor 支持在注册表之间复制图像，还提供高级安全功能，例如用户管理、访问控制和活动审计。

Harbor 文档：https://goharbor.io/docs/
Harbor_GitHub：https://github.com/goharbor/harbor
Harbor 版本发布：https://github.com/goharbor/harbor/releases/

## 安装
[Harbor私服搭建和使用](https://baijiahao.baidu.com/s?id=1707816679863571585&wfr=spider&for=pc&searchword=docker%20%E7%A7%81%E6%9C%8D)
```bash
# 离线 or 在线，二选一
wget https://ghproxy.com/https://github.com/goharbor/harbor/releases/download/v2.6.1/harbor-offline-installer-v2.6.1.tgz -O harbor-installer.tgz		# 离线包
wget https://ghproxy.com/https://github.com/goharbor/harbor/releases/download/v2.6.1/harbor-online-installer-v2.6.1.tgz -O harbor-installer.tgz		# 在线包

tar -zxvf harbor-installer.tgz && cd harbor		# 解压并进入目录
cp harbor.yml.tmpl harbor.yml		# 复制官方提供的模版
vim harbor.yml		# 编辑配置

# 生成镜像，如果提示缺少文件夹，手动添加下
bash prepare		# 有些默认位置在 harbor.yml 中配置
bash install.sh  # 运行自动安装Docker环境、生成镜像、并完成部署
docker-compose up -d		# 后面可以正常使用 docker-compose 管理
# 迁移,打包整个目录到其它服务器上,执行 bash install.sh 即可
```
> 群晖没有 tput 报错忽略就行

访问：协议://你设定的域名或IP：设定端口
帐号：`admin`
密码：`Harbor12345`
帐号密码均可在 `harbor.yml` 设置中找到

`harbor.yml`
```yml
# 主要是以下参数，其他的配置保持默认即可
hostname: nas.918178.xyz		# 设置为你对应域名或是IP

http:		# http，可选，推荐禁用
  port: 10087		# http 端口

https:		# https，可选
  port: 10088		# https 端口
  certificate: /root/harbor/nas.918178.xyz.crt		# SSL证书(.crt)，修改为实际位置
  private_key: /root/harbor/nas.918178.xyz.key		# SSL密钥(.key)，修改为实际位置
  # 这个只有在部署时会把该SSL导入系统，后期更换SSL证书路径为：./data/secret/cert/
  # 对应内部路径为：/etc/cert，证书需更改为 `server` 为前缀的
  # 也可修改 ./common/config/nginx/nginx.conf 来指定SSL路径(默认会改成server的)
  # 对应内部路径为：/etc/nginx
```

### 子容器介绍
- Harbor-Core:
这是 Harbor 的核心服务容器，负责处理 API 请求，管理用户认证，以及与后端存储交互
- Harbor-JobService:
这个容器负责执行定时任务和后台任务，例如镜像的定时扫描和清理
- Harbor-AdminServer:
管理服务器，用于管理 Harbor 服务的配置和状态
- Harbor-Database:
数据库容器，Harbor 使用 PostgreSQL 或 MySQL 作为其数据库后端
- Harbor-Redis:
Redis 容器，用于缓存和消息队列，提高 Harbor 的性能
- Harbor-Registry:
负责存储和管理 Docker 镜像的注册表服务
- Harbor-Registryctl:
注册表控制器，用于管理注册表服务的各个方面
- Harbor-Portal:
用户界面服务，提供 Web UI 访问 Harbor
- Harbor-Proxy:
代理服务，用于处理 HTTP 请求的路由和转发
- Harbor-Chartmuseum (可选):
如果启用了 Helm chart 仓库支持，这个容器将提供对 Helm chart 的存储和管理
- Harbor-Notary (可选):
如果启用了 Notary 支持，这个容器将提供镜像签名和验证功能
- Harbor-Trivy (可选):
如果启用了安全扫描功能，这个容器将集成 Trivy 来扫描镜像中的安全漏洞
- Harbor-Nginx (可选):
如果使用 Nginx 作为 Harbor 的前端代理，这个容器将处理 SSL 终端和请求路由

## Harbor 使用
```bash
echo "127.0.0.1 nas.918178.xyz" >> /etc/hosts		# 本地上传镜像需要改hosts

docker login <harbor服务器:端口> -u <账号> -p <密码>		# 登录 Harbor
  docker login nas.918178.xyz:10088 -u admin -p Harbor12345
docker tag <原镜像> <harbor服务器:端口/项目/标签>		# 打 harbor访问地址/项目/标签
docker push <harbor服务器:端口/项目/标签>		# 上传镜像到 harbor服务
docker pull <harbor服务器:端口/项目/标签>		# 拉取镜像

export DOCKER_TLS_VERIFY=0  # 禁用所有 TLS 验证(忽略TLS错误)
```
>w 如果想要带每次更新原有的都会按版本号保留
> 可以在打标签时打两个标签,一个带版本号,一个latest
> 然后上传时两个都上传,latest会覆盖旧的,之前的版本号的也还在

### Windows 脚本
需要 `Docker` 环境，可以帮助快速克隆 Docker Hub 上的镜像
[Harbor 镜像克隆v4.bat](/media/file/Harbor镜像克隆v4.bat)
```cmd
@echo off
title Harbor 镜像克隆 v4
@echo off
rem 为注释

@REM ——————————————————————————————————————————
@REM —————————————————配置区域——————————————————
@REM ——————————————————————————————————————————

@REM 服务器地址,如果换了修改这个即可
set Server_URL=nas.918178.xyz:10088
@REM 启用下面这条就是输入服务器地址,直接回车就默认为上面的
@REM set /p Server_URL=Harbor 服务器地址:

@REM 同步到 Harbor 哪个库下,修改 tag 标签,默认library,0为保持原有标签
set Tag=library
set /p Tag=Harbor 存储项目 TAG(默认 保持原有,0 library,1 自定义标签):

@REM 同步版本标记,直接回车就 latest,输入版本号则会版本号推送一个,latest 推送一个,这样就有版本更迭记录了
set latest=latest
set /p latest=Harbor 项目标记 (默认 latest,输入版本号则会推送 latest + 版本号):

@REM 克隆完成后是否清理镜像
set Del=N
@REM 启用下面这条就会进行询问是否清理
@REM set /p Del=克隆完成后是否清理拉取镜像(y/N):

@REM 以下为帐号的两种方案,根据实际需求使用
@REM -----固定密码-----
@REM set Server_USER=<Harbor 帐号>
@REM set Server_PASSWD=<Harbor 密码>
set Server_USER=robot$bot
set Server_PASSWD=CtwyTXPiMUrdRNILfL46xvSViHSJzXKd
docker login %Server_URL% -u %Server_USER% -p %Server_PASSWD%

@REM -----登录时输入密码-----
@REM docker login %Server_URL%

@REM ——————————————————————————————————————————
@REM ——————已下为执行代码,无特殊需求无需更改——————
@REM ——————————————————————————————————————————

:main
echo ——————————————————————————————————————————
@REM 处理镜像
@REM 拉取镜像
set image_name=
set /p image_name=Docker Hub 镜像:
docker pull %image_name%

@REM 根据输入判断是否要指定 Tag 标签
IF "%Tag%"=="0" (
    @REM 追加 library 进行克隆
    set "NEWimage_name=library/%image_name%"
) ELSE IF "%Tag%"=="1" (
    @REM 自定义标签进行克隆
    set NEWimage_name=%image_name%
    set /p NEWimage_name=自定义 TAG:
) ELSE (
    @REM 保持原有标签进行克隆
    set "NEWimage_name=%image_name%"
)

echo docker tag %image_name% %Server_URL%/%NEWimage_name%:%latest%

@REM 根据输入判断是否要推送 latest + 版本号
IF "%latest%"=="latest" (
    @REM 更改镜像 tag(不带标记会默认标记成 latest)
    docker tag %image_name% %Server_URL%/%NEWimage_name%

@REM 上传到 Harbor
    docker push %Server_URL%/%NEWimage_name%

@REM 删除克隆镜像
    docker rmi %Server_URL%/%NEWimage_name%

@REM 提示拉取镜像命令
    echo 拉取镜像命令为:docker pull %Server_URL%/%NEWimage_name%:latest
) ELSE (
    @REM 更改镜像 tag,一个版本号,一个 latest(不带标记会默认标记成 latest)
    docker tag %image_name% %Server_URL%/%NEWimage_name%:%latest%
    docker tag %image_name% %Server_URL%/%NEWimage_name%

@REM 上传到 Harbor
    docker push %Server_URL%/%NEWimage_name%:%latest%
    docker push %Server_URL%/%NEWimage_name%

@REM 删除克隆镜像
    docker rmi %Server_URL%/%NEWimage_name%:%latest%
    docker rmi %Server_URL%/%NEWimage_name%

@REM 提示拉取镜像命令
    echo 拉取镜像命令为:docker pull %Server_URL%/%NEWimage_name%:%latest%
    echo 拉取镜像命令为:docker pull %Server_URL%/%NEWimage_name%:latest
)

@REM 删除本地镜像,/i 表示判断时不区分大小写
IF /i "%Del%"=="Y" (
    docker rmi %image_name%
)

echo ——————————————————————————————————————————
echo 处理完成,可以继续处理其他镜像
pause
@REM 跳转到输入镜像处,继续处理其他镜像
goto main
```

**相关教程：**
[Harbor仓库的部署，操作使用-报错解决方法](https://blog.csdn.net/tianmingqing0806/article/details/126423734)
[harbor搭建-主从复制](https://blog.csdn.net/weixin_42507440/article/details/123923961)
[如何将dockerhub上的镜像迁移到Harbor私有镜像仓库中](https://blog.51cto.com/lidabai/5283232)
其他开源 Docker 镜像服务器：Nexus,portus,docker registry