Servidor CUPS

Nivell: ASIX / SMX

Sistema: Ubuntu Server 26.04 LTS

Introducció

CUPS (Common Unix Printing System) és el sistema d’impressió estàndard en sistemes GNU/Linux i macOS. Permet gestionar impressores locals i en xarxa, actuar com a servidor d’impressió per a altres equips (Windows, Linux, macOS) i administrar cues d’impressió.

La finalitat d’aquest document és mostrar com:

Instal·lar i arrancar el servei CUPS

Configurar l’accés a la interfície web d’administració

Afegir impressores locals i en xarxa

Compartir impressores a la xarxa local

Gestionar cues i treballs d’impressió

Prerequisits

Ubuntu Server 26.04 LTS instal·lat i actualitzat
Accés amb privilegis sudo
Connexió a la xarxa local
(Opcional) Una impressora física o virtual per fer proves

1. Instal·la CUPS

1.1. Actualitza el sistema

Actualitza la llista de paquets:

sudo apt update

Actualitza els paquets:

sudo apt upgrade

1.2. Instal·la CUPS i utilitats addicionals

sudo apt install cups cups-client cups-bsd printer-driver-all

Els paquets principals instal·lats són:

Paquet	Descripció
`cups`	Servidor d’impressió CUPS
`cups-client`	Eines de línia d’ordres per gestionar impressió
`cups-bsd`	Compatibilitat amb ordres BSD (`lpr`, `lpq`, `lprm`)
`printer-driver-all`	Col·lecció de controladors d’impressores

1.3. Verifica la instal·lació

cups --version

Sortida esperada:

CUPS v2.4.x

2. Gestiona el servei CUPS

2.1. Habilita i arrenca el servei

sudo systemctl enable cups
sudo systemctl start cups

2.2. Verifica l’estat del servei

sudo systemctl status cups

Sortida esperada (fragment):

● cups.service - CUPS Scheduler
     Loaded: loaded (/usr/lib/systemd/system/cups.service; enabled)
     Active: active (running) since ...

2.3. Ordres de gestió del servei

sudo systemctl start cups      # Engegar
sudo systemctl stop cups       # Aturar
sudo systemctl restart cups    # Reiniciar
sudo systemctl reload cups     # Recarregar configuració sense aturar

3. Configura l’accés a la interfície web

3.1. Fitxer de configuració principal

El fitxer de configuració de CUPS és /etc/cups/cupsd.conf. Edita’l per permetre l’accés des de la xarxa local:

sudo nano /etc/cups/cupsd.conf

3.2. Canvis necessaris a `cupsd.conf`

Localitza i modifica les seccions següents:

a) Escolta a totes les interfícies (no només localhost):

# Línia original:
Listen localhost:631

# Substitueix per:
Port 631

b) Permet l’accés a la interfície web des de la xarxa:

<Location />
  Order allow,deny
  Allow @LOCAL
</Location>

<Location /admin>
  Order allow,deny
  Allow @LOCAL
</Location>

<Location /admin/conf>
  AuthType Default
  Require user @SYSTEM
  Order allow,deny
  Allow @LOCAL
</Location>

💡

Nota

@LOCAL permet l’accés des de qualsevol equip de la xarxa local. Per restringir a una subxarxa específica, substituir per Allow 192.168.1.0/24 (adaptant al rang de la xarxa).

c) Habilita la interfície web (si cal):

WebInterface Yes

3.3. Reinicia CUPS per aplicar els canvis

sudo systemctl restart cups

3.4. Obre el port al tallafoc (UFW)

sudo ufw allow 631/tcp
sudo ufw allow 631/udp
sudo ufw reload

Verifica:

sudo ufw status

3.5. Accedeix a la interfície web

Des d’un navegador de la xarxa local, accedeix a:

http://IP_DEL_SERVIDOR:631

Per exemple: http://192.168.1.10:631

4. Configura l’usuari administrador

Per poder administrar CUPS des de la interfície web, l’usuari ha de pertànyer al grup lpadmin.

sudo usermod -aG lpadmin NOM_USUARI

Verifica que l’usuari pertany al grup:

groups NOM_USUARI

⚠️

Avís

Cal tancar la sessió i tornar a entrar perquè el canvi de grup tingui efecte.

5. Afegeix una impressora

5.1. Des de la interfície web

Obre http://IP_DEL_SERVIDOR:631
Ves a Administration → Add Printer
Introdueix credencials d’administrador quan es demani

Selecciona el tipus de connexió:

Local Printers: impressores connectades físicament
Network Printers: impressores en xarxa (LPD, IPP, SMB, etc.)

Configura el nom, descripció i ubicació
Selecciona el controlador (driver) adequat
Fes clic a Add Printer

5.2. Des de la línia d’ordres

Llista impressores disponibles al sistema:

lpstat -p -d

Afegeix una impressora en xarxa (protocol IPP):

sudo lpadmin -p nom_impressora \
  -v ipp://192.168.1.50/ipp/print \
  -m everywhere \
  -E

Paràmetre	Significat
`-p`	Nom de la impressora a CUPS
`-v`	URI de connexió (protocol + adreça)
`-m everywhere`	Usar el controlador universal IPP Everywhere
`-E`	Habilitar la impressora immediatament

Estableix la impressora per defecte:

sudo lpadmin -d nom_impressora

Afegeix una impressora USB local:

# Detecta el dispositiu
lpinfo -v | grep usb

