Etiket yanlış yazıcıdan çıkıyor: Labelixa bunu nasıl önler

Yayın tarihi: 2026-11-02

Eş yazılar neden olduğunu anlatıyor: etiketin yanlış yazıcıdan çıkması bir kimlik sorunudur ve yığının her katmanı değişmesine izin verilen bir ada ya da adrese güvenir. Bu yazı Labelixa DirectPrint ajanının buna karşı ne yaptığını, gerçek bir yazıcıda neyi ölçtüğümüzü ve korumanın tam olarak nerede bittiğini anlatır.

İş bir adrese değil, bir cihaza gider

Baskı işi bir cihaz kaydına gönderilir: yazıcıyı kaydederken aldığınız device_id (POST /v1/devices; GET /v1/devices listeler). Ağ adresi entegrasyonunuzda değil, yazıcının yanındaki bilgisayarda ajanın eşlemesinde durur; yazıcıyı taşımak ERP kodunuzu değil tek bir eşlemeyi değiştirmektir.

Yazıcının kimliğini sabitleyin

Bir ağ ZPL yazıcısını eşlerken kimliğini aynı adımda sabitleyin:

labelixa-agent map-printer -device DEVICE_ID -address 192.168.1.50:9100 -pin-identity zpl

Ajan yazıcıya kim olduğunu sorar (ZPL ~HI), cevabın özetini saklar ve Identity pinned der. Bundan sonra aynı soruyu her işten önce sorar — kurulumda bir kez değil, çünkü DHCP kirası kurulum anında kaymaz.

Uyuşmazlıkta hiçbir şey basılmaz

Eşlenen adreste cevap veren cihaz farklı bir cevap verirse ajan etiketi göndermez. Günlüğü bunu tek satırda söyler:

identity mismatch: the device at 192.168.1.50:9100 is NOT the device pinned for "DEVICE_ID". Nothing was printed.

ardından, yazıcı gerçekten değiştiyse yeniden sabitleme komutunu verir. İş KimlikUyusmazligi hata tipiyle başarısız sayılır ve otomatik olarak yeniden denenmez. Bunun önemi şu: iş kuyrukta bekleseydi, sabitlemeyi düzeltmek eski etiketi o adresi o an tutan cihazda bastırırdı — yeniden göndermek sizin kararınızdır.

Ne ölçtük

2 Kasım 2026'da bunu ağdaki bir Zebra GK420d üzerinde, ajan 0.6.1 ve canlı servisle çalıştırdık:

• sabitleme Identity pinned cevabını verdi ve test etiketi basıldı;
• ardından saklanan özeti, yazıcının cevabı artık tutmayacak şekilde değiştirdik — başka bir cihazın cevap vermesiyle aynı durum — ve iki iş gönderdik: kâğıt çıkmadı, günlükte yukarıdaki satır göründü ve iki iş de KimlikUyusmazligi ile başarısız sayıldı;
• özgün özeti geri yükleyip 60 saniye izledik: başarısız işler kendiliğinden basılmadı; yeni bir test etiketi normal basıldı.

Uyuşmazlığı tek yazıcıda, sabitlemeyi değiştirerek ürettik; aynı adreste iki fiziksel yazıcıyı yer değiştirmedik.

Korumanın bittiği yer

• Yalnız ağdaki ZPL yazıcıları. Soru, doğruladığımız tek kimlik sorgusu olan ~HI'dır. EPL, TSPL ve CPCL için doğrulanmış bir sorgu yoktur; sabitleme yapılamaz ve ajan bunu söyler. USB yazıcıya işletim sisteminin yazdırma kuyruğu üzerinden ulaşılır; kuyruk veriyi tek yönde taşır, ajan yazıcıya bir şey soramaz.
• İsteğe bağlıdır. Sabitlenmemiş cihaz denetlenmez.
• Birebir ikizler aynı görünür. Sabitlenen şey yazıcının ~HI'ya kendi cevabıdır: model, firmware sürümü, çözünürlük ve bellek. Bizim GK420d'miz GK420d-200dpi,V61.17.17Z,8,2104KB cevabını veriyor — içinde seri numarası yok. Aynı model, aynı firmware ve aynı bellekteki iki yazıcı aynı cevabı verir; denetim onları ayırt edemez. Adreste farklı bir model ya da yapılandırmanın cevap vermesini durdurur; birebir aynı yazıcılarda korumanız ayrılmış adresler olmaya devam eder.
• Firmware güncellemesi cevabı değiştirebilir. O zaman iş durur ve mesaj yeniden sabitlemenizi ister. Duran hat, yanlış kutudaki etiketten iyidir.
• Doğrulandı, basıldı demek değildir. Geçen denetim, baytları doğru cihazın aldığını söyler. Kâğıt bitmesi, açık kafa ya da sıkışma bundan sonra olur ve ham baskı bunları bildirmez.

Uyuşmazlık gördüğünüzde

1. Adresi şu an hangi cihazın tuttuğunu bulun: yapılandırma etiketini bastırın ya da DHCP kira tablosuna bakın — teşhis yazısındaki gibi.
2. Eşlemeyi doğru yazıcıya, mümkünse ayrılmış bir adrese geri çevirin.
3. Yalnız yazıcının kendisi değiştiyse ya da firmware'i güncellendiyse yeniden sabitleyin.
4. Sonra başarısız etiketi yeniden gönderin — bilerek.

Ajan indirme sayfasında; baskı ve cihaz uçları API belgesinde.

Sık sorulan sorular

Adreste başka bir yazıcı cevap verirse ne olur?

Yazıcı sabitlenmişse ve kimlik sorgusunun cevabı sabitlenen cevaptan farklıysa ajan hiçbir şey göndermez. Günlüğü cihazın sabitlenen cihaz olmadığını ve hiçbir şey basılmadığını söyler; iş KimlikUyusmazligi ile başarısız sayılır ve otomatik olarak yeniden denenmez.

Denetim her yazıcıda çalışır mı?

Hayır. Ajanın ~HI sorabildiği, ağ üzerinden ulaşılan ZPL yazıcılarında çalışır. EPL, TSPL ve CPCL için doğrulanmış bir kimlik sorgusu yoktur, USB yazdırma kuyruğu veriyi tek yönde taşır ve sabitlenmemiş cihaz denetlenmez.

Birebir aynı iki yazıcıyı ayırt edebilir mi?

Hayır. Sabitlenen şey yazıcının ~HI cevabıdır — model, firmware, çözünürlük ve bellek; seri numarası yok. Aynı model, aynı firmware ve bellekteki iki yazıcı aynı cevabı verir; aralarındaki koruma ayrılmış adreslerdir.

İlgili yazılar

Kendi ZPL kodunuzu deneyin →