Ubuntu环境下 Harbor docker安装教程

在 Ubuntu 服务器（241）上安装 Harbor，推荐使用官方的 Docker Compose 部署方案，这是最稳定、最常用的方式。以下是详细步骤：

一、环境准备

1. 安装 Docker

Harbor 依赖 Docker 运行，先安装 Docker：

bash 复制代码

# 更新包列表
sudo apt update

# 安装 Docker
sudo apt install -y docker.io

# 启动并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 验证 Docker 安装
docker --version

2. 安装 Docker Compose

Harbor 使用 Docker Compose 管理容器，安装最新版：

bash 复制代码

# 下载 Docker Compose 二进制文件
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

二、下载并解压 Harbor 安装包

访问 Harbor GitHub Releases，选择最新稳定版（如 v2.8.0），复制下载链接，在服务器上执行：

bash 复制代码

# 下载 Harbor 离线安装包（推荐，避免网络问题）
wget https://github.com/goharbor/harbor/releases/download/v2.8.0/harbor-offline-installer-v2.8.0.tgz

# 解压
tar -zxvf harbor-offline-installer-v2.8.0.tgz
cd harbor

三、配置 Harbor

复制配置模板：
bash 复制代码
```
cp harbor.yml.tmpl harbor.yml
```

编辑配置文件 ：使用 vim 或 nano 编辑 harbor.yml，修改以下关键配置：

bash 复制代码

# 必须修改：Harbor 的访问地址（服务器 IP 或域名）
hostname: 192.168.1.241  # 替换为 241 服务器的实际 IP 或域名

# 可选：修改 HTTP 端口（默认 80，若冲突可改，如 8080）
http:
  port: 80

# 可选：配置 HTTPS（生产环境强烈推荐）
# https:
#   port: 443
#   certificate: /path/to/your/server.crt
#   private_key: /path/to/your/server.key

# 数据存储路径（默认 /data，确保有足够空间）
data_volume: /data/harbor

# 管理员初始密码（默认 Harbor12345，建议修改）
harbor_admin_password: YourStrongPassword123

四、执行安装

运行安装脚本：

bash 复制代码

# 执行安装（不带 HTTPS）
sudo ./install.sh

# 若配置了 HTTPS，执行：
# sudo ./install.sh --with-trivy --with-chartmuseum

脚本会自动拉取镜像、创建容器并启动 Harbor 服务。

验证服务状态：

bash 复制代码

# 查看 Harbor 容器状态
docker-compose ps

# 正常状态下，所有容器应为 "Up" 状态

五、访问 Harbor

Web 界面访问：打开浏览器，访问：
bash 复制代码
```
http://192.168.1.1  # 或你配置的域名/端口
```
使用默认账号 admin 和你设置的密码（或默认 Harbor12345）登录。
命令行验证：
bash 复制代码
```
# 登录 Harbor
docker login 192.168.1.241
```
输入账号密码，登录成功即表示 Harbor 正常运行。

六、后续配置

设置开机自启：创建 systemd 服务文件，让 Harbor 随系统启动：

bash 复制代码

sudo vim /etc/systemd/system/harbor.service

写入以下内容（注意修改 Harbor 安装路径）：

bash 复制代码

[Unit]
Description=Harbor
After=docker.service systemd-networkd.service systemd-resolved.service
Requires=docker.service

[Service]
Type=simple
Restart=on-failure
RestartSec=5
ExecStart=/usr/local/bin/docker-compose -f /path/to/harbor/docker-compose.yml up
ExecStop=/usr/local/bin/docker-compose -f /path/to/harbor/docker-compose.yml down

[Install]
WantedBy=multi-user.target

然后执行：

bash 复制代码

sudo systemctl daemon-reload
sudo systemctl enable harbor
sudo systemctl start harbor

备份与安全：
- 定期备份 /data/harbor 目录和 harbor.yml 配置文件。
- 生产环境务必配置 HTTPS，避免明文传输密码和镜像数据。

常见问题

端口冲突 ：若 80/443 端口被占用，可在 harbor.yml 中修改 http.port 和 https.port。
存储空间不足 ：确保 data_volume 指向的磁盘有足够空间存放镜像。
防火墙：确保服务器防火墙开放 80/443 端口（或你配置的 Harbor 端口）。

安装完成后，你就可以使用 Harbor了

END

如果觉得这份基础知识点总结清晰，别忘了动动小手点个赞👍，再关注一下呀～后续还会分享更多有关开发问题的干货技巧，同时一起解锁更多好用的功能，少踩坑多提效！🥰 你的支持就是我更新的最大动力，咱们下次分享再见呀～🌟