# Afegeix la impressora
sudo lpadmin -p ImpresoraUSB \
  -v usb://fabricant/model \
  -m drv:///sample.drv/generic.ppd \
  -E

6. Comparteix impressores a la xarxa

6.1. Habilita la compartició global

Edita /etc/cups/cupsd.conf i afegeix o modifica:

sudo nano /etc/cups/cupsd.conf

# Habilita la compartició de impressores
ServerName IP_DEL_SERVIDOR
Browsing On
BrowseLocalProtocols dnssd
DefaultAuthType Basic

I afegeix al final:

<Policy default>
  <Limit Send-Document Send-URI Hold-Job Release-Job Restart-Job Purge-Jobs ...>
    Order deny,allow
  </Limit>
</Policy>

6.2. Marca una impressora com a compartida

Via interfície web:

Ves a Printers → nom de la impressora
Clica Modify Printer
Activa l’opció Share This Printer

Via línia d’ordres:

sudo lpadmin -p nom_impressora -o printer-is-shared=true

6.3. Habilita la compartició global via ordre

sudo cupsctl --share-printers

7. Gestiona treballs d’impressió

7.1. Envia un fitxer a imprimir

lpr -P nom_impressora fitxer.pdf

Opcions útils:

lpr -P nom_impressora -# 3 fitxer.pdf    # 3 còpies
lpr -P nom_impressora -o landscape fitxer.pdf  # Orientació horitzontal

7.2. Consulta la cua d’impressió

lpq                          # Cua de la impressora per defecte
lpq -P nom_impressora        # Cua d'una impressora específica
lpstat -p                    # Estat de totes les impressores
lpstat -o                    # Treballs actius de totes les cues

7.3. Cancel·la treballs

lprm ID_TREBALL              # Cancel·lar un treball concret
lprm -P nom_impressora -     # Cancel·lar tots els treballs d'una impressora
cancel -a nom_impressora     # Alternativa amb l'ordre cancel

7.4. Habilita/deshabilita una impressora

sudo cupsenable nom_impressora    # Habilitar
sudo cupsdisable nom_impressora   # Deshabilitar

sudo cupsaccept nom_impressora    # Acceptar treballs a la cua
sudo cupsreject nom_impressora    # Rebutjar nous treballs

8. Impressora virtual PDF

CUPS permet crear una impressora virtual que genera fitxers PDF. Resulta molt útil per a proves i entorns de desenvolupament.

8.1. Instal·la el paquet necessari

sudo apt install cups-pdf

Això crea automàticament una impressora anomenada PDF a CUPS. Els documents impresos es desen a /var/spool/cups-pdf/USUARI/.

8.2. Verifica la impressora PDF

lpstat -p PDF

8.3. Prova d’impressió a PDF

echo "Prova d'impressió CUPS" | lpr -P PDF
ls ~/PDF/    # El fitxer generat es desa aquí per defecte

💡

Nota

La carpeta de destinació per a l’usuari root és /var/spool/cups-pdf/root/ i per a altres usuaris és ~/PDF/ (es crea automàticament).

9. Registres i resolució de problemes

9.1. Fitxers de registre

Fitxer	Contingut
`/var/log/cups/access_log`	Accessos HTTP a la interfície web
`/var/log/cups/error_log`	Errors i avisos del servidor
`/var/log/cups/page_log`	Registre de pàgines impreses

9.2. Consulta els registres en temps real

sudo tail -f /var/log/cups/error_log

9.3. Augmenta el nivell de detall dels registres

Edita /etc/cups/cupsd.conf:

sudo nano /etc/cups/cupsd.conf

LogLevel debug2

Reinicia el servei i consulta el registre per obtenir informació detallada.

9.4. Problemes habituals i solucions

La interfície web no és accessible des de la xarxa:

Verificar que Port 631 substitueix Listen localhost:631

Comprovar que el tallafoc permet el port 631

Revisar les directives <Location> al fitxer de configuració

L’usuari no pot administrar CUPS:

Verificar que l’usuari pertany al grup lpadmin

Tancar sessió i tornar a entrar

La impressora no apareix a la xarxa:

Verificar que Browsing On està activat a cupsd.conf

Comprovar que la impressora té activada l’opció de compartir

Treballs a la cua que no s’imprimeixen:

lpstat -p nom_impressora    # Verifica estat
sudo cupsenable nom_impressora
sudo cupsaccept nom_impressora

10. Resum d’ordres essencials

Acció	Ordre
Instal·lar CUPS	`sudo apt install cups`
Estat del servei	`sudo systemctl status cups`
Llistar impressores	`lpstat -p`
Afegir impressora	`sudo lpadmin -p nom -v uri -m model -E`
Imprimir fitxer	`lpr -P nom_impressora fitxer`
Veure cua	`lpq -P nom_impressora`
Cancel·lar treball	`lprm ID`
Habilitar impressora	`sudo cupsenable nom_impressora`
Compartir impressora	`sudo lpadmin -p nom -o printer-is-shared=true`
Veure errors	`sudo tail -f /var/log/cups/error_log`

Recursos addicionals

Documentació oficial CUPS: https://www.cups.org/documentation.html

Manual de cupsd.conf: man cupsd.conf

Manual de lpadmin: man lpadmin

Interfície web d’administració: http://localhost:631

Versions d’aquest document

HTML

PDF

ODT

MD

Domini Públic (CC0)