什么是 unregistry？
unregistry is a lightweight container image registry created by Pasha Sviderski that stores and serves images directly from your Docker daemon's storage. The included docker pussh command lets you push images straight to remote Docker servers over SSH, transferring only missing layers for maximum efficiency.
- Docker Hub/GHCR: Your code becomes public or you pay for private repos
- Self-hosted registry: Another service to maintain, secure, and pay for
- Save/Load: Transfers entire image even if 90% already exists on server
- Remote rebuild: Wastes time and server resources, debugging production builds
docker pussh myapp:latest user@server - That's it! Your image is on the remote server with no registry setup, no subscription, no intermediate storage, just direct transfer of missing layers over SSH.
⚡ Key Features of unregistry
🚀 Direct Transfer
Push images directly to remote servers over SSH. No intermediate registry, no exposed ports, just efficient point-to-point transfer.
📦 Layer Deduplication
Transfers only missing layers, like rsync for Docker images. If 90% of your image exists remotely, only 10% gets transferred.
🔒 Secure by Design
Uses SSH for authentication and transport. No exposed registry ports, no additional security configuration needed.
⚡ Zero Setup
No registry infrastructure to maintain. Works with any server that has Docker and SSH access.
🏗️ CI/CD Ready
Perfect for deployment pipelines. Build locally or in CI, push directly to production servers without registry complexity.
🌐 Multi-Platform
Supports multi-platform images with containerd image store. Deploy ARM and x86 images efficiently.
apt upgrade 即可始终保持最新版本。
📦 从 deb.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅，最多落后上游 2 个月，安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed；Unregistry 不在其中，因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具：它会替你写好 sources 文件并安装签名密钥，并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中，永久免费镜像则为 griffo-free，因此在 Debian（bookworm、trixie、forky、sid）上，上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥，订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内，因为 extrepo 只发布 Debian 各套件的元数据：在 Ubuntu 上请使用 sudo 或 root 的命令。
步骤 2：安装 unregistry
# Install unregistry and docker-pussh
sudo apt install unregistry docker-pussh
# Verify installation
docker pussh --version# Install unregistry and docker-pussh
apt install unregistry docker-pussh
# Verify installation
docker pussh --version🎯 基本使用示例
Simple image push:
# Build image locally
docker build -t myapp:latest .
# Push directly to remote server
docker pussh myapp:latest user@server.example.com
# That's it! Image is now available on remote serverAdvanced usage:
# Push with SSH key
docker pussh myapp:latest ubuntu@192.168.1.100 -i ~/.ssh/id_rsa
# Custom SSH port
docker pussh myapp:latest user@server:2222
# Specific platform for multi-arch images
docker pussh myapp:latest user@server --platform linux/amd64
# Use in deployment script
docker pussh myapp:$VERSION deploy@prod-server
ssh deploy@prod-server docker run -d myapp:$VERSIONCI/CD integration:
# GitHub Actions example
- name: Build and deploy
run: |
docker build -t myapp:${{ github.sha }} .
docker pussh myapp:${{ github.sha }} deploy@staging-server🚀 为什么选择 deb.griffo.io？
- Official Debian: Not available in official repositories
- Manual Script: Requires manual updates and dependency management
- Homebrew: Limited to specific platforms
- deb.griffo.io: Latest version with automatic updates
- ✅ Latest Features: Get newest Docker and SSH integration improvements
- ✅ Complete Package: Both unregistry and docker-pussh included
- ✅ Automatic Updates: Packages updated within hours of upstream releases
- ✅ Proper Integration: Correctly configured as Docker CLI plugin
- ✅ Multi-Distribution: Works on Bookworm, Trixie, and Sid
- ✅ Easy Maintenance: Standard apt commands for updates
📦 软件包构建仓库
Debian 软件包在此 GitHub 仓库中自动构建和维护：
- 📠 unregistry-debian - Latest release builds
- 📡 docker-pussh-debian - Latest release builds
🔗 相关软件包
也可从 deb.griffo.io 获取：
- lazydocker - Terminal UI for Docker management
- uncloud - Multi-server container deployment
- fzf Fuzzy Finder - Enhanced command searching