spoonest/geminabox

Docker Geminabox镜像

geminabox是一个简单的私有RubyGems服务器，用于存储私有gem包。本镜像是基于Debian构建，Geminabox服务监听9292端口。同时推荐使用https://github.com/yuri-karpovich/gemtoabox Ruby gem，可将项目Gemfile中的所有gem（含依赖）备份到该服务器。

快速启动

bash
docker run -d -p 9292:9292 --name geminabox spoonest/geminabox:latest

认证配置

限制上传/删除访问

通过添加环境变量USERNAME和PASSWORD限制上传和删除操作：

bash
docker run -d -p 9292:9292 --name geminabox -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

限制所有访问

设置PRIVATE=true可限制所有仓库访问，需配合用户名密码：

bash
docker run -d -p 9292:9292 --name geminabox -e PRIVATE=true -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

持久化存储gem包

推荐将gem包存储在容器外，使用卷挂载：

bash
docker run -d -v /本地存储路径:/webapps/geminabox/data --name geminabox -p 9292:9292 -e PRIVATE=true -e USERNAME=myuser -e PASSWORD=mypassword spoonest/geminabox:latest

进入容器

使用docker exec进入容器（Docker 1.3+支持）：

bash
docker exec -it geminabox /bin/bash

访问地址：http://localhost:9292

上传gem包

1. 安装gemtoabox工具：

   bash
   gem install gemtoabox
   

2. 上传gem包：

   bash
   gem inabox gem-0.0.1.gem -g http://USERNAME:PASSWORD@HOST:9292
   

从私有仓库安装gem

在项目Gemfile中添加私有仓库源：

ruby
source 'http://USERNAME:PASSWORD@HOST:9292'

RubyGems代理

设置RUBYGEMS_PROXY=true可让Geminabox从rubygems.org拉取未存储的gem：

bash
docker run -d -p 9292:9292 --name geminabox -e RUBYGEMS_PROXY=true spoonest/geminabox:latest

高级配置

数据与配置持久化

• 包存储：挂载/webapps/geminabox/data目录
• 配置文件：挂载/webapps/geminabox/config.ru（自定义认证逻辑可参考https://github.com/geminabox/geminabox/wiki/Http-Basic-Auth%EF%BC%89

日志查看

通过Docker日志查看服务输出：

bash
docker logs -f geminabox

（-f参数类似tail -f实时跟踪日志）