如何快速部署Garage-WebUI？3种简单方法助你5分钟上手

【免费下载链接】garage-webuiWebUI for Garage Object Storage Service项目地址: https://gitcode.com/gh_mirrors/ga/garage-webui

Garage-WebUI是一款专为Garage对象存储服务打造的Web管理界面，通过直观的可视化操作，让用户轻松管理存储桶、对象和集群节点。无论是新手还是有经验的开发者，都能通过本文介绍的3种部署方法，在5分钟内快速搭建并使用Garage-WebUI。

📌 方法一：Docker Compose一键部署（推荐新手）

Docker Compose是最简单快捷的部署方式，只需几步即可完成：

1. 克隆仓库

   git clone https://gitcode.com/gh_mirrors/ga/garage-webui cd garage-webui

2. 启动服务
   项目根目录下已提供docker-compose.yml配置文件，直接运行：

   docker-compose up -d

3. 访问界面
   打开浏览器访问http://localhost:3909，即可看到Garage-WebUI的登录界面。

图：Garage-WebUI的仪表盘、集群管理、存储桶列表和密钥管理界面

🛠️ 方法二：手动构建Docker镜像

如果需要自定义配置，可以手动构建Docker镜像：

1. 克隆仓库并进入目录

   git clone https://gitcode.com/gh_mirrors/ga/garage-webui cd garage-webui

2. 构建镜像
   使用项目根目录的Dockerfile构建：

   docker build -t garage-webui:custom .

3. 运行容器

   docker run -d -p 3909:3909 --name garage-webui \ -v ./garage.toml:/etc/garage.toml:ro \ -e API_BASE_URL="http://garage:3903" \ garage-webui:custom

🚀 方法三：源码编译部署（适合开发者）

如果你需要修改源码或了解底层实现，可以通过源码编译部署：

前端构建

1. 进入前端目录并安装依赖：

   cd src npm install -g corepack && corepack use pnpm pnpm install pnpm run build # 构建结果输出到 dist 目录

后端构建

1. 进入后端目录并编译：

   cd backend go mod download make # 生成可执行文件 main

2. 运行服务

   ./main --config garage.toml

🔍 验证部署是否成功

部署完成后，访问http://localhost:3909，成功加载后会显示Garage-WebUI的主界面。你可以通过以下功能验证：

• 存储桶管理：查看或创建存储桶（对应界面：misc/img/buckets.png）
• 集群状态：检查节点连接和存储使用情况（对应界面：misc/img/cluster.png）

❓ 常见问题解决

• 端口冲突：如果3909端口被占用，修改docker-compose.yml或启动命令中的端口映射（如-p 8080:3909）。
• 配置文件错误：确保garage.toml中的API地址正确指向Garage服务。

通过以上3种方法，你可以根据自己的需求选择最适合的部署方式，快速体验Garage-WebUI带来的便捷存储管理功能！

【免费下载链接】garage-webuiWebUI for Garage Object Storage Service项目地址: https://gitcode.com/gh_mirrors/ga/garage-webui