CUPS (简体中文)

相关文章

• CUPS/Printer sharing
• CUPS/Printer-specific problems
• CUPS/Troubleshooting
• Samba
• LPRng

翻译状态：本文是 CUPS 的翻译。上次翻译日期：2022-03-24。如果英文版本有所更改，则您可以帮助同步翻译。

CUPS 是 OpenPrinting 为 Linux® 和其他类 UNIX® 操作系统开发的基于标准的、开源的打印系统。

Arch Linux 所打包的是 OpenPrinting CUPS 分支，而非 苹果 CUPS 分支。

安装

请先 安装 cups 软件包。

如果想将文件“打印”成一个 PDF 文档，也请安装 cups-pdf 软件包。默认情况下，PDF 文件存储在 /var/spool/cups-pdf/username/ 目录里。可以在 /etc/cups/cups-pdf.conf 配置文件中变更位置。

启用 并 启动 cups.service 服务，或者也可使用以下的套接字激活方式，使得仅当有程序需要使用服务时才启动 CUPS。

套接字激活

cups 提供了一个 cups.socket 单元。如果启用了 cups.socket （且 cups.service 在禁用状态）， systemd 不会立即启动 CUPS，而只是监听对应的套接字。之后，当有程序尝试连接其中一个 CUPS 套接字时，systemd 便会启动 cups.service，并将这些端口的控制透明地移交给 CUPS 进程。

打印工作步骤

要解决一些相关问题，了解 CUPS 的工作原理很重要：

1. 当选择“打印”时，应用程序会发送一个 PDF 文件（若应用程序发送的是其他格式则先转换为 PDF）给 CUPS；
2. 然后，CUPS 查询打印机的 PPD 文件（打印机描述文件），并确定需要使用何种过滤器将 PDF 文件转换为打印机可以理解的语言（如 PJL、PCL、位图或原生 PDF）；
3. 过滤器将 PDF 文件转换为打印机可以理解的格式；
4. 然后数据被发送到后端。例如，如果打印机连接到了 USB 端口，则会使用 USB 后端。

连接接口

下面列出了适用于各种连接接口的额外打印机检测步骤。

USB 接口

要查看是否检测到 USB 打印机，请确保安装了usbutils软件包，然后执行以下操作：

$ lsusb

(...)
Bus 001 Device 007: ID 03f0:1004 Hewlett-Packard DeskJet 970c/970cse

并口

要使用并口打印机，需要 lp, parport 和 parport_pc 内核模块。

# dmesg | grep -i parport

 parport0: Printer, Hewlett-Packard HP LaserJet 2100 Series
 lp0: using parport0 (polling)

网络共享

要使用 DNS-SD/mDNS 查找、使用或共享打印机，请使用 Avahi 设置 .local 主机名解析，然后重启 cups.service 服务。

注意： 只有使用 Avahi 时才支持 DNS-SD。 CUPS 不支持对 DNS-SD 使用 systemd-resolved，参见 CUPS issue 5452。

要用 Samba 共享打印机，例如：如果系统要用作 Windows 客户端的打印服务器，则需要安装 samba 软件包。

打印机驱动

打印机的驱动程序可能来自以下任何来源。 请参阅 CUPS/Printer-specific problems 获取其他人设法使用的驱动程序的不完整列表。

要驱动一台打印机，CUPS 需要一个 PPD 文件，对于大多数打印机来说，还需要一些 过滤器。 有关 CUPS 如何使用 PPD 和过滤器的详细信息，请参阅 [1]。

OpenPrinting 打印机列表 (英语) 提供了许多打印机的推荐驱动程序。它还为每台打印机提供了相应的 PPD 文件，但是大多数文件都可以通过 foomatic 或其它推荐的驱动程序包获得。

将 PPD 文件提供给 CUPS 后，CUPS 服务器将重新生成 PPD 文件并将其保存在 /etc/cups/ppd/ 中。

CUPS

CUPS 本体包括了对 AirPrint 和 IPP Everywhere 打印机的支持。

OpenPrinting CUPS 过滤器

Linux 基金会旗下的 OpenPrinting 工作组提供了 cups-filters (CUPS 过滤器)。这里面是一些后端软件、过滤器和其他二进制文件，它们曾经是 CUPS 本体的一部分，但被项目丢弃。这些文件可通过 cups-filters 软件包获得，后者是 cups 的依赖项之一。

非 PDF 打印机需要安装 ghostscript。对于 PostScript 打印机可能还需要安装 gsfonts。

Foomatic

