geertvanderploeg/cups-avahi-airprint

cups-avahi-airprint (armhf) 镜像文档

镜像概述

本镜像为chuckcharlie/cups-avahi-airprint的分支版本，在原镜像基础上添加了tzdata包以支持时区配置，并专门构建为armhf（32位）架构。主要用于在32位ARM设备（如部分嵌入式设备、旧款树莓派等）上提供CUPS打印服务、Avahi网络发现及AirPrint功能，实现打印机的网络共享与iOS设备无线打印支持。

核心功能和特性

继承特性

• CUPS打印服务：支持标准打印协议，可连接并共享各类打印机
• Avahi网络发现：实现局域网内打印机自动发现
• AirPrint支持：兼容iOS设备的AirPrint功能，无需额外驱动

新增特性

• tzdata包集成：支持通过环境变量配置时区，确保打印任务时间戳准确
• armhf架构支持：专为32位ARM设备优化，可在armhf架构硬件上稳定运行

使用场景

• 32位ARM嵌入式设备（如树莓派Zero、旧款树莓派1/2等）的打印机共享
• 需要支持iOS设备AirPrint功能的家庭或小型办公环境
• 对时区配置有要求的打印服务场景（如需要准确记录打印时间的环境）

使用方法和配置说明

基本使用（docker run）

bash
docker run -d \
  --name cups-airprint \
  --restart always \
  --net=host \
  -e TZ=Asia/Shanghai \
  -v /path/to/cups/config:/etc/cups \
  -v /path/to/printers:/var/run/cups \
  --device /dev/bus/usb \
  your-image-name:tag

参数说明

网络配置

• --net=host：推荐使用host网络模式，确保Avahi和AirPrint功能正常工作

环境变量

• TZ：时区配置，例如Asia/Shanghai、America/New_York等，需配合tzdata包使用

卷挂载

• /etc/cups：CUPS配置文件目录，持久化存储打印机配置
• /var/run/cups：打印机运行时数据目录

设备映射

• --device /dev/bus/usb：如果连接USB打印机，需映射USB总线设备

Docker Compose配置示例

yaml
version: '3'
services:
  cups-airprint:
    image: your-image-name:tag
    container_name: cups-airprint
    restart: always
    network_mode: host
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - ./cups-config:/etc/cups
      - ./printers-data:/var/run/cups
    devices:
      - /dev/bus/usb:/dev/bus/usb

配置CUPS服务

1. 容器启动后，通过http://<设备IP>:631访问CUPS管理界面
2. 使用默认管理员账户（首次访问需设置密码）登录
3. 添加打印机：在管理界面中选择"添加打印机"，按照指引完成打印机配置
4. 启用AirPrint：确保打印机共享选项已开启，Avahi会自动生成AirPrint配置

注意事项

• 确保32位ARM设备已安装Docker并支持armhf架构
• 使用host网络模式可能需要调整主机防火墙规则，开放631端口（CUPS）及Avahi相关端口（5353/udp等）
• 首次配置时建议备份/etc/cups目录，避免配置丢失
• USB打印机需确保设备权限正确，必要时调整容器用户权限或使用--privileged参数（谨慎使用）