michaelbalser/airprint-generate

airprint-generate

镜像概述

airprint-generate是一个基于最新稳定版Alpine Linux v3的Docker镜像，每日自动构建，支持多架构（amd64、arm32v6、arm32v7、arm64）。该镜像运行后台服务，监控CUPS打印机配置变化，自动重新生成兼容Apple AirPrint的avahi .service文件。整合了多个airprint-generate分支的增强功能与修复，提供稳定高效的AirPrint服务配置解决方案。

核心功能与特性

• 多架构支持：兼容amd64、arm32v6、arm32v7、arm64架构，适配桌面设备、服务器及嵌入式设备（如Raspberry Pi）
• 自动配置更新：实时监控CUPS配置文件变化，自动重新生成AirPrint服务配置
• 每日构建机制：基于Alpine Linux v3每日自动重建镜像，确保组件最新性与安全性
• 增强兼容性：整合多个社区fork的改进，优化与CUPS及avahi的协同工作流程
• 智能PDL处理：自动适配DNSSD的255字符txt-record限制，截断超出长度的PDL列表（--verbose可查看截断详情）

使用场景

适用于需要将CUPS共享打印机转换为Apple AirPrint服务的场景，例如：

• 家庭或小型办公网络中，使iOS/macOS设备通过AirPrint无线打印
• 嵌入式设备（如树莓派）搭建轻量级AirPrint网关
• 企业环境中统一管理网络打印机的AirPrint发布

前置要求

• 已配置共享打印机的CUPS服务器（需启用共享功能）
• CUPS服务器需配置PDF过滤器（Debian/Ubuntu等发行版默认预装）
• 打印机不应配置为raw模式（除非原生支持PDF打印）

详细使用指南

多架构镜像说明

镜像基于Docker Manifest List构建（michaelbalser/airprint-generate），运行时会自动匹配主机架构，无需手动指定架构标签。

部署方式

构建镜像（可选）

shell
docker build -t airprint-generate .

运行容器

shell
docker create \
  --name airprint-generate \
  --restart always \
  --volume /etc/cups:/config \  # 挂载CUPS配置目录（可选，用于监控配置变化）
  --volume /etc/avahi/services:/services \  # 挂载avahi服务目录，输出.service文件
  --env CUPS_HOST=<你的CUPS服务器IP> \  # 必需：CUPS服务器IP地址
  --env CUPS_PORT=631 \  # 可选：CUPS端口，默认631
  michaelbalser/airprint-generate:latest

脚本参数说明

可通过命令行参数自定义生成行为：

选项:
  -h, --help            显示帮助信息并退出
  -H HOSTNAME, --host=HOSTNAME
                        CUPS服务器主机名（默认使用CUPS_HOST环境变量）
  -P PORT, --port=PORT  CUPS服务器端口号（默认631）
  -u USER, --user=USER  CUPS认证用户名（可选）
  -d DIRECTORY, --directory=DIRECTORY
                        输出.service文件的目录（默认/etc/avahi/services）
  -v, --verbose         启用调试模式，打印详细信息到STDERR
  -p PREFIX, --prefix=PREFIX
                        服务文件名前缀字符串（可选）

使用示例

指定CUPS服务器及输出目录：

shell
docker run --rm \
  --volume /tmp/avahi-services:/output \
  michaelbalser/airprint-generate:latest \
  --host 192.168.1.100 \
  --port 631 \
  --directory /output \
  --verbose

注意事项

• 若CUPS服务器启用认证，需通过--user参数提供有权限的用户名
• 服务文件生成后需重启avahi-daemon使配置生效
• 对于大型网络，建议使用--prefix参数为不同位置的打印机添加前缀区分
• 启用--verbose可排查PDL列表截断问题及CUPS连接故障