Linux 基金会旗下 OpenPrinting 工作组维护的 foomatic 为许多打印机提供了 PPD 文件，既有自由的也有非自由的。 有关 foomatic 功能的更多信息，请参阅 开发者眼中的 Foomatic (英语)。

要使用 foomatic，请安装 foomatic-db-engine 和下列的至少一个软件包：

• foomatic-db - foomatic-db-engine 用来生成 PPD 文件的 XML 文件集合。
• foomatic-db-ppds - 预构建好的 PPD 文件。
• foomatic-db-nonfree - 打印机制造商提供的、非自由许可协议下的、foomatic-db-engine 用于生成 PPD 文件的 XML 文件集合。
• foomatic-db-nonfree-ppds - 非自由许可协议下的预构建 PPD 文件。

Foomatic 的 PPD 文件可能还需要额外的过滤器，比如 min12xxw^AUR。

Gutenprint

Gutenprint 项目 提供了可与 CUPS 和 GIMP 搭配使用的佳能(Canon)、爱普生(Epson)、利盟(Lexmark)、索尼(Sony)、奥林巴斯(Olympus) 以及 PCL 打印机的驱动程序。

安装 gutenprint 和 foomatic-db-gutenprint-ppds 可获得。

注意： 当 Gutenprint 软件包更新时，使用 Gutenprint 驱动的打印机将会停止工作，直到以 root 身份运行 cups-genppdupdate 并重新启动 CUPS。cups-genppdupdate 将会升级已配置打印机的 PPD 文件，参见 cups-genppdupdate(8) 获取更多细节。

制造商特定的驱动程序

许多打印机厂商提供它们自己的 Linux 驱动。这些驱动通常可以在 Arch 官方仓库和 AUR 里找到。

其中一些驱动在 CUPS/Printer-specific problems 一文里有更详细的描述。

打印机 URI

下面列出了一些用于在需要时手动生成 URI 的额外步骤。CUPS/Printer-specific problems 一文里说明了一些需要特别 URI 的打印机或驱动。

USB 打印机

CUPS 应该能够为 USB 打印机自动生成 URI, 例如 usb://HP/DESKJET%20940C?serial=CN16E6C364BH。

如果没有，请参阅 CUPS/Troubleshooting#USB printers 进行故障排除。

并口打印机

并口打印机的 URI 格式应为parallel:device。例如，如果打印机连接在 /dev/lp0 上，则 URI 使用 parallel:/dev/lp0。如果使用了 USB 转并行端口适配器，请使用 parallel:/dev/usb/lp0 作为打印机 URI。

网络打印机

如果已经按照 #网络共享 一节中配置好了 Avahi，CUPS 应该能检测到打印机 URI。另外还可以使用 avahi-discover 查找需要的打印机的名称及其地址（例如 BRN30055C6B4C7A.local/10.10.0.155:631）。

也可以不使用 Avahi 来手动生成 URI。 CUPS 文档里提供了一张网络打印机可用 URI 方案列表。由于不同打印机的 URI 具体细节有所差异，请查看打印机的用户手册或 CUPS/Printer-specific problems。

smbspool(8) 手册页中介绍了 SMB 共享打印机的 URI。

注意： 打印机 URI 中的任何特殊字符都需要正确地转义引用，否则，如果您的 Windows 打印机名称或用户密码里含有空格，CUPS 会报出 lpadmin: Bad device-uri 错误。

例如， smb://BEN-DESKTOP/HP Color LaserJet CP1510 series PCL6 要写成 smb://BEN-DESKTOP/HP%20Color%20LaserJet%20CP1510%20series%20PCL6。

可通过运行以下命令来获取此结果字符串：

$ python -c 'from urllib.parse import quote; print("smb://" + quote("BEN-DESKTOP/HP Color LaserJet CP1510 series PCL6"))'

远程 CUPS 打印服务器可通过 ipp://hostname:631/printers/queue_name 这样格式的 URI 来访问。关于如何配置远程打印服务器的详细信息，请参阅 CUPS/Printer sharing#Printer sharing。

有关其它问题和相应解决方案，请参阅 CUPS/Troubleshooting#Networking issues。

警告： 避免使用同一个打印机过滤器配置服务器和客户端 —— 客户端或服务器上的打印队列应为“原始 (raw)”状态。这样可以避免通过过滤器向打印机发送两次打印作业，不然可能导致问题，例如：共享打印机在本地工作，但远程计算机却无法打印 ([2])。有关将打印队列设置为“原始”的示例，请参见 #lp* 一节。

使用方法

