{"canonical_url":"https://engineer.company/es/glossary/package/","content_markdown":"# Paquete de software\n\n## Qué es\n\nUn paquete es la forma en que el software pasa de quienes lo escriben a las\nmáquinas que lo ejecutan: el código, en un archivo o un directorio, acompañado\nde un manifiesto que indica su nombre, su versión y qué más necesita para\nfuncionar. El plural es paquetes, y la documentación de sistemas suele hablar de\npaquetes de software. Cada ecosistema fija sus propios límites. Para npm, un\npaquete es un archivo o directorio descrito por un archivo package.json, y su\ndocumentación lo distingue de un módulo: cualquier cosa que Node.js pueda cargar\ncon require() o import; solo los módulos que incluyen un package.json son\npaquetes. Python usa la palabra para dos cosas, y la [Guía del usuario de Python Packaging](https://packaging.python.org/) las distingue: un\npaquete de importación es un directorio de módulos que el código importa,\nmientras que un paquete de distribución es el archivo con versión que una\npersona descarga e instala. En Rust, un paquete reúne uno o más crates con un\nCargo.toml que indica cómo compilarlos. En Debian, la unidad es el paquete\nbinario, el archivo .deb que el sistema instala y registra.\n\nUn paquete es una unidad de distribución, y se entiende mejor al compararlo con\nlos conceptos cercanos. Una biblioteca es código; un paquete es la forma de\ndistribuirlo, y una misma biblioteca puede llegar a sus usuarios como paquete\nnpm, wheel de Python y paquete Debian a la vez. Un gestor de paquetes es el\nprograma que lee los manifiestos, descarga lo que enumeran y lo instala todo en\nun orden en el que todo pueda funcionar: npm, pip, Cargo y apt. Un registro o repositorio de\npaquetes es donde estos esperan a ser descargados, como el registro de npm,\nPyPI, crates.io o una réplica de Debian. Los gestores de paquetes de lenguajes\ninstalan código para un proyecto, normalmente en un directorio junto a él. Los\ngestores de paquetes del sistema instalan software para toda la máquina y\nregistran qué paquete colocó cada archivo en cada sitio.\n\n## Por qué importa\n\nEl código de terceros llega a un proyecto de una de estas tres maneras: mediante\nun gestor de paquetes, copiado al repositorio con su licencia y una suma de\ncomprobación, lo que se llama vendoring, o compilado desde el código fuente. Un\ngestor de paquetes suele ser la opción elegida por buenas razones. Resuelve todo\nel árbol de dependencias, las actualiza con un solo comando y registra lo que\ninstala. El coste es la confianza: el proyecto pasa a depender de cada\nmanifiesto de ese árbol y de cada registro del que procede. El vendoring cambia\nesa confianza por trabajo, porque el código copiado solo cambia cuando alguien\ncopia una versión nueva de forma deliberada. Compilar desde el código fuente\nofrece el máximo control y exige el máximo mantenimiento.\n\nEn el manifiesto se aprecian la mayoría de las ventajas y las contrapartidas. Suele\nindicar un intervalo de versiones, no una sola; en npm, un intervalo con\ncircunflejo como ^10.0.1 admite cualquier versión posterior con la misma versión\nprincipal. Los intervalos permiten recibir correcciones sin editar el archivo, y\ntambién hacen que dos instalaciones separadas por una semana puedan producir\nárboles distintos. Un archivo de bloqueo cierra esa brecha. npm escribe\npackage-lock.json para describir el árbol exacto que construyó, de modo que las\ninstalaciones posteriores lo reproduzcan; Cargo escribe Cargo.lock con la\nversión exacta de cada dependencia, y ambos esperan que el archivo se incluya en\nel control de versiones. El manifiesto registra lo que un proyecto está\ndispuesto a aceptar; el archivo de bloqueo registra lo que recibió.\n\nLos manifiestos también indican hasta qué punto un paquete necesita a otro. El\nManual de políticas de Debian define una escala. Depends es absoluto: el paquete\nno se configura hasta que se hayan configurado todas sus dependencias.\nRecommends es una relación fuerte, aunque no absoluta, para paquetes que\nacompañan a este en todas las instalaciones salvo las poco habituales. Suggests\nenumera paquetes que lo hacen más útil, aunque instalarlo sin ellos es\nperfectamente razonable. Una instalación que omite un paquete recomendado es\nválida, y el software que contiene puede seguir necesitando ese paquete para\nalguna de sus tareas.\n\nToda herramienta que analiza paquetes confía en sus metadatos. Un comprobador de\nlicencias lee la licencia declarada, a menudo una expresión SPDX como MIT OR\nApache-2.0, donde OR ofrece una elección y AND exige todas las licencias a la\nvez. Un analizador de vulnerabilidades coteja los nombres y las versiones\ndeclarados con los avisos publicados. Si una declaración es incorrecta, todas\nlas herramientas que la leen se equivocan del mismo modo; por eso los archivos\nde licencia incluidos en un paquete distribuido merecen una lectura por\nseparado.\n\n## Cómo se aplica en la práctica\n\nUna revisión de endurecimiento de un servidor de producción descubrió que su\njail de bloqueo de intrusiones nunca había bloqueado a nadie, y una de las tres\ncausas independientes era una relación entre paquetes. La acción de bloqueo\nllamaba a un programa de filtrado de paquetes que el empaquetado clasifica como\nrecomendado, no obligatorio, y el servidor se había construido sin él. El jail\narrancaba, contaba los inicios de sesión fallidos y tomaba su decisión cada vez,\npero fallaba en el último paso: aplicar el bloqueo. La [revisión de tres protecciones de SSH](/es/portfolio/three-locks-on-the-door-none-of-them-locked/) lo descubrió\ninspeccionando el sistema en ejecución, en vez de los archivos de configuración,\ny dejó una regla: cada control de seguridad debe estar respaldado por una\naserción automatizada, no por un comentario.\n\nUn núcleo de Rust enlazado con una aplicación distribuida incorpora al producto\ntodo su grafo de dependencias: aquí, 644 crates, cada uno con su propia\ndeclaración de licencia. Una dependencia situada varios niveles por debajo puede\npasar a una licencia copyleft de una versión a otra, y la única huella sería una\nlínea modificada en un archivo de bloqueo que poca gente lee. La [auditoría de licencias de 644 crates](/es/portfolio/know-the-licence-of-everything-you-ship/) se ejecuta\nen cada compilación: evalúa la expresión de licencia de cada crate frente a una\nlista de licencias permitidas, admite una elección si al menos una licencia está\npermitida y una combinación solo si lo están todas, y detiene la compilación\nante cualquier caso que no encaje. Para demostrar que el control podía\nactivarse, se hizo fallar deliberadamente dos veces: una al reescribir la\nexpresión de licencia de un crate y otra al cambiar la revisión fijada del\nnúcleo sin regenerar la auditoría. La página expone el límite con claridad: la\nauditoría lee metadatos declarados, que pueden ser incorrectos, y no constituye\nasesoramiento jurídico.\n\nLa forja Git de la empresa se [instaló desde la fuente de paquetes del propio proveedor](/es/portfolio/your-code-on-your-own-hardware/) como un único programa que el sistema\noperativo mantiene en ejecución. Añadir el repositorio de un proveedor a un\nservidor es una decisión por sí misma, porque, desde ese momento, las\nactualizaciones habituales instalan lo que ese proveedor publique y firme.\n\nEste sitio no necesita Node para funcionar. Su package.json está marcado como\nprivate, lo que indica a npm que rechace su publicación, enumera únicamente\nherramientas de desarrollo con intervalos de versión con circunflejo y está\njunto a un package-lock.json incluido en el control de versiones. Su\npyproject.toml configura un linter, un corrector ortográfico y un comprobador de\ntipos, y no contiene tablas [project] ni [build-system], porque no describe\nningún paquete que generar. Los iconos se incorporan mediante vendoring: se\ncopian con la licencia del proyecto de origen y una suma SHA-256 para cada\narchivo.\n\n## Dónde surgen los problemas\n\n### Una función aparece como operativa, pero no hace nada\n\nUn servicio arranca, registra que está funcionando y omite silenciosamente una\nde sus tareas cada vez. Un programa al que llama pertenece a un paquete\nrecomendado o sugerido, que la instalación podía omitir legítimamente. Si una\nfunción depende de un programa externo, compruebe su presencia al arrancar y\ndeténgase con un error claro si falta, declárelo como requisito obligatorio de\nsu propio despliegue y pruebe la función de extremo a extremo en un servidor\nconstruido como el de producción.\n\n### Dos máquinas instalan código distinto desde el mismo manifiesto\n\nLa compilación funciona en un portátil y falla en integración continua, o al\nrevés, sin cambios en el código del proyecto. El manifiesto indica intervalos de\nversión, nunca se incluyó el archivo de bloqueo en el control de versiones y una\ndependencia publicó una versión entre ambas instalaciones. Incluya el archivo de\nbloqueo en el control de versiones, instale a partir de él en la automatización\ncon comandos que se nieguen a modificarlo, como npm ci o cargo build --locked, y\nactualícelo mediante un cambio separado y revisado.\n\n### Una dependencia conocida cambia de licencia\n\nUn producto que superó una revisión de licencias el año pasado distribuye ahora\ncódigo con condiciones que nadie aceptó, aunque su lista de dependencias parezca\nla misma. Una dependencia existente cambió de licencia entre versiones, y una\nactualización habitual incorporó la nueva versión mediante el archivo de\nbloqueo. Compruebe las licencias declaradas frente a una lista explícita de\nlicencias permitidas en cada compilación, para que el cambio la detenga el mismo\ndía en que llegue.\n\n## Lecturas adicionales\n\n- [Documentación de npm: paquetes y módulos](https://docs.npmjs.com/about-packages-and-modules) — la definición de paquete de npm y por qué un módulo no siempre lo es.\n- [Manual de políticas de Debian: declaración de relaciones entre paquetes](https://www.debian.org/doc/debian-policy/ch-relationships.html) — Depends, Recommends, Suggests y los demás campos, y qué hace un gestor\n  de paquetes con cada uno.\n- [Guía del usuario de Python Packaging: escribir pyproject.toml](https://packaging.python.org/en/latest/guides/writing-pyproject-toml/) — las tres tablas de pyproject.toml y los metadatos que declara un paquete\n  de distribución de Python.\n- [El libro de Cargo: Cargo.toml frente a Cargo.lock](https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html) — por qué el manifiesto describe lo que acepta un proyecto, el archivo de\n  bloqueo registra versiones exactas y cuándo incluirlo en el control de\n  versiones.\n- [Especificación SPDX 2.3.1: expresiones de licencia](https://spdx.github.io/spdx-spec/v2.3.1/SPDX-license-expressions/) — la sintaxis con la que los paquetes declaran una licencia, una elección\n  entre varias o un conjunto que se aplica a la vez.\n\n\u003chttps://engineer.company/es/glossary/package/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Paquetes: contenido, manifiestos, archivos de bloqueo y dependencias que deciden qué se instala, y fallos pese a una instalación sin errores.","formats":{"gemtext":"https://engineer.company/es/glossary/package/index.gmi","gopher":"https://engineer.company/es/glossary/package/gophermap","html":"https://engineer.company/es/glossary/package/","json":"https://engineer.company/es/glossary/package/index.json","markdown":"https://engineer.company/es/glossary/package/index.md","pdf":"https://engineer.company/es/glossary/package/index.pdf"},"kind":"page","language":"es","title":"¿Qué es un paquete de software?","url":"https://engineer.company/es/glossary/package/","version":1}