yannmichaux/aptly

https://github.com/yannmichaux/aptly-docker

Aptly Docker — 安全灵活的APT仓库服务器

https://img.shields.io/docker/pulls/yannmichaux/aptly?style=flat-square](https://hub.docker.com/r/yannmichaux/aptly) https://img.shields.io/github/v/release/yannmichaux/aptly-docker?style=flat-square](https://github.com/yannmichaux/aptly/releases)

这是一个功能完整、可用于生产环境的Docker镜像，基于Aptly搭建私有APT仓库，具备以下特性：

• 🔐 GPG签名（自动生成或自定义密钥）
• 📂 多组件支持（如main、stable、testing）
• 🧾 为客户端生成现代.sources文件
• 📤 通过PUT上传.deb包
• 📦 定时自动发布（Cron）
• 📊 Webhook + 邮件通知
• 🔒 可选上传基础认证（Basic Auth）
• 🧩 通过docker exec手动更新组件
• 🗑️ 简单的包移除功能

💡 工作原理

该镜像采用**"每个组件对应一个Aptly仓库"**的简化策略。每个组件（如main、stable）拥有独立的Aptly仓库，支持隔离发布、独立更新和快照管理。仓库命名格式为：

<REPO_NAME>_<COMPONENT>

例如，若REPO_NAME=internal且REPO_COMPONENTS=stable,testing，将创建internal_stable和internal_testing两个仓库，提升清晰度并避免发布冲突。

🚀 快速启动（Docker Compose）

yaml
services:
  aptly:
    container_name: aptly-server
    image: yannmichaux/aptly:latest
    ports:
      - "8080:80"
    environment:
      REPO_NAME: internal
      REPO_COMPONENTS: main,stable,testing
      REPO_DISTRIBUTION: noble
      REPO_ARCH: amd64

      # 可选：定时自动更新（每15分钟）
      CRON_UPDATE_COMPONENTS: "*/15 * * * *"

      # 可选：Webhook通知
      NOTIFY_WEBHOOK_URL: https://my-webhook-server/notify

      # 可选：邮件通知
      NOTIFY_SENDMAIL: true
      SMTP_HOST: smtp.domain.com
      SMTP_PORT: 587
      SMTP_USER: username
      SMTP_PASS: password
      SMTP_STARTTLS: no
      MAIL_FROM: aptly@domain.com
      MAIL_TO: you@domain.com
      MAIL_SUBJECT: "APT仓库更新通知"
      MAIL_ATTACHMENT: true
      SMTP_IGNORE_CERTS: true # 忽略自签名证书/证书错误
    volumes:
      - aptly-data:/var/lib/aptly
      - /path/to/config:/config
      - /path/to/secrets:/secrets
      - /path/to/incoming:/incoming
    restart: unless-stopped

volumes:
  aptly-data:

📤 上传包

通过PUT直接上传.deb文件：

bash
curl -X PUT --data-binary "@my-package.deb" http://<host>:8080/incoming/<component>/my-package.deb

🔐 若/config/htpasswd存在，上传路由将启用基础认证。

🔁 更新机制

• 自动更新：通过CRON_UPDATE_COMPONENTS定时执行
• 处理/incoming/<component>下的.deb文件
• 按组件创建仓库和发布快照
• 锁文件防止并发更新
• 生成每个组件的packages.json
• 可选发送：Webhook通知、邮件通知（需NOTIFY_SENDMAIL=true）

手动更新

bash
docker exec aptly-server update # 更新所有组件
docker exec aptly-server update stable # 更新指定组件
docker exec aptly-server update stable,testing # 更新多个组件

❗ 若组件不存在，更新将中止并显示有效组件列表。

📬 邮件通知

启用更新后邮件通知：

yaml
NOTIFY_SENDMAIL: true
SMTP_HOST: smtp.domain.com
SMTP_PORT: 587
SMTP_USER: username
SMTP_PASS: password
SMTP_STARTTLS: no
MAIL_FROM: aptly@domain.com
MAIL_TO: you@domain.com
MAIL_SUBJECT: "APT仓库更新通知"
MAIL_ATTACHMENT: true
SMTP_IGNORE_CERTS: true

使用mutt实现SMTP认证发送邮件。

🔏 GPG签名

• 若/secrets/private.asc存在，将导入该密钥
• 若无密钥，启动时自动生成 公钥可通过以下地址获取：

http://<host>/gpg

📚 客户端配置

镜像会在/config/examples/<REPO_NAME>.sources生成客户端配置文件，示例：

Types: deb
URIs: http://your-domain/
Suites: noble
Components: main stable
Signed-By: /usr/share/keyrings/internal-archive-keyring.gpg

🧪 手动调试

交互式运行容器：

bash
docker run --rm -it yannmichaux/aptly /bin/bash

容器内可用命令：

bash
/docker-entrypoint.sh update # 更新所有组件
/docker-entrypoint.sh update <component> # 更新指定组件
/docker-entrypoint.sh update <component> --force # 强制更新指定组件
/docker-entrypoint.sh remove <component> [<package-query>] # 移除包
/docker-entrypoint.sh help # 查看帮助

容器外执行命令：

bash
docker exec -it container_name update
docker exec -it container_name remove stable my-package

🛠 技术栈

• Aptly：APT仓库管理工具
• https://nginx.org/%EF%BC%9AWeb%E6%9C%8D%E5%8A%A1
• mutt：SMTP邮件发送