在群晖(Synology)Nas 上部署 Harbor

我使用的是群晖 720+双盘位 Nas， 并为其配备了两个 4TB 希捷机械硬盘（HDD）。 另外，我还额外安装了一个 4G 内存条，以满足 Harbor 的最低安装条件。

安装 Harbor 的配置要求

Harbor 官网详细说明了安装 Harbor 的最低配置要求：

资源	最低	推荐
CPU	2 CPU	4CPU
内存	4GB	8GB
硬盘	40GB	160GB

选择安装方式

Harbor 官网就如何安装已经给出详细的步骤。 我会对安装过程做一些重复的演示，并着重说明在群晖（Synology）上遇到的问题。

Harbor 提供了在线安装（Online installer）和离线安装（Offline install）两种方式。 正如其名， 离线安装包 会额外下载已经构建好的镜像。方便起见，我选择在线安装（Online installer）。

安装 Docker

进入群晖（Synology）Nas 的管理界面，打开套件中心安装 Container Manager。

部署 Harbor

# 登录至Nas
ssh your_nas_ip

# 在群晖Nas上新建一个harbor共享文件用于存放Harbor相关的内容
# 'volumn1'这个名字在不同Nas下可能会不同，需要找到你的Nas的文件目录
cd /volumn1/harbor

# 下载安装包
wget https://github.com/goharbor/harbor/releases/download/v2.10.0/harbor-online-installer-v2.10.0.tgz
# 解压安装包
tar xzvf harbor-online-installer-v2.10.0.tgz

# 解压后会在当前文件夹创建一个harbor目录
# 我将其重命名未installer
mv harbor installer

由于群晖的 Nas 系统下并未按照tput命令，会导致安装脚本执行错误，我们需要手动修复一下脚本：

tput 命令主要是用于控制台日志的染色，并不会影响实际运行。我们将其删除即可

# 进入解压后的安装目录
cd /volumn1/harbor/installer


# 使用vim编辑文件手动将tput命令都删除
# 例如：将 `bold=$(tput bold)`命令替换成 `bold=""`
vim common.sh
# 或者使用sed命令快速修改
sed -i -e '/tput/s/\(\w*=\).*/\1""/' common.sh

接下来，需要修改 Harbor 默认的配置文件模板。Harbor 的默认配置会启动 HTTPS，并需要我们配置证书。 但是为了更方便证书管理，采用 Http 启动 Harbor，并且在 Harbor 前的 Nginx 代理上统一管理 Https 证书更加优雅。

Nginx Proxy Manager是一款优秀的的轻量的反向代理服务。 它自带 Web UI 并能够自动的申请和更新 Letsencrypt 证书。 非常适合 Nas。

我通过Nginx Proxy Manager 管理进入 Nas 的流量，并将发送至 Harbor 的 Https 请求转成 Http。

如果你希望 Harbor 直接启动 Https 服务，请查看Harbor 官网 Configure HTTPS Access to Harbor 章节的内容。

复制一份 Harbor 提供的默认配置文件模板：

cp harbor.yml.tmpl harbor.yml

修改harbor.yaml：

# 填写你的域名
hostname: example.com

http:
  # http 端口
  port: 10001

# 需要将HTTPS配置注释
# https:
# https port for harbor, default is 443
# port: 443
# The path of cert and key files for nginx
# certificate: /your/certificate/path
# private_key: /your/private/key/path

# 虽然我们在Nginx上配置了Https证书
# 但是Harbor依旧需要我们添加`external_url`配置真实的url才能正常访问
external_url: https://exmaple.com
# 后面的配置可以不做改动
# ...

我们还需要添加一个文件夹存放 Harbor 镜像启动后的数据（数据库、配置文件等等）。

cd /volumn1/installer
# Harbor的安装脚本默认使用的文件夹名为common
# 像更换这个文件夹位置必须更改Harbor的安装脚本
mkdir common

为什么需要手动创建这个文件夹我也并没有调查清楚。 在 Linux 系统上，common 文件夹在安装 Harbor 时会自动创建。 但是在 Nas 并没有自动创建，我不得不手动补上这个文件夹。

最后，运行 Harbor 提供的安装脚本：

./install.sh

运行完成后，需等待 docker 启动镜像。 启动后，访问上一步hostname或external_url配置的域名，即可进入登录页面。

IP+Port 访问 Harbor 服务会被拒绝。