ZoneMinder

Toda la documentación de ZoneMinder está ahora disponible en línea en https://zoneminder.readthedocs.org

Resumen

ZoneMinder es un conjunto integrado de aplicaciones que proporcionan una solución de vigilancia completa, permitiendo la captura, análisis, grabación y monitoreo de cualquier cámara CCTV o de seguridad conectada a una máquina basada en Linux. Está diseñado para ejecutarse en distribuciones que soporten la interfaz Video For Linux (V4L) y ha sido probado con cámaras de video conectadas a tarjetas BTTV, varias cámaras USB y también soporta la mayoría de las cámaras IP de red.

Contacto con el Equipo de Desarrollo

Antes de crear un issue en nuestro foro de github, por favor lea nuestras reglas de publicación: https://github.com/ZoneMinder/ZoneMinder/wiki/Github-Posting-Rules

Nuestro Dockerfile se ha movido

Por favor, reporte los issues relacionados con el Dockerfile de ZoneMinder aquí: https://github.com/ZoneMinder/zmdockerfiles

Métodos de Instalación

Instalar desde un Repositorio de Paquetes

Este es el método recomendado para instalar ZoneMinder en su sistema. Los paquetes de ZoneMinder se mantienen para las siguientes distribuciones:

• Ubuntu mediante el PPA de Isaac Connor
• Debian desde su repositorio predeterminado
• RHEL/CentOS y clones mediante RPM Fusion
• Fedora mediante RPM Fusion
• OpenSuse mediante repositorio de terceros
• Mageia desde su repositorio predeterminado
• Arch mediante el AUR
• Gentoo mediante Portage Overlays

Si no hay un repositorio que aloje paquetes de ZoneMinder disponible para su distribución, se le anima a crear su propio paquete, en lugar de compilar desde el código fuente. Aunque cada distribución es diferente en aspectos que la distinguen de las demás, a menudo son lo suficientemente similares como para permitirle adaptar las instrucciones de compilación de paquetes de otra distribución a la suya.

Compilar desde el Código Fuente está Desaconsejado

Históricamente, instalar ZoneMinder en su sistema requería compilar desde el código fuente ejecutando los comandos tradicionales configure, make, make install. Para lograr que ZoneMinder se compilara, todas sus dependencias tenían que ser determinadas e instaladas de antemano. Los scripts de init y logrotate tenían que copiarse manualmente a su lugar después de la compilación. Paquetes opcionales como jscalendar y Cambozola tenían que instalarse manualmente. Las desinstalaciones podían dejar archivos obsoletos, lo que podría causar problemas durante una actualización. Hablando de actualizaciones, cuando llegaba el momento de actualizar, todos estos pasos manuales debían repetirse nuevamente.

Hoy en día existen mejores métodos que hacen gran parte de esto por usted. El equipo de desarrollo actual, junto con otros voluntarios, ha dado grandes pasos para proporcionar los recursos necesarios para evitar compilar desde el código fuente.

Compilar un Paquete de ZoneMinder

Compilar ZoneMinder en un paquete no es más difícil que compilar desde el código fuente. De hecho, si ha compilado ZoneMinder desde el código fuente en el pasado, puede que estos pasos le resulten más fáciles.

Al compilar un paquete, es mejor hacer este trabajo en un entorno separado, dedicado a fines de desarrollo. Esto puede ser tan simple como crear una máquina virtual, usar Docker o usar mock. Basta con un solo "Oops" para arrepentirse de hacer este trabajo en su servidor de producción.

Por último, si desea compilar una instantánea de desarrollo desde la rama master, se recomienda que primero compile su paquete usando una versión oficial de ZoneMinder. Esto ayudará a identificar si los problemas que pueda encontrar son causados por el proceso de compilación o si se trata de un problema nuevo en la rama master.

Por favor, visite nuestro sitio ReadtheDocs para obtener instrucciones específicas por distribución.

Mantenedores de Paquetes

Muchos de los valores predeterminados de las variables de configuración de ZoneMinder no son configurables en tiempo de compilación mediante autotools o cmake. Se ha añadido una nueva herramienta llamada zmeditconfigdata.sh para permitir a los mantenedores de paquetes manipular cualquier variable almacenada en ConfigData.pm sin parchear el código fuente.

Por ejemplo, digamos que he creado un nuevo paquete de ZoneMinder que contiene el archivo javascript de cambozola. Sin embargo, por defecto, el soporte de cambozola está desactivado. Para solucionarlo, añada esto al script de empaquetado:

./utils/zmeditconfigdata.sh ZM_OPT_CAMBOZOLA yes

Tenga en cuenta que se pretende que zmeditconfigdata.sh se llame desde la carpeta raíz de compilación, antes de ejecutar cmake o configure.

Docker

Docker es un sistema para ejecutar aplicaciones dentro de contenedores aislados. ZoneMinder, y el servidor web de ZM, se ejecutarán usando el Dockerfile contenido en este repositorio. Sin embargo, aún queda trabajo por hacer para garantizar que las principales funciones de ZM funcionen correctamente y estén documentadas.

Modelo de Contribución y Desarrollo

• Código fuente alojado en GitHub
• Reporte de issues en GitHub Issues
• Preguntas/solicitudes de funciones en Slack o foros

¡Las pull requests son muy bienvenidas! Si desea contribuir, por favor siga los siguientes pasos. Aunque el paso 3 es opcional, es preferible.

1. Haga un fork del repositorio
2. Abra un issue en nuestro GitHub Issues Tracker. Siga la plantilla del issue para describir el error o problema de seguridad que encontró. Tenga en cuenta que las solicitudes de funciones o preguntas deben publicarse en nuestro foro de usuarios o canal de Slack.
3. Cree su rama de características (git checkout -b 456-my-new-feature)
4. Confirme sus cambios (git commit -am 'Added some feature') Se prefiere que 'confirme temprano y con frecuencia' en lugar de agrupar todos los cambios en una sola confirmación.
5. Envíe su rama a su fork en github (git push origin 456-my-new-feature)
6. Cree una nueva Pull Request
7. El equipo revisará, discutirá y, con suerte, fusionará sus cambios.