1. 环境准备

• 操作系统：Linux（Ubuntu/CentOS 等）或 macOS（需 Docker Desktop）
• 依赖工具：
• Docker 20.10+
• Docker Compose 2.0+
• openssl（用于生成证书）

1.1 安装 Docker 和 Docker Compose

# 安装 Docker
curl -fsSL https://get.docker.com | bash -s docker
systemctl start docker && systemctl enable docker

# 安装 Docker Compose
DOCKER_COMPOSE_VERSION="v2.23.3"  # 检查最新版本：https://github.com/docker/compose/releases
curl -SL "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

2. 下载 Harbor 安装包

访问 Harbor Releases 下载离线安装包（推荐 harbor-offline-installer-.tgz ）

# 示例：下载 Harbor 2.10.0
wget https://github.com/goharbor/harbor/releases/download/v2.10.0/harbor-offline-installer-v2.10.0.tgz

# 解压
tar -zxvf harbor-offline-installer-v2.10.0.tgz -C /usr/local
cd /usr/local/harbor

3. 配置 Harbor

3.1 生成 SSL 证书（可选但推荐）

mkdir -p /data/certs
cd /data/certs

# 生成自签名证书（生产环境建议使用 Let's Encrypt 或购买证书）
openssl req -newkey rsa:4096 -nodes -sha256 -keyout ca.key -x509 -days 3650 -out ca.crt -subj "/CN=harbor.yourdomain.com"

3.2 修改 harbor.yml 配置文件

cp harbor.yml.tmpl harbor.yml
vim harbor.yml

修改以下关键配置项：

# 主机名或 IP（需与证书域名匹配）
hostname: harbor.yourdomain.com

# HTTPS 配置（若使用 HTTP 可跳过）
https:
  port: 443
  certificate: /data/certs/ca.crt
  private_key: /data/certs/ca.key

# 数据存储路径
data_volume: /data/harbor

# 管理员密码（默认用户 admin）
harbor_admin_password: Harbor12345

# 数据库配置（保持默认即可）
database:
  password: root123

4. 安装 Harbor

# 运行安装脚本
sudo ./install.sh

安装完成后，输出如下：

 ----Harbor has been installed and started successfully.----

5. 访问 Harbor

• Web 界面：浏览器访问 https://harbor.yourdomain.com（或 HTTP 对应地址）
• 登录账号：admin，密码为 harbor.yml中配置的 harbor_admin_password

6. 测试镜像推送

6.1 配置 Docker 信任自签名证书（仅 HTTPS 需要）

# 创建证书目录
sudo mkdir -p /etc/docker/certs.d/harbor.yourdomain.com

# 复制证书
sudo cp /data/certs/ca.crt /etc/docker/certs.d/harbor.yourdomain.com/

# 重启 Docker
sudo systemctl restart docker

6.2 登录 Harbor 并推送镜像

# 登录 Harbor
docker login harbor.yourdomain.com -u admin -p Harbor12345

# 拉取测试镜像
docker pull nginx:latest

# 打标签并推送
docker tag nginx:latest harbor.yourdomain.com/library/nginx:latest
docker push harbor.yourdomain.com/library/nginx:latest

7. 管理 Harbor 服务

# 停止 Harbor
cd /usr/local/harbor
docker-compose down

# 启动 Harbor
docker-compose up -d

# 彻底卸载（谨慎操作！）
docker-compose down -v
rm -rf /data/harbor /data/certs

8. 常见问题

Q1: 端口冲突

• 修改 harbor.yml 中的端口号（如 http.port: 8080），重新运行 ./install.sh

Q2: 证书错误

• 确保证书路径在 harbor.yml 中正确，且 Docker 已信任证书。

Q3: 忘记管理员密码

• 修改 harbor.yml中的 harbor_admin_password，重新运行 ./install.sh

9. 升级与备份

• 升级：下载新版本安装包，替换 harbor.yml后运行 ./install.sh --with-trivy --with-chartmuseum（按需添加组件）
• 备份：定期备份 /data/harbor 目录和数据库（PostgreSQL 数据在 /var/lib/postgresql/data ）

Tags：docker-compose 安装