cups-avahi-airprint：让普通打印机支持AirPrint的Docker解决方案
项目地址: https://gitcode.com/gh_mirrors/cu/cups-avahi-airprint cups-avahi-airprint是一个基于Alpine Linux的Docker镜像项目，专门为非AirPrint功能的网络打印机提供AirPrint中继服务。通过这个解决方案，用户可以让现有的网络打印机支持苹果设备的无线打印功能，无需更换硬件设备。
技术架构
该项目基于轻量级的Alpine Linux构建，集成了完整的CUPS（Common UNIX Printing System）打印系统、Avahi服务发现协议以及相关的打印驱动支持。核心组件包括：
- CUPS打印系统：提供完整的打印服务管理功能
- Avahi服务发现：在网络中广播AirPrint服务信息
- 多种打印驱动：包括Ghostscript、HPLIP、brlaser和gutenprint等
- Python脚本支持：用于自动生成AirPrint服务配置文件
核心功能
AirPrint服务生成
项目中的airprint-generate.py脚本是关键组件，它能够自动连接CUPS服务器，获取已共享的打印机信息，并为每台打印机生成相应的Avahi服务文件。这些服务文件包含打印机支持的文档格式、纸张类型、颜色能力等详细信息，使iOS设备能够识别并使用这些打印机。
多架构支持
该项目支持ARM64和AMD64两种架构，可以在各种硬件平台上运行，包括树莓派等嵌入式设备。
灵活的配置选项
通过环境变量和挂载卷，用户可以灵活配置CUPS管理员账户、服务文件存储位置和打印机配置持久化存储：
CUPSADMIN：设置CUPS管理员用户名CUPSPASSWORD：设置CUPS管理员密码/config卷：存储持久化的打印机配置/services卷：存储生成的Avahi服务文件
部署方式
Docker运行示例
docker run --name cups --restart unless-stopped --net host \
-v /your/services/dir:/services \
-v /your/config/dir:/config \
-e CUPSADMIN="admin" \
-e CUPSPASSWORD="password" \
chuckcharlie/cups-avahi-airprint:latest
Docker Compose配置
version: '3.5'
services:
cups:
image: chuckcharlie/cups-avahi-airprint:latest
container_name: cups
network_mode: host
volumes:
- /your/services/dir:/services
- /your/config/dir:/config
environment:
CUPSADMIN: "admin"
CUPSPASSWORD: "password"
restart: unless-stopped
使用指南
- 启动容器：使用上述命令启动cups-avahi-airprint容器
- 访问管理界面：通过http://[主机IP]:631访问CUPS管理界面
- 添加打印机：在CUPS界面中添加并配置网络打印机，确保勾选"共享此打印机"选项
- 等待配置生效：配置完成后需要关闭浏览器至少60秒，CUPS才会写入配置文件
- 设备发现：iOS设备将自动发现并显示可用的AirPrint打印机
技术特点
- 轻量级设计：基于Alpine Linux，资源占用低
- 自动服务发现：通过Avahi自动广播AirPrint服务
- 广泛的打印机支持：集成多种打印驱动和过滤器
- 持久化配置：打印机配置和服务文件可持久化存储
- 安全配置：支持自定义管理员账户和密码
适用场景
- 家庭环境：让老旧打印机支持苹果设备无线打印
- 办公室：为现有网络打印机添加AirPrint功能
- 教育机构：低成本实现iOS设备打印支持
- 共享打印服务：在公共场所提供AirPrint打印服务
cups-avahi-airprint项目通过容器化技术，为传统打印机赋予了现代化的无线打印能力，是连接传统打印设备与移动办公需求的理想解决方案。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