可以通过 lp* 和 cups* CLI 工具完全控制 CUPS。 此外，也可以使用 #网页界面 和几种 #GUI 应用 之一来控制 CUPS。

• 队列 (queue) 名称是系统上用来标识队列的简短但有描述性的名称。这个名称不应该含有空格或任何特殊字符。比如，对应打印机 HP LaserJet 5P 的打印队列可以命名为“ hpljet5p”。一台物理打印机可以关联多个队列。
• 位置 (location) 用来描述打印机的物理位置（比如说“卧室”或者“厨房”）。这有助于维护多台打印机。
• 描述 (description) 是打印队列的完整描述。一个常见用法是填写打印机的全名（比如说 "HP LaserJet 5P"）。

命令行工具

有关命令行工具的更多技巧，请参阅 CUPS 本地文档。

注意： 命令行开关不可聚合使用。

使用 SNMP 查询 URI：

$ /usr/lib/cups/backend/snmp ip_address

lp*

lpinfo 实用程序加上 -v 开关可列出设备，加上 -m 可列出型号。

lpadmin 实用程序加上 -p queue_name可创建新队列。-E 开关与 -p 一起使用可启用并接受打印机上的任务。-v 指定设备 URI， -m 指定型号或要使用的 PPD 文件。 也可使用 -x 开关删除打印机（请先阅读下面一节）。

例子:

# lpadmin -p HP_DESKJET_940C -E -v "usb://HP/DESKJET%20940C?serial=CN16E6C364BH" -m drv:///HP/hp-deskjet_940c.ppd.gz

对于免驱动打印队列（Apple AirPrint 或 IPP Everywhere）：

# lpadmin -p AirPrint -E -v "ipp://10.0.1.25/ipp/print" -m everywhere  

原始队列，不含 PPD 文件或过滤器：

# lpadmin -p SHARED_PRINTER -m raw   

指定一个 PPD 文件而不是型号：

# lpadmin -p Test_Printer -E -v "ipp://10.0.1.3/ipp/print" -m pxlmono.ppd    

注意：

• 指定 PPD 时，请只使用文件名，而不要用完整路径（例如，应该使用 pxlmono.ppd 而不是 /usr/share/ppd/cupsfilters/pxlmono.ppd）。或者也可通过 -P 命令行开关使用完整路径。
• 到2021年时，许多新款打印机支持免驱打印设置。如上述第二个例子一样指定 -m everywhere，即可定义打印机，并通过查询网络上的打印机在 /etc/cups/ppd/ 中生成 .ppd 文件。

lpq 实用程序可查看队列。加上 -a 开关可查看所有队列。

lprm 实用程序可清除队列。加上 - 可删除所有项目，而不是像默认情况下只删除最后一项。

lpr 实用程序可进行打印。使用 -# N 可打印文件 N 遍，使用 -p 开关可加入标头。

使用 lpr 的测试打印示例：

$ lpr /usr/share/cups/data/testprint
$ echo 'Hello, world!' | lpr -p 

lpstat 实用程序加上 -s 开关可检查状态。 -p 开关允许指定检查哪个队列。

lpoptions 实用程序使用与上述的 lpadmin 相同的 -p queue_name 开关。加上 -l 开关可列出选项。 -d 开关可通过参数 queue_name 设置默认打印机。 -o 开关设置选项的值：

$ lpoptions -p HP_DESKJET_940C -o PageSize=A4
$ lpoptions -p HP_DESKJET_940C -o cupsIPPSupplies=true -o Duplex=DuplexNoTumble

cups*

cupsaccept、cupsdisable、cupsenable 及 cupsreject 实用程序的作用正如其名称所示，分别是：设置打印机接受任务、禁用打印机、激活打印机、设置打印机拒绝所有收到的任务。

以下用法示例会彻底删除一台打印机：

# cupsreject queue_name
# cupsdisable queue_name
# lpadmin -x queue_name

ink

安装 ink^AUR 查看墨量。

注意： 参阅打印机支持列表。

将你的用户添加到 lp 用户组，注销然后再登录。

有关用法的信息，请不带参数运行 ink。

网页界面

可以通过 http://localhost:631/ 上的网页界面完全管理 CUPS 服务器。

注意： 如果使用 HTTPS 连接 CUPS，第一次访问时 可能 要花好长时间才能见到界面出现。这是因为第一次请求会触发 SSL 证书的生成，这会是一项耗时的工作。

要从网页界面执行管理任务，需要验证身份；见 #权限。

添加队列

转到 Administration 页面。

修改现有队列

转到 Printers 页面，然后选择一个队列来修改。

