Harbor 是 VMware 开源的企业级 Docker 镜像仓库，提供镜像复制、漏洞扫描、RBAC 权限管理等核心功能，广泛应用于生产环境的容器镜像存储与分发。本文提供一套完整的 Harbor 离线安装与配置方案。

核心内容包括：

1. 离线包下载：通过 GitHub Release 页面或代理加速地址下载指定版本（2.9.4）的 Harbor 离线安装包

2. 环境准备：安装 Docker Compose 工具（提供国内镜像加速地址），确保 Harbor 依赖环境就绪

3. 配置文件修改：详解 harbor.yml 的核心配置项：

   • hostname：设置为宿主机 hostname 或内外网 IP
   • http.port：自定义 HTTP 访问端口（如 3080）
   • 注释 HTTPS 配置（测试环境可暂不启用）

4. 部署与运维：执行 install.sh 完成安装，并提供 docker-compose ps/up/restart/down 等常用管理命令

5. 访问验证：通过 http://<ip>:<port> 访问 Harbor Web 界面，默认账号密码为 admin / Harbor12345

本文适用于需要在企业内部搭建私有容器镜像仓库的运维开发人员。

安装Harbor

下载Harbor的Docker Compose文件(方式一)

shell
#export HARBOR_VERSION=2.5.6
export HARBOR_VERSION=2.9.4
#export HARBOR_VERSION=2.10.3
wget https://ghfast.top/https://github.com/goharbor/harbor/releases/download/v${HARBOR_VERSION}/harbor-offline-installer-v${HARBOR_VERSION}.tgz

如果没有docker-compose就安装一个

shell
sudo curl -L "https://oss.odboy.cn/blog/files/docker-compose-linux-x86_64-v2.27.1" -o /usr/local/bin/docker-compose
sudo chmod a+x /usr/local/bin/docker-compose

修改配置

shell
#export HARBOR_VERSION=2.5.6
export HARBOR_VERSION=2.9.4
#export HARBOR_VERSION=2.10.3
tar xvf harbor-offline-installer-v${HARBOR_VERSION}.tgz
cd harbor
cp harbor.yml.tmpl harbor.yml
vi harbor.yml

• 注释 https 配置

• http 的port 改成想要映射的端口

• hostname 改成 本机hostname或本机内外网ip

执行脚本

shell
# 安装Harbor需要Docker和DockerCompose的支持哦~
sh install.sh

常用命令

shell
# 查看
docker-compose ps

# 启动
docker-compose up -d

# 重启
docker-compose restart

# 停止
docker-compose down

访问 Harbor 测试

访问：http://ip:port 账号/密码：admin/Harbor12345

这里我的地址是：
http://192.168.235.100:3080