如何配置aptly.conf以通过Github Pages托管APT仓库？

一、FileSystemPublishEndpoints的作用 #

是的，FileSystemPublishEndpoints完全满足你的需求——它就是用来定义自定义的文件系统发布端点，将aptly生成的仓库内容定向输出到指定本地目录，正好适配GitHub Pages的部署流程（先输出到GitHub仓库本地副本，再推送到远端）。

二、具体配置步骤 #

1. 准备GitHub Pages仓库本地副本

先把你的GitHub Pages仓库克隆到本地，创建apt-repo目录（对应部署路径abc.xyz.io/apt-repo）：

git clone https://github.com/你的用户名/你的仓库名.git /path/to/gh-pages-repo
mkdir -p /path/to/gh-pages-repo/apt-repo

2. 修改aptly.conf配置文件

打开aptly的配置文件（通常位于~/.aptly.conf或/etc/aptly.conf），添加FileSystemPublishEndpoints配置段，指定输出到刚才创建的apt-repo目录：

{
  "rootDir": "/var/aptly",
  "architectures": ["amd64", "i386"], // 根据你的需求调整架构
  "FileSystemPublishEndpoints": {
    "github-pages": {
      "RootDir": "/path/to/gh-pages-repo/apt-repo",
      "SkipContents": false, // 是否跳过生成Contents文件，按需设置
      "PublishMethod": "hardlink" // 可选hardlink（高效，需同文件系统）或copy（通用）
    }
  }
}

3. 使用自定义端点发布仓库

用aptly publish命令指定你定义的github-pages端点，发布你的仓库/快照：

# 发布仓库（假设仓库名为my-repo，发行版代号为focal）
aptly publish repo -endpoint=github-pages my-repo focal

# 如果是发布快照，命令类似
aptly publish snapshot -endpoint=github-pages my-snapshot focal

4. 推送内容到GitHub Pages

进入本地GitHub仓库目录，提交并推送更新后的APT仓库内容：

cd /path/to/gh-pages-repo
git add apt-repo/
git commit -m "更新APT仓库内容"
git push origin main # 如果你的GitHub Pages用gh-pages分支，替换为gh-pages

5. 客户端配置（供用户使用你的仓库）

用户需要在本地sources.list中添加你的仓库源，示例：

# 导入GPG密钥（如果你的仓库已签名）
curl -s https://abc.xyz.io/apt-repo/pubkey.gpg | sudo gpg --dearmor -o /usr/share/keyrings/my-repo-keyring.gpg

# 添加源
echo "deb [signed-by=/usr/share/keyrings/my-repo-keyring.gpg] https://abc.xyz.io/apt-repo focal main" | sudo tee /etc/apt/sources.list.d/my-repo.list

# 更新源
sudo apt update

三、注意事项 #

• 确保aptly进程有写入/path/to/gh-pages-repo/apt-repo目录的权限
• GitHub Pages部署可能需要几分钟时间，等待完成后再测试源可用性
• 如果使用hardlink作为发布方式，需确保aptly的root目录（rootDir配置项）和GitHub仓库本地副本在同一文件系统下，否则会自动 fallback 到copy模式

内容的提问来源于stack exchange，提问作者Keval Bhogayata