测试队列

转到 Printers 页面，然后选择一个队列。

GUI 应用

如果用户没有足够权限来管理 CUPS，应用启动时会要求输入 root 用户密码。要授予用户管理权而无需 root 用户访问权限，参见 #配置 小节。

• Deepin Print Manager — 深度桌面环境的打印机配置界面。

https://github.com/linuxdeepin/dde-printer || deepin-printer

• GtkLP — CUPS 的 GTK 界面。

https://gtklp.sirtobi.com/index.shtml || gtklp^AUR

• print-manager — 管理打印任务和打印机的工具 (KDE)。

https://invent.kde.org/utilities/print-manager || print-manager

• system-config-printer — GTK 打印机配置工具和状态小程序。

https://github.com/OpenPrinting/system-config-printer || system-config-printer

配置

CUPS 服务器配置位于 /etc/cups/cupsd.conf 和 /etc/cups/cups-files.conf (参见 cupsd.conf(5) 和 cups-files.conf(5))。编辑完上述文件之后，重启 cups.service 以应用所有更改。默认设置对大多数用户已足够。

权限

/etc/cups/cups-files.conf 文件里的 SystemGroup 一处定义了有打印机管理权限的 用户组。默认情况下使用 sys、root 和 wheel 组。

CUPS 助手程序以 cups 用户及组运行。这样助手程序就可以访问打印机设备，并读取由 cups 组拥有的 /etc/cups/ 内的配置文件。

注意： cups 2.2.6-2 之前使用的是lp组。在升级之后，/etc/cups 中的文件应该由 cups 组和 User 209 及 Group 209 拥有，如 /etc/cups/cups-files.conf 中所设置的那样。

默认纸张尺寸

cups 构建时开启了 libpaper 支持并且 libpaper 默认纸张尺寸设为 Letter（该选项在 lpoptions 中被称为 PageSize）。要避免得一个一个更改添加的打印队列的纸张尺寸，请编辑 /etc/papersize 并设置系统默认纸张尺寸。参见 papersize(5)。

日志文件

默认情况下，所有日志都会发送到 /var/log/cups/ 中的文件里。通过将 /etc/cups/cups-files.conf 中的 AccessLog、ErrorLog 和 PageLog 指令的值改为 syslog，CUPS 可以把日志记录到 systemd 日志 中。有关原始建议更改的信息，请参阅 Fedora 维基页面 (英文)。

打印服务器和远程管理

参见 CUPS/Printer sharing 和 CUPS/Printer sharing#Remote administration。

允许通过 PolicyKit 进行管理员身份验证

可配置 PolicyKit，允许用户使用一个 GUI 来配置打印机，而无需使用管理员密码。

注意： 你可能需要安装 cups-pk-helper 来使这个规则生效。

这是一个允许 wheel 用户组 的成员无需密码即可管理打印机的示例：

/etc/polkit-1/rules.d/49-allow-passwordless-printer-admin.rules

polkit.addRule(function(action, subject) { 
    if (action.id == "org.opensuse.cupspkhelper.mechanism.all-edit" && 
        subject.isInGroup("wheel")){ 
        return polkit.Result.YES; 
    } 
});

不使用本地 CUPS 服务器

CUPS 可以被配置为直接连接到远程打印机服务器，而不是在本地运行打印服务器。这需要 安装 libcups 软件包。某些应用程序仍需要依赖 cups 软件包进行打印。

警告： 开发人员不建议在没有本地 CUPS 服务器的情况下访问远程打印机。 [3]

要使用远程 CUPS 服务器，请将 CUPS_SERVER 环境变量 设定为 printerserver.mydomain:port。例如，如果你想让单个 Firefox 实例使用不同的打印服务器(将 printserver.mydomain:port 替换为您的打印服务器名称/端口)：

$ CUPS_SERVER=printserver.mydomain:port firefox

要想永久性应用设置，创建配置文件 /etc/cups/client.conf 并向其添加远程 CUPS 服务器的主机名：

ServerName server

也可以指定自定义的端口：

ServerName server:port

详见[4]。

故障排除

请参阅 CUPS/Troubleshooting。

另请参阅

• 官方 CUPS 文档, 安装在本地
• Wikipedia:CUPS
• OpenPrinting 主页
• OpenSuSE 打印概念指南 - 解释完整的打印工作流程
• OpenSuSE CUPS 简述 - CUPS 快速概览
• Gentoo 的打印指南
• Debian 的打印门户站 - 详细的技术指南
• Debian 的打印概览 - CUPS 打印系统的基本概述