jordanjennings/portus
jordanjennings
自动构建
Portus是Docker Registry v2的授权服务器和用户界面，提供细粒度权限控制、Web管理界面及自托管能力，支持用户/团队管理、镜像访问控制、LDAP认证、审计监控等功能，适用于私有Docker镜像仓库管理。
下载次数: 0状态：自动构建维护者：jordanjennings仓库类型：镜像最近更新：8 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Portus
镜像概述
Portus是Docker Registry v2的授权服务器和用户界面，专为Docker Registry API v2设计，最低支持Registry 2.1版本（首个支持blob软删除的版本）。它提供权限管理、镜像可视化及自托管能力，帮助用户构建和管理私有Docker镜像仓库。
- 官方网站：[***]
- 博客：[***]
- 邮件列表：https://groups.google.com/forum/#!forum/portus-dev
- 官方Docker镜像：https://hub.docker.com/r/opensuse/portus/
核心功能与特性
细粒度权限控制
- 支持用户和团队概念：用户拥有个人Docker命名空间，具备读写权限；团队是用户组，可对特定命名空间拥有读写权限。
- 实现Docker Registry的https://github.com/docker/distribution/blob/master/docs/spec/auth/token.md%EF%BC%8C%E5%85%A8%E9%9D%A2%E6%8E%A7%E5%88%B6%E9%95%9C%E5%83%8F%E8%AE%BF%E9%97%AE%E6%9D%83%E9%99%90%E3%80%82
Docker Registry Web界面
- 快速访问私有Registry中的所有镜像，基于用户权限过滤显示内容，确保未授权用户无法查看私有镜像。
自托管能力
- 支持在自有服务器和基础设施上部署，无需依赖第三方服务，完全掌控数据和服务。
其他重要特性
- 与私有Registry同步，获取可用镜像和标签信息
- LDAP用户认证集成
- 监控Registry和Portus的所有活动审计日志
- 仓库和标签搜索功能
- 仓库收藏（Star）功能
- 临时禁用用户
- 可选应用令牌增强安全性
支持版本
| Portus版本 | Docker Engine版本 | Docker Distribution版本 |
|---|---|---|
| master分支 | 1.6+ | 2.0+ |
| 2.1+ | 1.6+ | 2.0+ |
| 2.0.0 & 2.0.1 | 1.6 至 1.9 | 2.0 至 2.2 |
| 2.0.2 | 1.6 至 1.9 | 2.0 至 2.4 |
| 2.0.3+ | 1.6+ | 2.0 至 2.4 |
版本说明：
- Docker Engine 1.6是Docker Distribution 2支持的首个版本，因此也是Portus的最低要求
- Docker 1.10及以上使用Manifest Version 2, Schema 2，仅在Portus master分支和2.0.3版本中支持
- Docker Distribution 2.3支持两种Manifest版本，但Portus 2.0.0和2.0.1不支持其向后兼容性
部署方法
Portus支持多种部署方式：
容器化部署
在项目的examples目录中提供了多种容器化部署示例，包括Kubernetes等编排工具的配置。
裸机部署
- RPM包安装：参考RPM包安装文档
- 手动配置：通过NGinx和Puma手动部署，参考Nginx裸机部署文档
贡献指南
- 开发环境设置：可通过Docker或Vagrant搭建，详见https://github.com/SUSE/Portus/wiki#developmentplayground-environments
- 测试方法：参考https://github.com/SUSE/Portus/wiki/How-we-test-Portus
- 贡献规范：请阅读https://github.com/SUSE/Portus/blob/master/CONTRIBUTING.md
许可信息
Portus采用Apache License 2.0许可协议，详见https://github.com/SUSE/Portus/blob/master/LICENSE%E5%AE%8C%E6%95%B4%E6%96%87%E6%9C%AC%E3%80%82
功能预览
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"